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.
# Amazon GameLift Serversflottes de conteneurs gérées
Amazon GameLift Serversles flottes de conteneurs gérées fournissent des ressources basées sur le cloud pour héberger votre logiciel de serveur de jeu conteneurisé. Avec un parc de conteneurs géré, vous bénéficiez de la flexibilité, de la sécurité et de la fiabilité des AWS Cloud ressources, optimisées pour l'hébergement de jeux multijoueurs. Amazon GameLift Serversfournit des outils de gestion d'hôte robustes.
**Accélérez l'intégration grâce à ces outils pour les conteneurs gérés :**
Le [kit de démarrage pour conteneurs](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) rationalise l'intégration et la configuration de la flotte. Il ajoute des fonctionnalités essentielles de gestion des sessions de jeu à votre serveur de jeu et utilise des modèles préconfigurés pour créer une flotte de conteneurs et un pipeline de déploiement automatisé pour votre serveur de jeu. Après le déploiement, utilisez la Amazon GameLift Servers console et les outils d'API pour surveiller les performances de la flotte, gérer les sessions de jeu et analyser les indicateurs.
Pour les développeurs Unreal Engine ou Unity, utilisez les [Amazon GameLift Serversplugins et le serveur du](https://github.com/amazon-gamelift/) moteur de jeu SDKs pour intégrer votre serveur de jeu et créer une flotte de conteneurs à partir de l'environnement de développement de votre moteur de jeu. Les flux de travail guidés du plugin vous aident à créer une solution simple et rapide avec un hébergement basé sur le cloud à l'aide de conteneurs gérés. Vous pouvez vous appuyer sur cette base pour créer une solution d'hébergement personnalisée pour votre jeu.
Un parc de conteneurs géré est un ensemble d'instances Amazon Elastic Compute Cloud (Amazon EC2) exécutant Linux, qui Amazon GameLift Servers possède et exploite en fonction de votre configuration. Ces instances sont physiquement situées dans des zones prises en charge Régions AWS ou des zones locales. Lorsque vous créez un parc de conteneurs, vous choisissez un type d' EC2 instance qui répond aux exigences de votre serveur de jeu en termes de puissance de calcul, de mémoire, de stockage et de capacités réseau.
Pour un parc de conteneurs géré, vous stockez des images de conteneurs basées sur Linux dans un référentiel Amazon Elastic Container Registry (Amazon ECR) et vous créez une définition de groupe de conteneurs pour décrire votre architecture de conteneurs. Lorsque vous créez une flotte, Amazon GameLift Servers approvisionnez une instance de flotte avec la dernière version de Linux Amazon Machine Image (AMI) et utilisez la définition du groupe de conteneurs pour déployer vos images de conteneurs. Toutes les instances d'un parc de conteneurs utiliseront la même version d'AMI, même si vous mettez à jour la définition d'un groupe de conteneurs ou modifiez une image de conteneur.
**Note**
À titre de bonne pratique, nous vous recommandons de remplacer vos flottes tous les 30 jours afin de garantir un environnement d' up-to-dateexécution sécurisé pour vos serveurs de jeux hébergés. Cela nécessite la création d'une nouvelle flotte et la migration du trafic des joueurs vers celle-ci. Pour plus d'informations, consultez [Bonnes pratiques de sécurité pour Amazon GameLift Servers](security-best-practices.md).
Après le déploiement de l'instance conteneurisée, les conteneurs commencent à lancer les processus du serveur de jeu. Chaque processus du serveur de jeu établit une connexion au Amazon GameLift Servers service, indique qu'il est prêt à héberger une session de jeu et commence à communiquer l'état de santé. Amazon GameLift Serverspeut ensuite demander au processus du serveur de démarrer une session de jeu.
Outre le déploiement de la flotte, Amazon GameLift Servers gère les tâches de gestion des hôtes suivantes afin que vous n'ayez pas à :
+ Suit l'état de tous les conteneurs de la flotte et remplace les conteneurs périmés ou insalubres.
+ Gère l'authentification pour la communication entre les processus du serveur et le Amazon GameLift Servers service.
+ Propose des outils de mise à l'échelle automatique qui ajustent la capacité de la flotte de manière dynamique pour répondre à la demande des joueurs.
+ Indique les indicateurs de performance pour les EC2 instances, les conteneurs et les processus de serveur de la flotte.
Consultez les rubriques suivantes pour savoir comment configurer et gérer des flottes de conteneurs gérées :
+ [Feuille de route de développement pour l'hébergement avec des conteneurs Amazon GameLift Servers gérés](gamelift-roadmap-containers.md)
+ [Création d'une flotte de conteneurs Amazon GameLift Servers gérée](containers-build-fleet.md)
+ [Personnalisez une flotte de Amazon GameLift Servers conteneurs](containers-design-fleet.md)
+ [Augmenter la capacité d'hébergement de jeux avec Amazon GameLift Servers](fleets-manage-capacity.md)
+ [Mettre à jour et Amazon GameLift Servers gérer un parc de conteneurs](containers-update-fleet.md)
# Comment fonctionnent les conteneurs dans Amazon GameLift Servers
Amazon GameLift Serversles flottes de conteneurs sont conçues pour vous apporter de la flexibilité dans la manière dont vous déployez et dimensionnez vos applications conteneurisées. Il utilise Amazon Elastic Container Service (Amazon ECS) pour gérer le déploiement et l'exécution des tâches pour Amazon GameLift Servers vos flottes. Cette rubrique décrit les éléments structurels de base pour faire fonctionner des conteneurs sur un parc Amazon GameLift Servers géré, illustre les architectures courantes et décrit certains concepts de base.
**Accélérez l'intégration grâce à ces outils pour les conteneurs gérés :**
Le [kit de démarrage pour conteneurs](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) rationalise l'intégration et la configuration de la flotte. Il ajoute des fonctionnalités essentielles de gestion des sessions de jeu à votre serveur de jeu et utilise des modèles préconfigurés pour créer une flotte de conteneurs et un pipeline de déploiement automatisé pour votre serveur de jeu. Après le déploiement, utilisez la Amazon GameLift Servers console et les outils d'API pour surveiller les performances de la flotte, gérer les sessions de jeu et analyser les indicateurs.
Pour les développeurs Unreal Engine ou Unity, utilisez les [Amazon GameLift Serversplugins](https://github.com/amazon-gamelift/) pour intégrer votre serveur de jeu et créer une flotte de conteneurs à partir de l'environnement de développement de votre moteur de jeu. Les flux de travail guidés du plugin vous aident à créer une solution simple et rapide avec un hébergement basé sur le cloud à l'aide de conteneurs gérés. Puis, sur cette base, créez une solution d'hébergement personnalisée pour votre jeu.
## Composants du parc de conteneurs
**Flotte**
Un parc de conteneurs est un ensemble d'instances Amazon EC2 destinées à héberger vos serveurs de jeux conteneurisés. Ces instances sont gérées Amazon GameLift Servers en votre nom. Lorsque vous créez une flotte, vous configurez la manière dont l'architecture du conteneur est déployée avec le logiciel de votre serveur de jeu sur chaque instance de flotte. Vous pouvez créer un parc de conteneurs avec des instances situées dans un ou plusieurs emplacements géographiques. Vous pouvez utiliser des outils de Amazon GameLift Servers dimensionnement pour adapter automatiquement la capacité d'une flotte de conteneurs afin d'accueillir des sessions de jeu et des joueurs.
**Instance**
Une instance Amazon EC2 est le serveur virtuel qui fournit la capacité de calcul pour l'hébergement de jeux. AvecAmazon GameLift Servers, vous pouvez choisir parmi une gamme de types d'instances. Chaque type d'instance offre une combinaison différente de CPU, de mémoire, de stockage et de capacité réseau.
Lorsque vous créez un parc de conteneurs, Amazon GameLift Servers déployez vos conteneurs en fonction du type d'instance que vous avez choisi et de la configuration de votre flotte. Chaque instance de flotte déployée est identique et exécute le logiciel de votre serveur de jeu conteneurisé de la même manière. Le nombre d'instances d'une flotte détermine la taille de la flotte et sa capacité d'hébergement de jeux.
**Groupe de conteneurs**
Amazon GameLift Serversutilise le concept de groupe de conteneurs pour décrire et gérer un ensemble de conteneurs. Un groupe de conteneurs est similaire à une « tâche » ou à un « pod » de conteneurs. Au sein de chaque groupe de conteneurs, vous pouvez définir le comportement des conteneurs, configurer les dépendances et partager les ressources de processeur et de mémoire disponibles.
Chaque instance de flotte peut comporter les types de groupes de conteneurs suivants :
+ Un **groupe de conteneurs de serveurs de jeux** gère les conteneurs qui exécutent votre application de serveur de jeu et les logiciels associés. Une flotte de conteneurs doit disposer d'un groupe de conteneurs de ce type pour accueillir les sessions de jeu et les joueurs. Un groupe de conteneurs de serveurs de jeu peut être répliqué sur une instance de flotte. Le nombre de répliques de groupes de serveurs de jeu par instance de flotte dépend des exigences de calcul de votre logiciel et des ressources de calcul disponibles sur l'instance.
+ Un **groupe de conteneurs par instance**, facultatif, vous permet d'exécuter des logiciels supplémentaires sur chaque instance de flotte. Ils sont utiles pour exécuter des services d'arrière-plan ou des programmes utilitaires, par exemple pour la surveillance. Le logiciel de votre serveur de jeu ne dépend pas directement des processus d'un groupe par instance. Une seule copie d'un groupe de conteneurs par instance est déployée sur chaque instance de flotte.
Chaque groupe de conteneurs d'une flotte de conteneurs possède un conteneur désigné « essentiel ». Un conteneur essentiel conditionne le cycle de vie d'un groupe de conteneurs. Si le conteneur essentiel tombe en panne, l'ensemble du groupe de conteneurs redémarre.
**Conteneur**
Le conteneur est l'élément le plus fondamental d'une architecture basée sur un conteneur. Il inclut une image de conteneur avec les exécutables du logiciel et les fichiers dépendants. Définissez un conteneur pour configurer le mode d'exécution et d'interaction du logiciel. Amazon GameLift Servers
Amazon GameLift Serversdéfinit deux types de conteneurs :
+ Un **conteneur de serveur de jeu** inclut tout ce dont vous avez besoin pour exécuter les processus de votre serveur de jeu et héberger des sessions de jeu pour les joueurs. Cela inclut la version de votre serveur de jeu et les logiciels qui en dépendent. Définissez un conteneur de serveur de jeu pour le groupe de conteneurs de serveurs de jeu d'une flotte. Le conteneur du serveur de jeu est automatiquement considéré comme essentiel pour le groupe de conteneurs.
+ Un **conteneur de support** exécute des logiciels supplémentaires pour prendre en charge votre serveur de jeu. Il est similaire au concept d'un conteneur « sidecar ». Il vous donne la possibilité d'exécuter et de faire évoluer les logiciels de support parallèlement à vos serveurs de jeu, mais de les gérer en tant que conteneurs distincts. Dans un groupe de conteneurs de serveurs de jeu, vous pouvez définir zéro ou plusieurs conteneurs de support. Dans un groupe de conteneurs par instance, tous les conteneurs sont des conteneurs de support. Tout contenant de support peut être désigné comme essentiel.
**Calcul**
Un calcul représente une copie d'un groupe de conteneurs de serveurs de jeu sur une instance de flotte.
## Architectures communes
Le schéma suivant illustre la structure de flotte de conteneurs la plus simple. Dans cette structure, chaque instance de la flotte conserve une copie du groupe de conteneurs du serveur de jeu. Le groupe de conteneurs possède un conteneur de serveur de jeu unique qui exécute un processus de serveur de jeu. Dans cet exemple, le parc de conteneurs est configuré pour placer une copie du groupe de conteneurs du serveur de jeu par instance. Avec cette architecture, chaque instance exécute un processus de serveur de jeu.
![\[Exemple d'architecture de conteneur simple, avec un conteneur de serveur de jeu unique dans le groupe de conteneurs de serveurs de jeu.\]](http://docs.aws.amazon.com/fr_fr/gameliftservers/latest/developerguide/images/container_architecture_simple.png)
Ce deuxième schéma illustre une architecture de flotte de conteneurs plus complexe. Dans cette structure, la flotte possède à la fois un groupe de conteneurs de serveurs de jeu et un groupe de conteneurs par instance. Le groupe de conteneurs de serveurs de jeu possède des conteneurs distincts pour le processus du serveur de jeu et un processus de support. La flotte est configurée pour placer trois copies du groupe de conteneurs du serveur de jeu sur chaque instance de flotte. Le groupe de conteneurs par instance n'est jamais répliqué. Dans cet exemple, le parc de conteneurs est configuré pour placer trois copies du groupe de conteneurs du serveur de jeu par instance. Avec cette architecture, chaque instance exécute trois processus de serveur de jeu.
![\[Exemple d'architecture de conteneur avec plusieurs conteneurs dans le groupe de conteneurs du serveur de jeu et un conteneur dans le groupe de conteneurs par instance.\]](http://docs.aws.amazon.com/fr_fr/gameliftservers/latest/developerguide/images/container_architecture_complex.png)
## Fonctions de base
Cette section résume comment Amazon GameLift Servers implémenter certains concepts de base des conteneurs. Pour obtenir des instructions sur la manière de travailler avec des flottes de conteneurs, consultez les rubriques pertinentes de ce guide.
### Mises à jour actives du parc
Les conteneurs gérés fournissent un support avancé pour vous aider à gérer le cycle de vie de votre logiciel hébergé et de votre architecture de conteneur. Vous pouvez mettre à jour les définitions de vos conteneurs, y compris les images des conteneurs, et apporter des modifications à vos flottes existantes. Cette fonctionnalité accélère et facilite l'itération des modifications apportées à vos conteneurs pendant le développement. Il fournit également des fonctionnalités qui vous aident à créer, déployer et suivre les mises à jour de vos versions logicielles au fil du temps. Ces fonctionnalités incluent :
+ Gérez les mises à jour et le versionnement des définitions de groupes de conteneurs. Vous pouvez mettre à jour presque toutes les propriétés d'une définition de groupe de conteneurs, y compris les images de conteneurs et les paramètres de configuration. Chaque fois que vous mettez à jour un conteneur, attribue Amazon GameLift Servers automatiquement un numéro de version à la mise à jour et conserve toutes les versions par défaut. Vous pouvez accéder à n'importe quelle version spécifique, et vous pouvez supprimer des versions comme vous le souhaitez. Lorsque vous créez un parc de conteneurs, vous pouvez spécifier la définition du groupe de conteneurs et la version à déployer.
+ Mettez à jour les flottes de conteneurs existantes avec de nouvelles définitions de groupes de conteneurs et de nouveaux paramètres de configuration. Vous pouvez déployer des mises à jour de conteneurs sur des flottes déjà déployées sur des instances de flotte. Vous pouvez suivre l'état des déploiements de mises à jour sur chaque site du parc à l'aide du AWS SDK AWS Management Console ou de la CLI.
+ Configurez la manière dont vous souhaitez que les mises à jour de flotte soient déployées sur une flotte active.
+ Protection des sessions de jeu. Choisissez de protéger les instances de flotte avec des sessions de jeu actives jusqu'à la fin des sessions de jeu (déploiement sécurisé). Vous pouvez également choisir de remplacer les instances de flotte indépendamment de l'activité des sessions de jeu (déploiement non sécurisé). Utilisez des déploiements non sécurisés pendant les phases de développement et de test afin de réduire le temps de déploiement.
+ Pourcentage de santé minimum. Spécifiez le pourcentage de tâches saines que vous souhaitez conserver pendant le déploiement. Cette fonctionnalité vous permet de décider du nombre d'instances de flotte concernées lors d'un déploiement. Une valeur faible donne la priorité à la vitesse de déploiement, tandis qu'une valeur élevée garantit que la disponibilité du serveur de jeu reste élevée tout au long du déploiement.
+ Stratégie en cas d'échec du déploiement. Décidez des mesures à prendre en cas d'échec d'un déploiement. Un échec de déploiement signifie que certains conteneurs mis à jour ont échoué aux vérifications d'état et sont considérés comme défectueux. Vous pouvez configurer des déploiements pour rétablir automatiquement l'état précédemment déployé de toutes les instances de flotte. Vous pouvez également choisir de conserver certaines instances de flotte altérées pour les utiliser lors du débogage.
La possibilité de mettre à jour les flottes actives est très utile lorsque vous souhaitez déployer une mise à jour du logiciel de votre serveur de jeu. Une fois que vous avez créé une nouvelle image de conteneur pour votre serveur de jeu, son déploiement s'effectue en deux étapes : tout d'abord, mettez à jour la définition du groupe de conteneurs avec la nouvelle image, puis mettez à jour le parc de conteneurs. Amazon GameLift Serversgère toutes les autres tâches selon les besoins.
### Emballage de conteneurs
Lorsque vous développez votre structure de conteneurs en vue d'un déploiement dans une flotte de conteneurs, un objectif commun est d'optimiser l'utilisation de la puissance de calcul disponible. Pour atteindre cet objectif, vous devez intégrer autant de groupes de conteneurs de serveurs de jeu que possible dans chaque instance de flotte.
Amazon GameLift Serversvous y aide en calculant le nombre maximal de groupes de conteneurs de serveurs de jeu par instance, sur la base des informations suivantes :
+ Le type d'instance du parc, ses vCPU et ses ressources de mémoire.
+ Les exigences en matière de vCPU et de mémoire pour tous les conteneurs du groupe de conteneurs du serveur de jeu.
Les exigences en matière de vCPU et de mémoire pour tous les conteneurs d'un groupe de conteneurs par instance, le cas échéant.
Lorsque vous créez une flotte de conteneurs, vous pouvez utiliser le maximum calculé ou vous pouvez spécifier le nombre souhaité. Il est recommandé de faire des essais avec le logiciel de votre serveur de jeu conteneurisé afin de déterminer les ressources nécessaires pour des performances optimales du serveur de jeu.
### Mise à l'échelle de la capacité
La capacité de la flotte mesure le nombre de sessions de jeu qu'une flotte peut héberger simultanément. Vous pouvez également mesurer la capacité en fonction du nombre de joueurs simultanés qu'une flotte peut supporter. Pour augmenter ou diminuer la capacité d'hébergement d'une flotte, vous ajoutez ou supprimez des instances de flotte.
Une flotte de conteneurs est configurée pour exécuter un nombre spécifique de processus de serveur de jeu simultanés sur chaque instance de flotte. (Vous pouvez le calculer en fonction (1) des groupes de conteneurs du serveur de jeu par instance et (2) du nombre de processus du serveur de jeu exécutés dans chaque groupe de conteneurs.) Le nombre de serveurs de jeu actuels par instance vous indique quel est l'impact de l'ajout ou de la suppression de chaque instance de flotte. Par exemple, si votre flotte de conteneurs exécute un processus de serveur de jeu dans chaque groupe de conteneurs de serveurs de jeu, et que chaque instance de flotte contient 100 groupes de conteneurs de serveurs de jeu, vous augmentez ou diminuez la capacité de votre flotte à héberger des sessions de jeu simultanées par incréments de 100. Si chaque session de jeu comporte 10 emplacements pour joueurs, vous augmentez ou diminuez la capacité de votre flotte à accueillir des joueurs par incréments de 1 000.
Avec les flottes de conteneurs, vous pouvez utiliser n'importe laquelle des méthodes de dimensionnement des capacités fournies parAmazon GameLift Servers. Il s’agit des licences suivantes :
+ Définissez la capacité du parc manuellement en définissant le nombre d'instances de flotte souhaité.
+ Configurez le dimensionnement automatique en ciblant la mémoire tampon souhaitée parmi les instances disponibles (suivi des cibles). Cette méthode maintient automatiquement un certain nombre de ressources d'hébergement inactives afin que les joueurs entrants puissent accéder rapidement aux jeux. À mesure que la demande des joueurs augmente ou diminue, la taille de cette mémoire tampon est continuellement ajustée.
+ Configurez le dimensionnement automatique avec des règles de dimensionnement personnalisées (fonctionnalité avancée). Cette méthode vous permet d'évoluer en fonction des indicateurs de flotte que vous choisissez.
### client/server Connexions au jeu
Avec les flottes Amazon GameLift Servers gérées, les clients de jeu se connectent directement à vos serveurs de jeu hébergés dans le cloud. Lorsqu'un client de jeu demande à rejoindre un jeu, Amazon GameLift Servers trouve une session de jeu et fournit des informations de connexion (IP et port) au client du jeu. Vous pouvez contrôler l'accès externe aux instances de flotte en ouvrant certaines plages de ports (autorisations entrantes) pour la flotte. Les autorisations entrantes déterminent les ports ouverts au trafic entrant. Vous pouvez rapidement fermer tous les ports, en limiter à quelques-uns ou ouvrir tous les ports.
Les flottes de conteneurs gérées nécessitent un paramètre supplémentaire permettant d'accéder aux processus exécutés dans un conteneur. Lorsque vous créez une définition de conteneur, vous spécifiez un ensemble de ports, un pour chaque processus qui établit une connexion. Cela inclut notamment les éléments suivants :
+ Tous les processus du serveur de jeu qui s'exécuteront simultanément dans le conteneur du serveur de jeu. Tous les processus du serveur de jeu doivent autoriser les clients du jeu à se connecter pour rejoindre une session de jeu.
+ Tout processus d'un conteneur de support auquel une source externe doit se connecter. Par exemple, vous pouvez vous connecter à distance à une application de test.
Lorsque vous définissez les paramètres du port de conteneur interne, Amazon GameLift Servers utilisez-les pour calculer les autorisations entrantes externes auxquelles les clients du jeu et les autres applications peuvent se connecter. Amazon GameLift Serversgère également le mappage entre les autorisations entrantes et les ports de conteneur individuels, ce qui permet aux joueurs d'accéder à une session de jeu dans un conteneur. Ce mappage interne fournit une couche de sécurité en protégeant vos serveurs de jeu d'un accès direct aux ports à conteneurs. Vous avez la possibilité de personnaliser les paramètres des ports orientés vers l'extérieur d'une flotte selon vos besoins. Pour plus d'informations sur la configuration manuelle des ports de flotte de conteneurs, consultez[Configuration des connexions réseau](containers-design-fleet.md#containers-custom-network).
Vous pouvez modifier les paramètres portuaires d'une flotte de conteneurs à tout moment. Cette modification nécessite le déploiement d'une mise à jour de la flotte.
Le schéma suivant illustre le rôle des connexions portuaires au sein d'une flotte de conteneurs. Comme indiqué, vous définissez des ports sur des conteneurs individuels et utilisez ces Amazon GameLift Servers informations pour configurer suffisamment de ports sur l'instance de flotte pour qu'ils soient mappés à chaque port de conteneur. Les autorisations entrantes des instances externes et les ports de connexion internes sont calculés Amazon GameLift Servers pour votre parc, sauf si vous choisissez de les définir manuellement.
![\[Illustration des paramètres portuaires d'une flotte de conteneurs. Les mappages de ports permettent au trafic externe de se connecter à une instance de flotte et d'accéder à un conteneur individuel sur l'instance.\]](http://docs.aws.amazon.com/fr_fr/gameliftservers/latest/developerguide/images/container_design_networking.png)
### Enregistrement des conteneurs
Dans les flottes de conteneurs gérées, les flux de sortie standard (et d'erreur standard) sont capturés pour tous les conteneurs. Cela inclut les journaux de session de jeu de votre serveur de jeu. Vous pouvez configurer un parc de conteneurs pour utiliser l'une des options suivantes pour gérer les flux de sortie :
+ Enregistrez la sortie du conteneur sous forme de flux de CloudWatch journal Amazon. Chaque flux de journal fait référence à l'identifiant de la flotte et au conteneur. Si vous choisissez cette option de journalisation pour la flotte, vous spécifiez un groupe de CloudWatch journaux qui organise tous les flux de journaux de la flotte. Vous pouvez ensuite utiliser les CloudWatch fonctionnalités pour rechercher et analyser les données du journal selon vos besoins.
+ Enregistrez la sortie du conteneur dans un bucket de stockage Amazon Simple Storage Service (Amazon S3). Vous pouvez consulter, partager ou télécharger le contenu selon vos besoins.
+ Désactivez la journalisation. Dans ce scénario, la sortie du conteneur n'est pas enregistrée.
Amazon GameLift Serversenvoie les données de journal des flottes de conteneurs gérées vers les CloudWatch services Amazon S3 de votre AWS compte. Pour consulter vos données, utilisez ces outils AWS Management Console ou d'autres outils en vous connectant à votre AWS compte et en utilisant les différents services. Vous étendez l'accès limité Amazon GameLift Servers pour effectuer ces actions en créant un rôle de service pour vos flottes de conteneurs.
Vous pouvez modifier la configuration de journalisation d'une flotte de conteneurs à tout moment. Cette modification nécessite le déploiement d'une mise à jour de la flotte.
### Les flottes de conteneurs et l'agent Amazon GameLift Servers
Une architecture de conteneur couramment utilisée exécute un seul processus dans chaque conteneur. Dans une flotte de Amazon GameLift Servers conteneurs, le groupe de conteneurs de serveurs de jeu possède un conteneur de serveur de jeu, qui exécute un processus de serveur de jeu. Cette architecture permet de Amazon GameLift Servers gérer le cycle de vie du processus de serveur de jeu unique dans chaque groupe de conteneurs de serveurs de jeu d'une instance de flotte.
Si vous choisissez de créer une architecture de conteneur qui exécute plusieurs processus de serveur de jeu dans chaque groupe de conteneurs de serveurs de jeu, vous devez trouver un moyen de gérer le cycle de vie de tous les processus. Cela inclut des tâches telles que le démarrage, l'arrêt et le remplacement de processus selon les besoins, la gestion du nombre souhaité de processus à exécuter simultanément et la gestion des états de défaillance.
Vous pouvez choisir d'utiliser l'Amazon GameLift Serversagent pour ces tâches. Pour un parc de conteneurs, l'agent implémente des instructions d'exécution qui spécifient les exécutables à exécuter (et leur nombre), fournissent les paramètres de lancement et définissent les règles relatives à l'activation du serveur de jeu. Par exemple, les instructions d'exécution peuvent indiquer à l'agent de gérer dix processus de serveur de jeu pour une utilisation en production, et un processus de serveur de jeu avec des paramètres de lancement spéciaux pour les tests.
Pour utiliser l'agent avec vos flottes de conteneurs, ajoutez-le à l'image de votre conteneur et incluez un ensemble d'instructions d'exécution. Pour plus d'informations sur l'agent, consultez[Collaborez avec l'Amazon GameLift Serversagent](integration-dev-iteration-agent.md).
# Création d'une flotte de conteneurs Amazon GameLift Servers gérée
Créez un parc de conteneurs Amazon GameLift Servers géré pour déployer et héberger votre serveur de jeu conteneurisé dans le AWS cloud. Lorsque vous créez une flotte de conteneurs, spécifiez des définitions de groupes de conteneurs qui spécifient une ou plusieurs images de conteneurs (au moins une qui inclut la version de votre serveur de jeu) et des paramètres de configuration.
Lorsque vous créez une nouvelle ressource de flotte de conteneurs gérée, vous lancez immédiatement la première phase de création de flotte. La création d'un parc géré passe par plusieurs phases : Amazon GameLift Servers provisionnement d'une instance EC2, installation d'un environnement d'exécution, déploiement de vos groupes de conteneurs sur l'instance et lancement des processus du serveur de jeu. En fonction de l'environnement d'exécution requis par la création de votre serveur de jeu, Amazon GameLift Servers déploie la dernière version d'Amazon Machine Image (AMI) au moment de la création de la flotte (et toutes les futures instances de la flotte utiliseront la même version). Vous pouvez surveiller l'état d'une flotte dans la console ou à l'aide du AWS Command Line Interface (AWS CLI). Lorsqu'une flotte est prête à accueillir des sessions de jeu, son statut passe à`ACTIVE`. Pour obtenir de l'aide face à des problèmes de création de flotte, veuillez consulter [Déboguer les incidents de flotte Amazon GameLift Servers](fleets-creating-debug.md).
Vous pouvez choisir de créer une flotte de conteneurs vide, puis d'ajouter ou de mettre à jour les définitions des groupes de conteneurs de la flotte ultérieurement. Si vous créez une flotte sans définition de groupe de conteneurs, la flotte n'atteindra pas le statut actif.
**Note**
À titre de bonne pratique, nous vous recommandons de remplacer vos flottes tous les 30 jours afin de garantir un environnement d' up-to-dateexécution sécurisé pour vos serveurs de jeux hébergés. Cela nécessite la création d'une nouvelle flotte et la migration du trafic des joueurs vers celle-ci. Pour plus d'informations, consultez [Bonnes pratiques de sécurité pour Amazon GameLift Servers](security-best-practices.md).
Utilisez la [Amazon GameLift Serversconsole](https://console.aws.amazon.com/gamelift/) ou le AWS Command Line Interface (AWS CLI) pour créer une flotte de conteneurs.
------
#### [ Console ]
Dans la [Amazon GameLift Serversconsole](https://console.aws.amazon.com/gamelift/), sélectionnez l' Région AWS endroit où vous souhaitez créer la flotte. Les définitions des groupes de conteneurs doivent se trouver dans la même région que celle où vous souhaitez créer la flotte.
Ouvrez la barre de navigation gauche de la console et choisissez **Conteneurs gérés : flottes.** Sur la page Flottes, choisissez **Create container fleet**.
**Étape 1 : définir les détails du parc de conteneurs géré**
1. Dans la section **Détails de la flotte de conteneurs**, entrez une description de la flotte.
1. Spécifiez un **rôle IAM** pour la flotte. Ce rôle dispose des Amazon GameLift Servers autorisations nécessaires pour gérer le parc de conteneurs en votre nom. Pour obtenir de l'aide pour créer le rôle de service requis, consultez[Configurer un rôle de service IAM pour Amazon GameLift Servers](setting-up-role.md).
1. Choisissez une option de **configuration du journal**. L' CloudWatch option est sélectionnée par défaut. Fournissez les informations requises en fonction de l'option que vous avez sélectionnée.
1. Ajoutez des groupes de conteneurs à la flotte. Il s'agit d'une étape facultative. Vous pouvez choisir de créer une flotte sans groupe de conteneurs avec un plan pour les ajouter ultérieurement. Une flotte dépourvue de groupes de conteneurs ne déploiera aucune instance de flotte et ne pourra pas encore héberger de jeux, mais la ressource de flotte est créée.
+ Sélectionnez une définition de groupe de conteneurs de serveurs de jeu. Spécifiez éventuellement la version de la définition que vous souhaitez déployer. Si vous ne spécifiez pas le numéro de version, utilise Amazon GameLift Servers automatiquement la dernière version.
+ Ajoutez éventuellement une définition et une version de groupe de conteneurs par instance. Si vous ne spécifiez pas le numéro de version, utilise Amazon GameLift Servers automatiquement la dernière version.
1. Dans les **détails supplémentaires**, vous pouvez définir certaines personnalisations facultatives. Aucun de ces paramètres n'est requis pour créer le parc de conteneurs.
**Étape 2 : définir les détails de l'instance**
1. Dans **Déploiement d'instances**, sélectionnez un ou plusieurs sites distants sur lesquels déployer les instances. La région d'origine est automatiquement sélectionnée (il s'agit de la région dans laquelle vous créez la flotte). Si vous sélectionnez des sites supplémentaires, des instances de flotte sont également déployées sur ces sites.
**Important**
Pour utiliser des régions qui ne sont pas activées par défaut, activez-les dans votre Compte AWS.
Les flottes dont les régions ne sont pas activées et que vous avez créées avant le 28 février 2022 ne sont pas concernées par cette exigence.
Pour créer de nouvelles flottes multi-sites ou pour mettre à jour les flottes multi-sites existantes, activez d'abord les Régions ou les Zones Locales que vous choisissez d'utiliser.
Pour plus d'informations sur les régions qui ne sont pas activées par défaut et sur la manière de les activer, consultez la section [Gestion Régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le *Références générales AWS*. Voir [Commencer à utiliser les zones locales](https://docs.aws.amazon.com/local-zones/latest/ug/getting-started.html) dans le *guide de l'utilisateur des zones AWS locales*.
1. Sélectionnez une **configuration d'instance** pour le parc. La console calcule automatiquement le minimum de vCPU et de mémoire requis (en fonction des limites totales que vous définissez pour chaque groupe de conteneurs). Il filtre la liste complète des types d'instances disponibles en fonction des besoins en ressources et des emplacements que vous avez saisis. Vous pouvez ajouter des filtres supplémentaires selon vos besoins.
Pour plus d'informations sur le choix d'un type d'instance, consultez[Configuration d'une flotte de conteneurs](containers-design-fleet.md#containers-design-fleet-config). La taille du type d'instance que vous choisissez aura un impact sur la manière dont les groupes de conteneurs du serveur de jeu sont regroupés dans chaque instance de flotte. En fonction de votre choix, pensez à revoir vos paramètres pour les groupes de conteneurs de serveurs de jeu souhaités par instance.
**Étape 4 : vérifier et créer**
+ Passez en revue les paramètres de configuration de votre flotte.
Vous pouvez mettre à jour les métadonnées et la configuration de la flotte à tout moment, quel que soit l'état de la flotte. Pour de plus amples informations, veuillez consulter [Mettre à jour la configuration d'une Amazon GameLift Servers flotte](fleets-editing.md). Vous pouvez mettre à jour la capacité de la flotte une fois que celle-ci a atteint le statut ACTIF. Pour de plus amples informations, veuillez consulter [Augmenter la capacité d'hébergement de jeux avec Amazon GameLift Servers](fleets-manage-capacity.md). Vous pouvez également ajouter ou supprimer des sites distants.
Lorsque vous avez terminé de réviser, choisissez **Créer**.
Si votre demande est acceptée, la console affiche la page détaillée de la nouvelle ressource de flotte. Au départ`NEW`, le statut est le suivant : au Amazon GameLift Servers moment où commence le processus de création de flotte. Vous pouvez suivre le statut de la nouvelle flotte sur la page **Flottes**. Une flotte est prête à accueillir des sessions de jeu lorsqu'elle atteint son statut`ACTIVE`.
------
#### [ AWS CLI ]
Pour créer une flotte de conteneurs avec le AWS CLI, ouvrez une fenêtre de ligne de commande et utilisez la `create-container-fleet` commande. Pour plus d'informations sur cette commande, consultez [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-container-fleet.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-container-fleet.html)la *référence des AWS CLI commandes*.
L'exemple de `create-container-fleet` demande ci-dessous crée une nouvelle flotte de conteneurs présentant les caractéristiques suivantes :
+ ContainerGroupsConfiguration Spécifie une définition de groupe de conteneurs de serveurs de jeux uniquement :`MyAdventureGameContainerGroup`. Le nombre de groupes de conteneurs de serveurs de jeu qui seront déployés sur chaque instance de flotte est calculé parAmazon GameLift Servers.
+ Le parc utilise par défaut des instances à la demande c5.large.
+ Par défaut, le parc ouvre un ensemble de ports de connexion et de ports d'autorisations entrantes tels que calculés parAmazon GameLift Servers. Il déploie des groupes de conteneurs aux emplacements suivants :
```
aws gamelift create-container-fleet \
--fleet-role-arn arn:aws:iam::MyAccount:role/MyContainersRole \
--game-server-container-group-definition-name "rn:aws:gamelift:us-west-2:111122223333:containergroupdefinition/MyAdventureGameContainerGroup:2" \
```
Si la demande de création de flotte aboutit, Amazon GameLift Servers renvoie un ensemble d'attributs de flotte comprenant les paramètres de configuration que vous avez demandés et un nouvel identifiant de flotte de conteneurs. Amazon GameLift Serversdéfinit ensuite le statut de la flotte et les statuts de localisation sur **Nouveau** et lance le processus d'activation de la flotte. Vous pouvez suivre le statut de la flotte et consulter d'autres d'informations de flotte à l'aide de ces commandes d'interface de ligne de commande :
+ [describe-fleet-events](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-events.html)
+ [describe-container-fleet](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-container-fleet.html)
+ [describe-fleet-capacity](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-capacity.html)
+ [describe-fleet-port-settings](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-port-settings.html)
+ [describe-fleet-utilization](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-utilization.html)
+ [describe-fleet-location-capacity](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-location-capacity.html)
+ [describe-fleet-location-utilization](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-location-utilization.html)
Vous pouvez changer la capacité de la flotte et d'autres paramètres de configuration, si nécessaire, à l'aide des commandes suivantes :
+ [update-container-fleet](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-container-fleet.html)
+ [update-fleet-capacity](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-capacity.html)
+ [update-fleet-port-settings](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html)
+ [create-fleet-locations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-fleet-locations.html)
+ [delete-fleet-locations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-fleet-locations.html)
------
# Création d'une définition de groupe de conteneurs pour une flotte de Amazon GameLift Servers 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 Amazon GameLift Servers qui indique les images de conteneurs à déployer dans la flotte et comment les exécuter. 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, consultez[Composants du parc de conteneurs](containers-howitworks.md#containers-howitworks-components).
## Avant de commencer
Conseils sur la marche à suivre avant de commencer à créer une définition de groupe de conteneurs :
+ Finalisez les images de vos conteneurs et transférez-les vers un référentiel Amazon Elastic Container Registry (Amazon ECR) dans le référentiel Région AWS 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 du groupe de conteneurs, et utilise cet instantané lors du déploiement sur un parc de conteneurs. Consultez [Créez une image de conteneur pour Amazon GameLift Servers](containers-prepare-images.md).
+ Créez vos définitions de conteneurs sous forme de fichiers JSON. Une définition de groupe de conteneurs inclut 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 du AWS CLIfor Amazon 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](gamelift-iam-policy-examples.md).
## Création d'une définition de groupe de conteneurs de serveurs de jeu
Un groupe de conteneurs de serveurs de jeux 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 le fichier 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 simple de groupe de conteneurs de serveurs de jeu à l'aide de la Amazon GameLift Servers console ou des outils de la AWS CLI. Pour des informations plus détaillées sur les fonctionnalités optionnelles, consultez[Personnalisez une flotte de Amazon GameLift Servers conteneurs](containers-design-fleet.md).
**Note**
Vous pouvez modifier la plupart des définitions de groupes de conteneurs et des paramètres de définition de conteneur après les avoir créés. Si vous modifiez la définition d'un conteneur, Amazon GameLift Servers capture un nouvel instantané des images du conteneur mises à jour.
**Pour créer une définition de groupe de conteneurs de serveurs de jeu simple, procédez comme suit :**
Les instructions suivantes décrivent comment créer une définition de groupe de conteneurs avec les paramètres minimaux requis et en utilisant les valeurs Amazon GameLift Servers par défaut.
------
#### [ Console ]
Dans la [Amazon GameLift Serversconsole](https://console.aws.amazon.com/gamelift/), sélectionnez l' Région AWS endroit où vous souhaitez créer le groupe de conteneurs.
Ouvrez la barre de navigation 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.
1. Sélectionnez le type de groupe **de conteneurs du serveur de jeu**.
1. Pour **Limite de mémoire totale**, entrez les ressources de mémoire maximales à mettre à disposition pour tous les conteneurs du groupe de conteneurs. Pour obtenir de l'aide sur le calcul de cette valeur, consultez[Définissez des limites de ressources](containers-design-fleet.md#containers-design-fleet-limits).
1. Pour la **limite totale de vCPU**, 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, consultez[Définissez des limites de ressources](containers-design-fleet.md#containers-design-fleet-limits).
**Étape 2 : ajouter des définitions de conteneurs**
Au minimum, un groupe de conteneurs de serveurs de jeux possède un conteneur de serveurs de jeux. Dans la console, la première définition de conteneur que vous créez est le conteneur du serveur de jeu. Cette étape décrit comment définir les paramètres minimaux requis pour la définition d'un conteneur de serveur de jeu.
1. Entrez le **nom de la définition du** conteneur. Chaque conteneur défini pour le groupe doit avoir une valeur de nom unique.
1. Lien vers une image de conteneur avec 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 et résumé : `[Compte AWS].dkr.ecr.[Région AWS].amazonaws.com/[repository ID]@[digest]`
+ URI de l'image et balise : `[Compte AWS].dkr.ecr.[Région AWS].amazonaws.com/[repository ID]:[tag]`
1. Spécifiez la **version Amazon GameLift Servers du SDK du serveur** utilisée par le build du serveur de jeu. Pour une flotte de conteneurs, cette valeur doit être égale ou supérieure à 5,2.0.
1. 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 s'exécuteront dans ce conteneur. Si le conteneur du serveur de jeu n'exécute qu'un seul processus serveur par conteneur, cette plage de ports n'a besoin que de quelques ports. Pour en savoir plus, consultez [Configuration des connexions réseau](containers-design-fleet.md#containers-custom-network).
1. Ajoutez d'autres conteneurs selon les besoins pour exécuter des logiciels de support supplémentaires. Les conteneurs supplémentaires sont automatiquement désignés conteneurs de support. Un groupe de conteneurs de serveurs de jeu ne peut comporter qu'un seul conteneur de serveur de jeu et jusqu'à huit conteneurs de support. Fournissez les paramètres minimaux requis suivants :
+ **Nom de la définition du** conteneur
+ **URI de l'image ECR**.
+ **Ports de conteneur internes** (incluez-les uniquement si le conteneur possède des processus nécessitant un accès au réseau.)
**Étape 3 : Configuration des dépendances**
+ Si votre définition de groupe de conteneurs comporte plusieurs conteneurs, vous pouvez éventuellement définir des dépendances entre les conteneurs. Pour de plus amples informations, veuillez consulter [Définir les dépendances des conteneurs](containers-design-fleet.md#containers-design-fleet-dependencies).
**Étape 3 : Examen et création**
1. Passez en revue tous les paramètres de définition de votre groupe de conteneurs. Utilisez **Modifier** pour apporter des modifications à n'importe quelle section, y compris à chacune de vos définitions de conteneur pour le groupe.
1. 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épart`COPYING`, le statut est le suivant : Amazon GameLift Servers commence à prendre des instantanés de toutes les images du conteneur pour le 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 le `READY` statut requis pour que vous puissiez créer une flotte de conteneurs à l'aide de cette définition.
------
#### [ AWS CLI ]
Lorsque vous utilisez la AWS CLI pour créer une définition de groupe de conteneurs, conservez vos configurations de définition de conteneur dans un `JSON` fichier séparé. Vous pouvez référencer le fichier dans votre commande CLI. Voir [Création d'un `JSON` fichier de définition de conteneur](#containers-definitions-create) pour 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 la *référence [create-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-container-group-definition.html)des commandes de la AWS CLI*.
Cet exemple illustre une demande de définition de groupe de conteneurs de serveurs de jeux. Cela suppose que vous avez créé un fichier JSON contenant les définitions de conteneur 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 `JSON` fichier 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 le stockage, le partage et le suivi des versions de ces configurations critiques. Si vous utilisez la AWS CLI 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
```
1. 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 de vos conteneurs. Pour plus de détails sur la syntaxe d'une définition de conteneur, consultez [ContainerDefinitionInput](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ContainerDefinitionInput.html)la *référence de l'Amazon GameLift ServersAPI*.
1. Enregistrez le fichier localement afin de pouvoir y faire référence dans une commande AWS CLI.
### Exemple : définition du conteneur d'un serveur de jeu
**Example**
Cet exemple décrit le conteneur essentiel pour le groupe de conteneurs de votre serveur de jeu. Le conteneur de répliques essentiel inclut votre application de 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, une 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"
}
```