Conéctese a contenedores

En el caso de las flotas de Amazon GameLift Servers contenedores, puedes acceder a los contenedores del servidor del juego que se ejecutan en una instancia de flota. Usa el acceso a los contenedores para solucionar problemas de las sesiones de juego, inspeccionar los registros y depurar los problemas de tiempo de ejecución.

Conectarse a un contenedor

Antes de comenzar:

Conéctese a la instancia de la flota. Para obtener instrucciones, consulte Conéctese a instancias de flota.

Ejecuta el siguiente comando para ver una lista de los contenedores en ejecución en la instancia:

sudo docker ps

El resultado muestra todos los contenedores que se ejecutan en la instancia, incluidos los contenedores del servidor de juegos y Amazon GameLift Servers los contenedores internos. Busca contenedores con la imagen del servidor de juegos para identificar los contenedores del servidor de juegos.

Ejemplo de salida:

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

Para conectarte a un contenedor de servidor de juegos, usa el identificador abreviado del contenedor que aparece en la CONTAINER ID columna. Esto te da acceso completo de lectura y escritura al sistema de archivos del contenedor.

sudo docker exec -it container-short-id sh

Conectarse a un contenedor a través de la consola

Puede conectarse a los contenedores del servidor de juegos desde la Amazon GameLift Servers consola mediante Amazon EC2 Systems Manager (SSM). Este método proporciona un acceso seguro sin necesidad de configuración adicional ni administración de credenciales. Puedes conectarte a un contenedor desde la pestaña Computes o la pestaña Sesiones de juego de la página de detalles de la flota.

1. En la Amazon GameLift Servers consola, selecciona Contenedores gestionados en el panel de navegación y, a continuación, Flotas.

2. Elige el ID de flota que contiene el contenedor o la sesión de juego a la que quieres acceder.

3. En la página de detalles de la flota, selecciona una de las siguientes pestañas:

   • Calcula: muestra los contenedores que se encuentran en circulación en la flota. Seleccione el contenedor al que desee conectarse.

   • Sesiones de juego: muestra las sesiones de juego de la flota. Selecciona la sesión de juego para conectarte al contenedor que la aloja.

4. Elija Conectar. Copie el comando que se muestra para conectarse al contenedor y, a continuación, vuelva a seleccionar Conectar.

5. En el cuadro de diálogo de conexión, elija Ejecutar para crear una nueva sesión de SSM. El sistema autentica la sesión a través del Servicio de administración de AWS claves (AWS KMS) y abre una terminal en el navegador.

6. Una vez que te hayas conectado a la instancia, pega el comando docker del paso 4 y ejecútalo en la instancia para acceder al contenedor.

Conectarse al contenedor que aloja una sesión de juego

Para conectarte al contenedor del servidor de juegos que aloja una sesión de juego específica, sigue estos pasos.

1. Obtenga el nombre del recurso de computación. Llama describe-game-sessionsComputeNamepara obtener la sesión de juego.

   Solicitud

   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

   Respuesta

   {
     "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",
         . . .
       }
     ]
   }

   Anote el ComputeName valor de la respuesta (por ejemplo,62c5ff7f7a9a445d84877074c80aeafc).

2. Obtenga el acceso al cómputo y los atributos del contenedor. Llame get-compute-accesscon el identificador de la flota y el nombre del equipo.

   La respuesta incluye los siguientes campos:

   • ContainerIdentifiers— El ContainerName y ContainerRuntimeId para cada contenedor.

   • GameServerContainerGroupDefinitionArn— El ARN de la definición del grupo de contenedores.

   • Credentials— Credenciales temporales para conectarse a la instancia.

   Solicitud

   aws gamelift get-compute-access \
       --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
       --compute-name 62c5ff7f7a9a445d84877074c80aeafc

   Respuesta

   {
     "ComputeName": "62c5ff7f7a9a445d84877074c80aeafc",
     "ContainerIdentifiers": [
       {
         "ContainerName": "game-server",
         "ContainerRuntimeId": "02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678"
       }
     ],
     "Credentials": {
       "AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
       "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
       "SessionToken": "AQoDYXdzEJr...<remainder of session token>"
     },
     "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
     "GameServerContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup"
   }

3. Conéctese a la instancia. Utilice las credenciales del paso 2 para conectarse a la instancia de la flota. Para obtener instrucciones detalladas, consulte Conéctese a instancias de flota.

4. Busca el nombre del contenedor del servidor del juego. Llama describe-container-group-definitionusando el GameServerContainerGroupDefinitionArn paso 2 para identificar el nombre del contenedor del servidor del juego.

   Solicitud

   aws gamelift describe-container-group-definition \
       --name arn:aws:gamelift:us-west-2::containergroupdefinition/MyGameServerGroup

   Respuesta

   {
     "ContainerGroupDefinition": {
       "ContainerGroupDefinitionArn": "arn:aws:gamelift:us-west-2:123456789012:containergroupdefinition/MyGameServerGroup:3",
       "Name": "MyGameServerGroup",
       "ContainerGroupType": "GAME_SERVER",
       "GameServerContainerDefinition": {
         "ContainerName": "game-server",
         . . .
       },
       . . .
     }
   }

   Anote el GameServerContainerDefinition.ContainerName valor (por ejemplo,game-server).

5. Identifica el ID de tiempo de ejecución del contenedor del servidor de juegos. Con el nombre del contenedor del servidor de juegos del paso anterior, busca la entrada coincidente en la get-compute-access respuesta ContainerIdentifiers del paso 2. Anote el valor ContainerRuntimeId.

6. Conéctese al contenedor. ContainerRuntimeIdUtilícelo como identificador del contenedor y ejecute el siguiente comando:

   sudo docker exec -it 02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678 sh