Création d'un build avec des fichiers dans Amazon S3 - Amazon GameLift Servers

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un build avec des fichiers dans Amazon S3

Vous pouvez stocker vos fichiers de compilation dans Amazon S3 et les télécharger à Amazon GameLift Servers partir de là. Lorsque vous créez votre build, vous spécifiez l'emplacement du compartiment S3 et vous Amazon GameLift Servers récupérez les fichiers de build directement depuis Amazon S3.

Pour créer une ressource de construction

  1. Stockez vos fichiers de compilation dans Amazon S3. Créez un fichier .zip contenant les fichiers de construction empaquetés et téléchargez-le dans un compartiment S3 de votre Compte AWS. Prenez note de l'étiquette du bucket et du nom du fichier, vous en aurez besoin lors de la création d'un Amazon GameLift Servers build.

  2. Accordez à Amazon GameLift Servers l'accès à vos fichiers de build. Créez un rôle IAM en suivant les instructions deAccédez à un fichier de compilation de jeu dans Amazon S3. Après avoir créé le rôle, prenez note du nom de ressource Amazon (ARN) du nouveau rôle. Vous en aurez besoin lors de la création d'un build.

  3. Créez un build. Utilisez la Amazon GameLift Servers console ou le AWS CLI pour créer un nouvel enregistrement de build. Vous devez avoir l'PassRoleautorisation, comme décrit dansExemples d'autorisations IAM pour Amazon GameLift Servers.

Console

  1. Dans le volet de navigation de la Amazon GameLift Serversconsole, choisissez Hosting, Builds.

  2. Sur la page Builds, choisissez Create build.

  3. Sur la page Créer une version, sous Paramètres de génération, procédez comme suit :

    1. Dans Nom, entrez le nom du script.

    2. Pour Version, entrez une version. Comme vous pouvez mettre à jour le contenu d'une version, les données de version peuvent vous aider à suivre les mises à jour.

    3. Dans Système d'exploitation (OS), choisissez le système d'exploitation de la version de votre serveur de jeu. Vous ne pourrez pas mettre à jour cette valeur ultérieurement.

    4. Pour le build du serveur de jeu, entrez l'URI S3 de l'objet de build que vous avez chargé sur Amazon S3, puis choisissez la version de l'objet. Si vous ne vous souvenez pas de l'URI et de la version de l'objet Amazon S3, choisissez Browse S3 et recherchez l'objet de construction.

    5. Pour le rôle IAM, choisissez le rôle que vous avez créé qui donne Amazon GameLift Servers accès à votre compartiment S3 et à votre objet de construction.

  4. (Facultatif) Sous Balises, ajoutez des balises au build en saisissant des paires clé et valeur.

  5. Choisissez Créer.

Amazon GameLift Serversattribue un identifiant à la nouvelle version et télécharge le fichier .zip désigné. Vous pouvez consulter le nouveau build, y compris son statut, sur la page Builds.

AWS CLI

Pour définir le nouveau build et télécharger les fichiers de build de votre serveur, utilisez la create-buildcommande.

  1. Ouvrez une fenêtre de ligne de commande et passez à un répertoire dans lequel vous pouvez utiliser le AWS CLI.

  2. Entrez la create-build commande suivante :

    aws gamelift create-build \
    --name user-defined name of build \
    --server-sdk-version server SDK for Amazon GameLift Servers version \
    --operating-system supported OS \
    --build-version user-defined build number \
    --storage-location "Bucket"=S3 bucket label,"Key"=Build .zip file name,"RoleArn"=Access role ARN} \
    --region region name

    • name— Nom descriptif de la nouvelle version.

    • server-sdk-version— La version du SDK du serveur à laquelle Amazon GameLift Servers vous avez intégré votre serveur de jeu. Amazon GameLift Servers Si vous ne fournissez aucune valeur, Amazon GameLift Servers utilise la valeur par défaut4.0.2.

    • operating-system— L'environnement d'exécution du build du serveur de jeu. Vous devez spécifier une valeur de système d'exploitation. Vous ne pourrez pas le mettre à jour ultérieurement.

    • build-version— Les détails de version des fichiers de compilation. Ces informations peuvent être utiles car chaque nouvelle version de votre serveur de jeu nécessite une nouvelle ressource de compilation.

    • storage-location

      • Bucket— Le nom du compartiment S3 qui contient votre build. Par exemple, « my_build_files ».

      • Key— Le nom du fichier .zip qui contient vos fichiers de compilation. Par exemple, « my_game_build_7.0.1, 7.0.2 ».

      • RoleARN— L'ARN attribué au rôle IAM que vous avez créé. Par exemple, « arn:aws:iam : :111122223333:role/ ». GameLiftAccess Pour un exemple de politique, consultez Accédez à un fichier de compilation de jeu dans Amazon S3.

    • region— Créez le build dans la AWS région où vous prévoyez de déployer des flottes. Si vous déployez votre jeu dans plusieurs régions, créez un build dans chaque région.

      Note

      Nous vous recommandons de vérifier votre région par défaut actuelle à l'aide de la configure getcommande . Pour modifier votre région par défaut, utilisez la configure setcommande.

    Exemple

    aws gamelift create-build \
    --operating-system WINDOWS_2022 \
    --storage-location "Bucket"="my_game_build_files","Key"="mygame_build_101.zip","RoleArn"="arn:aws:iam::111122223333:role/gamelift" \
    --name "My Game Nightly Build" \
    --build-version "build 101" \
    --region us-west-2

  3. Pour afficher la nouvelle version, utilisez la describe-buildcommande.