View a markdown version of this page

Créez une définition de groupe de conteneurs pour GameLift Serveurs Amazon flotte de conteneurs - GameLift Serveurs Amazon
Avant de commencerCréation d'une définition de groupe de conteneurs pour serveurs de jeuxCréation d'un fichier JSON de définition de conteneur

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éez une définition de groupe de conteneurs pour GameLift Serveurs Amazon flotte de conteneurs

Une définition de groupe de conteneurs décrit comment déployer vos applications de serveur de jeu conteneurisé sur une flotte de conteneurs. Il s'agit d'un plan qui indique Amazon GameLift Servers quelles images de conteneurs déployer sur la flotte et comment les gérer. Lorsque vous créez une flotte de conteneurs, vous spécifiez les définitions de groupes de conteneurs à déployer dans la flotte. Pour plus d'informations sur les groupes de conteneurs, consultezComposants de la flotte de conteneurs.

Avant de commencer

Conseils sur la marche à suivre avant de commencer à créer une définition de groupe de conteneurs :

  • Finalisez vos images de conteneurs et transférez-les vers un référentiel Amazon Elastic Container Registry (Amazon ECR) situé au même Région AWS endroit où vous prévoyez de créer le groupe de conteneurs. Amazon GameLift Serverscapture un instantané de chaque image au moment où vous créez la définition d'un groupe de conteneurs et utilise cet instantané lors du déploiement sur une flotte de conteneurs. Consultez Créez une image de conteneur pour GameLift Serveurs Amazon.

  • Créez vos définitions de conteneurs sous forme de fichiers JSON. Une définition de groupe de conteneurs comprend une ou plusieurs définitions de conteneurs. Vous pouvez utiliser les fichiers JSON si vous créez une définition de groupe de conteneurs à l'aide de la AWS CLI pourAmazon GameLift Servers.

  • Vérifiez que votre AWS utilisateur dispose des autorisations IAM pour accéder au référentiel Amazon ECR. Consultez Exemples d'autorisations IAM pour Amazon GameLift Servers.

Création d'une définition de groupe de conteneurs pour serveurs de jeux

Un groupe de conteneurs de serveurs de jeu exécute le logiciel de votre serveur de jeu. Un groupe de conteneurs de serveurs de jeu possède un conteneur de serveur de jeu, qui exécute l'exécutable du serveur de jeu. Il peut également comporter un ou plusieurs conteneurs de support pour exécuter des logiciels supplémentaires destinés à prendre en charge votre serveur de jeu. (Ces conteneurs sont parfois appelés conteneurs « sidecar ».)

Cette rubrique explique comment créer une définition de groupe de conteneurs de serveur de jeu simple à l'aide de la Amazon GameLift Servers console ou des outils de la AWS CLI. Pour plus d'informations sur les fonctionnalités optionnelles, consultezPersonnalisez un GameLift Serveurs Amazon flotte de conteneurs.

Note

Vous pouvez modifier la plupart des définitions de groupes de conteneurs et des paramètres de définition de conteneurs après les avoir créés. Si vous apportez des modifications à la définition d'un conteneur, Amazon GameLift Servers capture un nouvel instantané des images de conteneur mises à jour.

Pour créer une définition simple de groupe de conteneurs de serveurs de jeu, procédez comme suit :

Les instructions suivantes décrivent comment créer une définition de groupe de conteneurs avec les paramètres requis minimaux et en utilisant les valeurs Amazon GameLift Servers par défaut.

Console

Dans la Amazon GameLift Servers console, sélectionnez l' Région AWS endroit où vous souhaitez créer le groupe de conteneurs.

Ouvrez la barre de navigation de gauche de la console et choisissez Conteneurs gérés : définitions de groupes. Sur la page de définition des groupes de conteneurs, choisissez Créer une définition de groupe.

Étape 1 : définir les détails de la définition du groupe de conteneurs

  1. Entrez un nom de définition de groupe de conteneurs. Le nom doit être propre à la région Compte AWS et.

  2. Sélectionnez le type de groupe de conteneurs du serveur de jeu.

  3. Dans Limite de mémoire totale, entrez les ressources mémoire maximales à mettre à disposition pour tous les conteneurs du groupe de conteneurs. Pour obtenir de l'aide sur le calcul de cette valeur, consultezDéfinissez des limites de ressources.

  4. Pour Limite totale de processeurs virtuels, entrez la puissance de calcul maximale à mettre à disposition pour tous les conteneurs du groupe de conteneurs. Pour obtenir de l'aide sur le calcul de cette valeur, consultezDéfinissez des limites de ressources.

Étape 2 : Ajouter des définitions de conteneurs

