View a markdown version of this page

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

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 construction dans Amazon S3 et les charger Amazon GameLift Servers depuis cet espace. 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 compilation

  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 figurant dansAccédez à un fichier de création 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 disposer de l'PassRoleautorisation, comme décrit dansExemples d'autorisations IAM pour Amazon GameLift Servers.

Console

  1. Dans la Amazon GameLift Servers console, dans le volet de navigation, choisissez Hosting, Builds.

  2. Sur la page Builds, choisissez Create build.

  3. Sur la page Créer un build, sous Paramètres de build, procédez comme suit :

    1. Dans le champ Nom, entrez un nom de script.

    2. Dans 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. Pour Système d'exploitation (OS), choisissez le système d'exploitation de votre serveur de jeu. Vous ne pourrez pas mettre à jour cette valeur ultérieurement.

    4. Pour la génération du serveur de jeu, entrez l'URI S3 de l'objet de génération 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 Parcourir S3 et recherchez l'objet de génération.

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

  4. (Facultatif) Sous Balises, ajoutez des balises à la génération en saisissant des paires clé et valeur.

  5. Cliquez sur Créer.

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

AWS CLI

Pour définir la nouvelle version et télécharger les fichiers de génération de votre serveur, utilisez la create-build commande.

  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— Un nom descriptif pour la nouvelle construction.

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

    • operating-system— L'environnement d'exécution de la version 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 build.

    • 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 construction. 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 création de jeu dans Amazon S3.

    • region— Créez le bâtiment 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 get commande . Pour modifier votre région par défaut, utilisez la configure set commande.

    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-build commande.