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.
# Accédez à distance aux ressources du parc
Vous pouvez vous connecter à n'importe quelle instance de votre parc EC2 Amazon GameLift Servers géré actif ou de vos flottes de conteneurs gérés. Pour les flottes de conteneurs, vous pouvez également vous connecter à des conteneurs individuels exécutés sur une instance pour résoudre les problèmes liés aux sessions de jeu, inspecter les journaux et résoudre les problèmes d'exécution. Les raisons les plus courantes pour accéder à distance à une instance sont les suivantes :
+ Résolvez les problèmes liés à l'intégration de votre serveur de jeu.
+ Ajustez la configuration de votre environnement d'exécution et les autres paramètres spécifiques à la flotte.
+ Surveillez l'activité du serveur de jeu en temps réel, notamment le suivi des journaux.
+ Exécutez des outils d'analyse comparative en utilisant le trafic réel des joueurs.
+ Étudiez les problèmes spécifiques liés à une session de jeu ou à un processus serveur.
Lorsque vous vous connectez à une instance, tenez compte des points suivants :
+ Vous pouvez vous connecter à n'importe quelle instance d'un parc actif. En général, vous ne pouvez pas vous connecter à des flottes non actives, telles que les flottes en cours d'activation ou présentant un état d'erreur. (La disponibilité de ces flottes peut être limitée pendant une courte période.) Pour obtenir de l'aide concernant les problèmes d'activation de la flotte, consultez[Déboguer les incidents de flotte Amazon GameLift Servers](fleets-creating-debug.md).
+ La connexion à une instance active n'affecte pas l'activité d'hébergement de l'instance. L'instance continue de démarrer et d'arrêter les processus du serveur en fonction de la configuration d'exécution. Il active et exécute des sessions de jeu. L'instance peut s'arrêter en réponse à un événement de réduction ou à un autre événement.
+ Toute modification apportée aux fichiers ou aux paramètres de l'instance peut avoir un impact sur les sessions de jeu actives de l'instance et sur les joueurs connectés.
# Connect aux instances de flotte
Vous pouvez vous connecter à distance à n'importe quelle instance EC2 Amazon GameLift Servers gérée active ou à n'importe quelle instance de flotte de conteneurs gérée pour résoudre les problèmes de serveur de jeu, inspecter les journaux et déboguer le comportement d'exécution. Connectez-vous à l'aide de la Amazon GameLift Servers console ou de la AWS CLI.
## Accès à distance via la console
Vous pouvez vous connecter aux instances de flotte directement depuis la Amazon GameLift Servers console à l'aide d'Amazon EC2 Systems Manager (SSM). Cette méthode fournit un accès sécurisé sans nécessiter de configuration supplémentaire ni de gestion des informations d'identification. Pour les flottes de conteneurs, une fois connecté à l'instance, vous pouvez accéder aux conteneurs individuels qui y sont exécutés. Pour de plus amples informations, veuillez consulter [Connect aux conteneurs](containers-remote-access.md).
1. Dans la Amazon GameLift Servers console, choisissez **Managed EC2** ou **Managed containers dans** le volet de navigation, puis **Fleets**.
1. Choisissez l'ID de flotte qui contient l'instance à laquelle vous souhaitez accéder.
1. Sur la page des détails du parc, choisissez l'onglet **Instances** pour afficher toutes les instances de calcul du parc.
1. Sélectionnez l'instance à laquelle vous souhaitez vous connecter, puis choisissez **Connect**. Cela affiche la boîte de dialogue Connect to instance qui vous informe des détails de la connexion et vous permet de visualiser le script qui sera utilisé pour vous connecter à votre instance. Confirmez en choisissant à nouveau **Connect**.
1. Dans la boîte de dialogue de connexion, choisissez **Exécuter** pour créer une nouvelle session SSM. Le système authentifie votre session par le biais du service de gestion des AWS clés (AWS KMS) et ouvre un terminal dans votre navigateur.
**Note**
L'accès à distance via console est disponible pour les flottes exécutant le SDK du serveur version 5.x. Pour les flottes exécutant des versions antérieures du SDK, utilisez la méthode AWS CLI décrite dans la section suivante.
## Accès à distance avec la AWS CLI
Les instructions suivantes décrivent comment se connecter à distance à une instance à l'aide de l'interface de ligne de AWS commande (CLI). Vous pouvez également effectuer des appels programmatiques à l'aide du AWS SDK, comme indiqué dans la [référence de l'API de service pour](https://docs.aws.amazon.com/gamelift/latest/apireference/). Amazon GameLift Servers
### Collectez les données d'instance
Pour vous connecter à une instance de flotte EC2 Amazon GameLift Servers gérée, vous avez besoin des informations suivantes :
+ L'ID de l'instance à laquelle vous souhaitez vous connecter. Vous pouvez utiliser l'ID d'instance ou l'ARN.
+ le SDK du serveur correspondant à Amazon GameLift Servers la version utilisée sur l'instance. Le SDK du serveur est intégré à la version du jeu exécutée sur l'instance.
Les instructions suivantes décrivent comment effectuer ces tâches à l'aide de la AWS CLI. Vous devez connaître l'ID de flotte de l'instance à laquelle vous souhaitez vous connecter.
1. **Obtenez le nom du calcul.** Obtenez la liste de tous les ordinateurs actifs de la flotte. [Calcul de la liste d'](https://docs.aws.amazon.com/cli/latest/reference/gamelift/list-compute.html)appels avec un identifiant de flotte ou un ARN. Pour une flotte à site unique, spécifiez uniquement l'identifiant de flotte. Pour une flotte à sites multiples, spécifiez l'identifiant de la flotte et un emplacement. Dans le cas des flottes EC2 gérées, `list-compute` renvoie une liste d'instances de flotte, dont la propriété `ComputeName` est l'ID de l'instance. Trouvez le calcul auquel vous souhaitez accéder.
**Demande**
```
aws gamelift list-compute \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--location sa-east-1
```
**Réponse**
```
{
"ComputeList": [
{
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeName": "i-0abc12d3e45fa6b78",
"IpAddress": "00.00.000.00",
"DnsName": "b08444ki909kvqu6zpw3is24x5pyz4b6m05i3jbxvpk9craztu0lqrbbrbnbkks.uwp57060n1k6dnlnw49b78hg1rw4rcz7.us-west-2.amazongamelift.com",
"ComputeStatus": "Active",
"Location": "sa-east-1",
"CreationTime": "2023-07-09T22:51:45.931000-07:00",
"OperatingSystem": "AMAZON_LINUX_2023",
"Type": "c4.large"
}
]
}
```
1. **Trouvez la version du SDK du serveur.** Pour obtenir ces informations, vous devez rechercher le build déployé dans la flotte. La version du SDK du serveur est une propriété de construction.
1. Appelez [describe-fleet-attributes](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-attributes.html)avec un ID de flotte ou un ARN pour obtenir l'ID de build et l'ARN de la flotte.
1. Appelez [describe-build](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html) avec l'ID de build ou l'ARN pour obtenir la version du SDK du serveur de la version.
Par exemple :
**Demande**
```
aws gamelift describe-fleet-attributes \
--fleet-ids fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
```
**Réponse**
```
{
"FleetAttributes": [
{
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeType": "EC2",
"BuildId": "build-3333cccc-44dd-55ee-66ff-00001111aa22",
. . .
}
]
}
```
**Demande**
```
aws gamelift describe-build \
--build-id build-3333cccc-44dd-55ee-66ff-00001111aa22
```
**Réponse**
```
"Build": {
"BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
"Name": "My_Game_Server_Build_One",
"OperatingSystem": "AMAZON_LINUX_2023",
"ServerSdkVersion": "5.1.1",
. . .
}
```
## Se connecter à une instance (SDK 5 du serveur)
Si l'instance à laquelle vous souhaitez vous connecter exécute une version de jeu avec la version 5.x du SDK du serveur, connectez-vous à l'instance à l'aide d'Amazon EC2 Systems Manager (SSM). Vous pouvez accéder à des instances à distance qui exécutent Windows ou Linux. Pour les flottes de conteneurs, une fois connecté à l'instance, vous pouvez accéder aux conteneurs individuels qui y sont exécutés. Pour de plus amples informations, veuillez consulter [Connect aux conteneurs](containers-remote-access.md).
**Avant de commencer :**
Complétez les étapes de configuration SSM et installez le plug-in SSM sur votre machine locale. Pour plus d'informations, consultez [Configuration de SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-getting-started.html) et [installation du plug-in Session Manager pour la AWS CLI dans le guide](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) de l'*utilisateur d'Amazon EC2 Systems Manager*.
1. **Demandez des informations d'identification d'accès pour l'instance.** Appelez [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)avec l'ID de flotte et le nom de calcul de l'instance à laquelle vous souhaitez vous connecter. Amazon GameLift Serversrenvoie un ensemble d'informations d'identification temporaires pour accéder à l'instance. Par exemple :
**Demande**
```
aws gamelift get-compute-access \
--compute-name i-11111111a222b333c \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
--region us-west-2
```
**Réponse**
```
{
"ComputeName": "i-11111111a222b333c",
"Credentials": {
"AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
"SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"SessionToken": "AQoDYXdzEJr..."
},
"FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
}
```
1. **Exportez les informations d'accès (facultatif).** Vous pouvez exporter les informations d'identification vers des variables d'environnement et les utiliser pour configurer la AWS CLI pour l'utilisateur par défaut. Pour plus de détails, consultez la section [Variables d'environnement pour configurer la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) dans le guide de AWS Command Line Interface l'utilisateur.
```
export AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN=AQoDYXdzEJr...
```
1. **Connectez-vous à l'instance de flotte.** Démarrez une session SSM avec l'instance à laquelle vous souhaitez vous connecter. Incluez la AWS région ou l'emplacement de l'instance. Pour plus d'informations, notamment sur la façon de configurer SSM et le plug-in SSM, consultez la section [Démarrage d'une session (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html#sessions-start-cli) dans le guide de l'utilisateur d'*Amazon EC2 Systems Manager*.
La demande de démarrage de session utilisera automatiquement les informations d'identification que vous avez acquises à l'étape 1.
```
aws ssm start-session \
--target i-11111111a222b333c \
--region us-west-2 \
```
**Note**
Si vous recevez un message d'erreur de refus d'accès, il se peut qu'une variable d'`AWS_PROFILE`environnement soit définie sur un AWS profil, ce qui amène la AWS CLI à utiliser des informations d'identification incorrectes pour l'accès à distance. Pour résoudre ce problème, désactivez temporairement votre variable d'`AWS_PROFILE`environnement. Vous pouvez également créer un AWS profil personnalisé pour vos informations d'accès à distance et ajouter le paramètre de ligne de `--profile` commande à votre `start-session` demande.
## Se connecter à une instance (SDK de serveur 4.x ou version antérieure)
Si l'instance à laquelle vous souhaitez vous connecter exécute une version de jeu avec la version 4 ou une version antérieure du SDK du serveur, suivez les instructions ci-dessous. Vous pouvez vous connecter à des instances qui exécutent Windows ou Linux. Connectez-vous à une instance Windows à l'aide d'un client RDP (Remote Desktop Protocol). Connectez-vous à une instance Linux à l'aide d'un client SSH.
1. **Demandez des informations d'identification d'accès pour l'instance.** Lorsque vous disposez d'un ID d'instance, utilisez la commande [get-instance-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-instance-access.html)pour demander des informations d'accès. En cas de succès, Amazon GameLift Servers renvoie le système d'exploitation et l'adresse IP de l'instance, ainsi qu'un ensemble d'informations d'identification (nom d'utilisateur et clé secrète). Le format des informations d'identification dépend du système d'exploitation de l'instance. Utilisez les instructions suivantes extraire les informations d'identification pour RDP ou SSH.
+ **Pour les instances Windows** : pour se connecter à une instance Windows, RDP a besoin d'un nom d'utilisateur et d'un mot de passe. La demande `get-instance-access` renvoie ces valeurs sous la forme de chaînes simples, afin que vous puissiez les valeurs telles quelles. Exemple d'informations d'identification :
```
"Credentials": {
"Secret": "aA1bBB2cCCd3EEE",
"UserName": "gl-user-remote"
}
```
+ **Pour les instances Linux** : pour se connecter à une instance Linux, SSH a besoin d'un nom d'utilisateur et d'une clé privée. Amazon GameLift Serversémet des clés privées RSA et les renvoie sous forme de chaîne unique, le caractère de nouvelle ligne (`\n`) indiquant les sauts de ligne. Pour rendre la clé privée utilisable, procédez comme suit : (1) convertissez la chaîne en `.pem` fichier et (2) définissez les autorisations pour le nouveau fichier. Exemple d'informations d'identification renvoyées :
```
"Credentials": {
"Secret": "-----BEGIN RSA PRIVATE KEY-----nEXAMPLEKEYKCAQEAy7WZhaDsrA1W3mRlQtvhwyORRX8gnxgDAfRt/gx42kWXsT4rXE/b5CpSgie/\nvBoU7jLxx92pNHoFnByP+Dc21eyyz6CvjTmWA0JwfWiW5/akH7iO5dSrvC7dQkW2duV5QuUdE0QW\nZ/aNxMniGQE6XAgfwlnXVBwrerrQo+ZWQeqiUwwMkuEbLeJFLhMCvYURpUMSC1oehm449ilx9X1F\nG50TCFeOzfl8dqqCP6GzbPaIjiU19xX/azOR9V+tpUOzEL+wmXnZt3/nHPQ5xvD2OJH67km6SuPW\noPzev/D8V+x4+bHthfSjR9Y7DvQFjfBVwHXigBdtZcU2/wei8D/HYwIDAQABAoIBAGZ1kaEvnrqu\n/uler7vgIn5m7lN5LKw4hJLAIW6tUT/fzvtcHK0SkbQCQXuriHmQ2MQyJX/0kn2NfjLV/ufGxbL1\nmb5qwMGUnEpJaZD6QSSs3kICLwWUYUiGfc0uiSbmJoap/GTLU0W5Mfcv36PaBUNy5p53V6G7hXb2\nbahyWyJNfjLe4M86yd2YK3V2CmK+X/BOsShnJ36+hjrXPPWmV3N9zEmCdJjA+K15DYmhm/tJWSD9\n81oGk9TopEp7CkIfatEATyyZiVqoRq6k64iuM9JkA3OzdXzMQexXVJ1TLZVEH0E7bhlY9d8O1ozR\noQs/FiZNAx2iijCWyv0lpjE73+kCgYEA9mZtyhkHkFDpwrSM1APaL8oNAbbjwEy7Z5Mqfql+lIp1\nYkriL0DbLXlvRAH+yHPRit2hHOjtUNZh4Axv+cpg09qbUI3+43eEy24B7G/Uh+GTfbjsXsOxQx/x\np9otyVwc7hsQ5TA5PZb+mvkJ5OBEKzet9XcKwONBYELGhnEPe7cCgYEA06Vgov6YHleHui9kHuws\nayav0elc5zkxjF9nfHFJRry21R1trw2Vdpn+9g481URrpzWVOEihvm+xTtmaZlSp//lkq75XDwnU\nWA8gkn6O3QE3fq2yN98BURsAKdJfJ5RL1HvGQvTe10HLYYXpJnEkHv+Unl2ajLivWUt5pbBrKbUC\ngYBjbO+OZk0sCcpZ29sbzjYjpIddErySIyRX5gV2uNQwAjLdp9PfN295yQ+BxMBXiIycWVQiw0bH\noMo7yykABY7Ozd5wQewBQ4AdSlWSX4nGDtsiFxWiI5sKuAAeOCbTosy1s8w8fxoJ5Tz1sdoxNeGs\nArq6Wv/G16zQuAE9zK9vvwKBgF+09VI/1wJBirsDGz9whVWfFPrTkJNvJZzYt69qezxlsjgFKshy\nWBhd4xHZtmCqpBPlAymEjr/TOlbxyARmXMnIOWIAnNXMGB4KGSyl1mzSVAoQ+fqR+cJ3d0dyPl1j\njjb0Ed/NY8frlNDxAVHE8BSkdsx2f6ELEyBKJSRr9snRAoGAMrTwYneXzvTskF/S5Fyu0iOegLDa\nNWUH38v/nDCgEpIXD5Hn3qAEcju1IjmbwlvtW+nY2jVhv7UGd8MjwUTNGItdb6nsYqM2asrnF3qS\nVRkAKKKYeGjkpUfVTrW0YFjXkfcrR/V+QFL5OndHAKJXjW7a4ejJLncTzmZSpYzwApc=\n-----END RSA PRIVATE KEY-----",
"UserName": "gl-user-remote"
}
```
Lorsque vous utilisez la AWS CLI, vous pouvez générer automatiquement un `.pem` fichier en incluant les paramètres *--query* et *--output* dans votre `get-instance-access` requête.
Pour définir des autorisations sur le fichier `.pem`, exécutez la commande suivante :
```
$ chmod 400 MyPrivateKey.pem
```
1. **Ouvrez un port pour la connexion à distance.** Vous pouvez accéder aux instances des Amazon GameLift Servers flottes via n'importe quel port autorisé dans la configuration de la flotte. Vous pouvez afficher les paramètres de port de la flotte à l'aide de la commande [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-port-settings.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-port-settings.html).
La bonne pratique consiste à ouvrir des ports pour l'accès à distance uniquement lorsque vous en avez besoin et à les fermer lorsque vous avez terminé. Vous ne pouvez pas mettre à jour les paramètres du port après avoir créé une flotte, mais avant qu'elle ne soit active. Si vous êtes bloqué, recréez la flotte avec les paramètres du port ouverts.
Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html) pour ajouter un paramètre de port pour la connexion à distance (`22` pour SSH ou `3389` pour RDP, par exemple). Pour la valeur de plage d'adresses IP, spécifiez les adresses IP pour les périphériques que vous voulez utiliser pour la connexion (converties au format CIDR). Exemple :
```
$ AWS gamelift update-fleet-port-settings
--fleet-id "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
--inbound-permission-authorizations "FromPort=22,ToPort=22,IpRange=54.186.139.221/32,Protocol=TCP"
```
L'exemple suivant ouvre le port 3389 sur un parc Windows
```
$ AWS gamelift update-fleet-port-settings
--fleet-id "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
--inbound-permission-authorizations "FromPort=3389,ToPort=3389,IpRange=54.186.139.221/32,Protocol=TCP"
```
1. **Ouvrez un client de connexion à distance.** Utilisez le Bureau à distance pour Windows ou SSH pour les instances Linux. Connectez-vous à l'instance à l'aide de l'adresse IP, du paramètre de port et des informations d'identification d'accès.
Exemple SSH :
```
ssh -i MyPrivateKey.pem gl-user-remote@192.0.2.0
```
## Afficher des fichiers sur des instances distantes
Une fois connecté à une instance de flotte, vous disposez d'un accès utilisateur et administratif complet. Cela signifie que vous avez également la possibilité de provoquer des erreurs ou des échecs lors de l'hébergement de jeux. Si l'instance héberge des parties avec des joueurs actifs, vous risquez de bloquer des sessions de jeu et de perdre des joueurs, ou de perturber les processus d'arrêt du jeu, ce qui pourrait entraîner des erreurs dans les données et les journaux de jeu enregistrés.
Pour les flottes de conteneurs, après avoir accédé au conteneur (voir[Connect aux conteneurs](containers-remote-access.md)), les emplacements de fichiers suivants s'appliquent au sein du système de fichiers de conteneurs. Pour les flottes EC2, ces emplacements de fichiers s'appliquent directement à l'instance.
Recherchez les ressources suivantes sur une instance d'hébergement :
+ **Fichiers de build de jeu.** Ces fichiers sont la version du jeu dans laquelle vous l'avez téléchargéeAmazon GameLift Servers. Ils incluent un ou plusieurs exécutables, actifs et dépendances du serveur de jeu. Les fichiers de compilation du jeu se trouvent dans un répertoire racine appelé `game` :
+ Sous Windows : `c:\game`
+ Sous Linux : `/local/game`
+ **Fichiers journaux de jeu.** Trouvez les fichiers journaux générés par votre serveur de jeu dans le répertoire `game` racine, quel que soit le chemin de répertoire que vous avez indiqué.
+ **Ressources d'hébergement Amazon GameLift Servers.** Le répertoire racine `Whitewater` contient les fichiers utilisés par le Amazon GameLift Servers service pour gérer l'activité d'hébergement de jeux. Ne modifiez pas ces fichiers pour quelque raison que ce soit.
+ **Configuration d'exécution.** N'accédez pas à la configuration d'exécution pour des instances individuelles. Pour modifier une propriété de configuration d'exécution, mettez à jour la configuration d'exécution du parc (voir le fonctionnement du AWS SDK [UpdateRuntimeConfiguration](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateRuntimeConfiguration.html)ou le AWS CLI [update-runtime-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-runtime-configuration.html)).
+ **Données relatives à la flotte.** Un fichier JSON contient des informations sur le parc auquel appartient l'instance, destinées aux processus du serveur exécutés sur l'instance. Le fichier JSON se trouve à l'emplacement suivant :
+ Sous Windows : `C:\GameMetadata\gamelift-metadata.json`
+ Sous Linux : `/local/gamemetadata/gamelift-metadata.json`
+ **Certificat TLS** Si l'instance fait partie d'un parc sur lequel la génération de certificats TLS est activée, recherchez les fichiers de certificat, y compris le certificat, la chaîne de certificats, la clé privée et le certificat racine à l'emplacement suivant :
+ Sous Windows : `c:\\GameMetadata\Certificates`
+ Sous Linux : `/local/gamemetadata/certificates/`
# Connect aux conteneurs
Pour les flottes de Amazon GameLift Servers conteneurs, vous pouvez accéder aux conteneurs de serveurs de jeu exécutés sur une instance de flotte. Utilisez l'accès aux conteneurs pour résoudre les problèmes liés aux sessions de jeu, inspecter les journaux et résoudre les problèmes d'exécution.
## Connect à un conteneur
**Avant de commencer :**
Connectez-vous à l'instance de flotte. Pour obtenir des instructions, veuillez consulter [Connect aux instances de flotte](fleets-remote-access.md).
Exécutez la commande suivante pour répertorier les conteneurs en cours d'exécution sur l'instance :
```
sudo docker ps
```
Le résultat répertorie tous les conteneurs exécutés sur l'instance, y compris les conteneurs du serveur de jeu et les Amazon GameLift Servers conteneurs internes. Recherchez des conteneurs avec l'image de votre serveur de jeu pour identifier les conteneurs du serveur de jeu.
**Exemple de sortie :**
```
CONTAINER ID IMAGE COMMAND CREATED STATUS
b9676e9489f5 game-server-container "/bin/sh -c ./$GAME_…" 2 days ago Up 2 days
1d1c8443efe2 support-container "/bin/sh -c ./$SUPPO…" 2 days ago Up 2 days
```
Pour vous connecter à un conteneur de serveur de jeu, utilisez l'identifiant abrégé du conteneur indiqué dans la `CONTAINER ID` colonne. Cela vous donne un accès complet en lecture et en écriture au système de fichiers conteneur.
```
sudo docker exec -it container-short-id sh
```
## Connect à un conteneur via la console
Vous pouvez vous connecter aux conteneurs du serveur de jeu depuis la Amazon GameLift Servers console à l'aide d'Amazon EC2 Systems Manager (SSM). Cette méthode fournit un accès sécurisé sans nécessiter de configuration supplémentaire ni de gestion des informations d'identification. Vous pouvez vous connecter à un conteneur depuis l'onglet **Calculs ou depuis** l'onglet **Sessions de jeu** sur la page des détails de la flotte.
1. Dans la Amazon GameLift Servers console, choisissez **Managed containers** dans le volet de navigation, puis **Fleets.**
1. Choisissez l'identifiant de flotte qui contient le conteneur ou la session de jeu auxquels vous souhaitez accéder.
1. Sur la page des détails de la flotte, sélectionnez l'un des onglets suivants :
+ **Calculs** — Répertorie les conteneurs utilisés dans la flotte. Sélectionnez le conteneur auquel vous souhaitez vous connecter.
+ **Sessions de jeu** — Répertorie les sessions de jeu de la flotte. Sélectionnez la session de jeu pour vous connecter au conteneur qui l'héberge.
1. Choisissez **Se connecter**. Copiez la commande affichée pour vous connecter au conteneur, puis choisissez à nouveau **Connect**.
1. Dans la boîte de dialogue de connexion, choisissez **Exécuter** pour créer une nouvelle session SSM. Le système authentifie votre session via le service de gestion des AWS clés (AWS KMS) et ouvre un terminal dans votre navigateur.
1. Une fois connecté à l'instance, collez la commande docker de l'étape 4 et exécutez-la sur l'instance pour accéder au conteneur.
## Connectez-vous au conteneur hébergeant une session de jeu
Pour vous connecter au conteneur du serveur de jeu hébergeant une session de jeu spécifique, procédez comme suit.
1. **Obtenez le nom du calcul.** Appelez [describe-game-sessions](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-game-sessions.html)pour obtenir les informations `ComputeName` nécessaires à la session de jeu.
**Demande**
```
aws gamelift describe-game-sessions \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--game-session-id arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/gs-1111aaaa-2222-3333-4444-5555bbbb66cc
```
**Réponse**
```
{
"GameSessions": [
{
"GameSessionId": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/gs-1111aaaa-2222-3333-4444-5555bbbb66cc",
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
"Status": "ACTIVE",
. . .
}
]
}
```
Notez la `ComputeName` valeur de la réponse (par exemple,`62c5ff7f7a9a445d84877074c80aeafc`).
1. **Obtenez un accès au calcul et des attributs de conteneur.** Appelez [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)avec l'ID de flotte et le nom du calcul.
La réponse inclut les champs suivants :
+ `ContainerIdentifiers`— Le `ContainerName` et `ContainerRuntimeId` pour chaque contenant.
+ `GameServerContainerGroupDefinitionArn`— L'ARN de la définition du groupe de conteneurs.
+ `Credentials`— Informations d'identification temporaires pour se connecter à l'instance.
**Demande**
```
aws gamelift get-compute-access \
--fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
--compute-name 62c5ff7f7a9a445d84877074c80aeafc
```
**Réponse**
```
{
"ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
"ContainerIdentifiers": [
{
"ContainerName": "game-server",
"ContainerRuntimeId": "02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678"
}
],
"Credentials": {
"AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
"SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"SessionToken": "AQoDYXdzEJr..."
},
"FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"GameServerContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup"
}
```
1. **Connectez-vous à l’instance.** Utilisez les informations d'identification de l'étape 2 pour vous connecter à l'instance de flotte. Pour obtenir des instructions complètes, consultez [Connect aux instances de flotte](fleets-remote-access.md).
1. **Trouvez le nom du conteneur du serveur de jeu.** Appelez [describe-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-container-group-definition.html)à l'aide `GameServerContainerGroupDefinitionArn` de l'étape 2 pour identifier le nom du conteneur du serveur de jeu.
**Demande**
```
aws gamelift describe-container-group-definition \
--name arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup
```
**Réponse**
```
{
"ContainerGroupDefinition": {
"ContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2:123456789012:containergroupdefinition/MyGameServerGroup:3",
"Name": "MyGameServerGroup",
"ContainerGroupType": "GAME_SERVER",
"GameServerContainerDefinition": {
"ContainerName": "game-server",
. . .
},
. . .
}
}
```
Notez la `GameServerContainerDefinition.ContainerName` valeur (par exemple,`game-server`).
1. **Identifiez l'ID d'exécution du conteneur du serveur de jeu.** À l'aide du nom du conteneur du serveur de jeu indiqué à l'étape précédente, recherchez l'entrée correspondante dans la `get-compute-access` réponse `ContainerIdentifiers` de l'étape 2. Notez la valeur `ContainerRuntimeId`.
1. **Connect au conteneur.** Utilisez le `ContainerRuntimeId` comme ID de conteneur et exécutez la commande suivante :
```
sudo docker exec -it 02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678 sh
```