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'une ressource de Amazon GameLift Servers compilation pour l'hébergement géré
Lorsque vous créez une build et téléchargez vos fichiers, vous disposez de quelques options :
+ [Création d'un build à partir d'un répertoire de fichiers](gamelift-build-cli-uploading-upload-build.md). Il s'agit de l'option la plus simple et la plus couramment utilisée.
+ [Créez un build avec des fichiers dans Amazon Simple Storage Service (Amazon S3)](gamelift-build-cli-uploading-create-build.md). Avec cette option, vous pouvez gérer vos versions de build dans Amazon S3.
Avec les deux méthodes, Amazon GameLift Servers crée une nouvelle ressource de build avec un ID de build unique et d'autres métadonnées. La construction démarre avec le statut **Initialisé**. Après avoir Amazon GameLift Servers acquis les fichiers du serveur de jeu, le build passe à l'état **Prêt**.
Lorsque le build est prêt, vous pouvez le déployer sur une nouvelle Amazon GameLift Servers flotte. Pour plus d'informations, voir [Création d'une EC2 flotte Amazon GameLift Servers gérée](fleets-creating.md) .Lorsque Amazon GameLift Servers le nouveau parc est configuré, il télécharge les fichiers de construction sur chaque instance du parc et installe les fichiers de génération.
# Création d'un build à partir d'un répertoire de fichiers
Pour créer une version de jeu stockée dans n'importe quel emplacement, y compris dans un répertoire local, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html) AWS CLI commande. Cette commande crée un enregistrement de build dans Amazon GameLift Servers et charge les fichiers depuis un emplacement que vous spécifiez.
**Envoyez une demande de chargement.** Dans une fenêtre de ligne de commande, entrez la **upload-build** commande et les paramètres suivants.
```
aws gamelift upload-build \
--name user-defined name of build \
--operating-system supported OS \
--server-sdk-version server SDK for Amazon GameLift Servers version \
--build-root build path \
--build-version user-defined build number \
--region region name
```
+ **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.
+ **server-sdk-version**— La version du SDK du Amazon GameLift Servers serveur à laquelle votre serveur de jeu est intégré. Si vous ne fournissez aucune valeur, Amazon GameLift Servers utilise la valeur par défaut`4.0.2`. Si vous spécifiez une version du SDK de serveur incorrecte, la compilation du serveur de jeu risque d'échouer lors de `InitSdk` l'appel pour établir une connexion au Amazon GameLift Servers service.
+ **build-root**— Le chemin du répertoire de vos fichiers de compilation.
+ **name**— Nom descriptif de la nouvelle version.
+ **build-version**— Les détails de version des fichiers de compilation.
+ **region**— La AWS région dans laquelle vous souhaitez créer votre build. Créez le build dans la 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**
Consultez votre région par défaut actuelle à l'aide du [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Pour modifier votre région par défaut, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html)commande.
*Exemples*
```
aws gamelift upload-build \
--operating-system AMAZON_LINUX_2023 \
--server-sdk-version "5.0.0" \
--build-root "~/mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
```
aws gamelift upload-build \
--operating-system WINDOWS_2022 \
--server-sdk-version "5.0.0" \
--build-root "C:\mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
En réponse à votre demande de téléchargement, Amazon GameLift Servers indique la progression du téléchargement. En cas de téléchargement réussi, Amazon GameLift Servers renvoie le nouvel ID d'enregistrement de construction. Le temps de chargement dépend de la taille de vos fichiers de jeu et de la vitesse de connexion.
# 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.
1. **Accordez à Amazon GameLift Servers l'accès à vos fichiers de build.** Créez un rôle IAM en suivant les instructions de[Accédez à un fichier de compilation de jeu dans Amazon S3](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc). 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.
1. **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'`PassRole`autorisation, comme décrit dans[Exemples d'autorisations IAM pour Amazon GameLift Servers](gamelift-iam-policy-examples.md).
------
#### [ Console ]
1. Dans le volet de navigation de la [Amazon GameLift Serversconsole](https://console.aws.amazon.com/gamelift/), choisissez **Hosting**, **Builds**.
1. Sur la page **Builds**, choisissez **Create build**.
1. 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.
1. 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.
1. 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.
1. 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.
1. 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.
1. (Facultatif) Sous **Balises**, ajoutez des balises au build en saisissant des paires **clé** et **valeur**.
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html)commande.
1. Ouvrez une fenêtre de ligne de commande et passez à un répertoire dans lequel vous pouvez utiliser le AWS CLI.
1. 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éfaut`4.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\$1build\$1files ».
+ **Key**— Le nom du fichier .zip qui contient vos fichiers de compilation. Par exemple, « my\$1game\$1build\$17.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](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc).
+ **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 [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html)commande [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Pour modifier votre région par défaut, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html)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
```
1. Pour afficher la nouvelle version, utilisez la [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html)commande.
------