Au minimum, un groupe de conteneurs de serveurs de jeu possède un conteneur de serveurs de jeu. Dans la console, la première définition de conteneur que vous créez est le conteneur du serveur de jeu. Cette étape explique comment définir les paramètres minimaux requis pour la définition d'un conteneur de serveur de jeu.

  1. Entrez un nom de définition de conteneur. Chaque conteneur défini pour le groupe doit avoir une valeur de nom unique.

  2. Lien vers une image de conteneur contenant la version de votre serveur de jeu. Entrez l'URI de l'image Amazon ECR pour une image de conteneur dans un référentiel public ou privé. Vous pouvez utiliser l'un des formats suivants :

    • URI de l'image uniquement : [Compte AWS].dkr.ecr.[Région AWS].amazonaws.com/[repository ID]

    • URI de l'image + résumé : [Compte AWS].dkr.ecr.[Région AWS].amazonaws.com/[repository ID]@[digest]

    • URI de l'image + balise : [Compte AWS].dkr.ecr.[Région AWS].amazonaws.com/[repository ID]:[tag]

  3. Spécifiez la version Amazon GameLift Servers du SDK Server utilisée par la version du serveur de jeu. Pour une flotte de conteneurs, cette valeur doit être supérieure ou égale à 5,2.0.

  4. Dans Internal container port range, définissez le protocole et définissez une plage de ports. La taille de la plage doit être supérieure au nombre de processus de serveur de jeu simultanés qui seront exécutés dans ce conteneur. Si le conteneur du serveur de jeu exécute un seul processus serveur par conteneur, cette plage de ports ne nécessite que quelques ports. Pour en savoir plus, consultez Configuration des connexions réseau.

  5. Ajoutez d'autres conteneurs si nécessaire pour exécuter des logiciels de support supplémentaires. Les conteneurs supplémentaires sont automatiquement désignés comme conteneurs de support. Un groupe de conteneurs de serveurs de jeu ne peut avoir qu'un seul conteneur de serveur de jeu et jusqu'à huit conteneurs de support. Indiquez les paramètres minimaux requis suivants :

    • Nom de la définition du conteneur

    • URI de l'image ECR.

    • Ports de conteneur internes (n'incluez ceci que si le conteneur comporte des processus nécessitant un accès réseau.)

Étape 3 : Configuration des dépendances

  • Si la définition de votre groupe de conteneurs comporte plusieurs conteneurs, vous pouvez éventuellement définir des dépendances entre les conteneurs. Pour plus d’informations, consultez Définition des dépendances des conteneurs.

Étape 3 : Examen et création

  1. Vérifiez tous les paramètres de définition de vos groupes de conteneurs. Utilisez Modifier pour apporter des modifications à n'importe quelle section, y compris à chacune de vos définitions de conteneurs pour le groupe.

  2. Lorsque vous avez terminé de réviser, choisissez Créer.

    Si votre demande aboutit, la console affiche la page détaillée de la nouvelle ressource de définition de groupe de conteneurs. Au départCOPYING, le statut est le suivant : Amazon GameLift Servers vous commencez à prendre des instantanés de toutes les images de conteneurs du groupe. Lorsque cette phase est terminée, le statut de définition du groupe de conteneurs passe àREADY. Une définition de groupe de conteneurs doit avoir un READY statut pour que vous puissiez créer une flotte de conteneurs avec cette définition.

AWS CLI

Lorsque vous utilisez l' AWS interface de ligne de commande pour créer une définition de groupe de conteneurs, conservez vos configurations de définition de conteneur dans un JSON fichier distinct. Vous pouvez référencer le fichier dans votre commande CLI. Voir Création d'un fichier JSON de définition de conteneur des exemples de schéma.

Création d'une définition de groupe de conteneurs

Pour créer une nouvelle définition de groupe de conteneurs, utilisez la commande create-container-group-definition CLI. Pour plus d'informations sur cette commande, consultez create-container-group-definition dans la référence des commandes CLI. AWS

Cet exemple illustre une demande de définition d'un groupe de conteneurs de serveurs de jeu. Cela suppose que vous avez créé un fichier JSON contenant les définitions de conteneurs pour ce groupe.

aws gamelift create-container-group-definition \
    --name MyAdventureGameContainerGroup \
    --operating-system AMAZON_LINUX_2023 \
    --container-group-type GAME_SERVER \
    --total-memory-limit-mebibytes 4096 \
    --total-vcpu-limit 1 \
    --game-server-container-definition file://MyAdventureGameContainers.json

Création d'un fichier JSON de définition de conteneur

Lorsque vous créez une définition de groupe de conteneurs, vous définissez également les conteneurs du groupe. Une définition de conteneur spécifie le référentiel Amazon ECR dans lequel l'image du conteneur est stockée, ainsi que les configurations facultatives pour les ports réseau, les limites d'utilisation du processeur et de la mémoire, ainsi que d'autres paramètres. Nous vous recommandons de créer un JSON fichier unique contenant les configurations de tous les conteneurs d'un groupe de conteneurs. La gestion d'un fichier est utile pour stocker, partager et suivre les versions de ces configurations critiques. Si vous utilisez l' AWS interface de ligne de commande pour créer vos définitions de groupes de conteneurs, vous pouvez référencer le fichier dans la commande.

Pour créer une définition de conteneur

  1. Créez et ouvrez un nouveau .JSON fichier. Par exemple :

    [~/work/glc]$ vim SimpleServer.json

  2. Créez une définition de conteneur distincte pour chacun des conteneurs du groupe. Copiez l'exemple de contenu suivant et modifiez-le selon les besoins pour vos conteneurs. Pour plus de détails sur la syntaxe d'une définition de conteneur, consultez ContainerDefinitionInput la référence de l'Amazon GameLift ServersAPI.

  3. Enregistrez le fichier localement afin de pouvoir y faire référence dans une commande AWS CLI.

Exemple

Cet exemple décrit le conteneur essentiel pour le groupe de conteneurs de votre serveur de jeu. Le conteneur de répliques essentiel comprend l'application de votre serveur de jeu, l'Amazon GameLift ServersAgent, et peut inclure d'autres logiciels de support pour l'hébergement de votre jeu. La définition doit inclure un nom, un URI d'image et une configuration de port. Cet exemple définit également certaines limites de ressources spécifiques au conteneur.

  {
    "ContainerName": "MyAdventureGameServer",
    "ImageUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/gl-containers:myadventuregame-server",
    "PortConfiguration": {
      "ContainerPortRanges": [
        {
          "FromPort": 2000,
          "Protocol": "TCP",
          "ToPort": 2010
        }
      ]
    },
    "ServerSdkVersion": "5.2.0"
  }