

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Acceda remotamente a los recursos de la flota
<a name="remote-access-intro"></a>

Puede conectarse a cualquier instancia de su EC2 Amazon GameLift Servers gestionado activo o de sus flotas de contenedores gestionadas. En el caso de las flotas de contenedores, también puedes conectarte a contenedores individuales que se estén ejecutando en una instancia para solucionar problemas relacionados con las sesiones de juego, inspeccionar los registros y depurar los problemas de tiempo de ejecución. Estas son algunas de las razones más habituales para acceder de forma remota a una instancia:
+ Solucionar problemas con la integración del servidor de juegos.
+ Afinar la configuración del tiempo de ejecución y otros ajustes específicos de la flota.
+ Supervisa la actividad del servidor de juegos en tiempo real, como el seguimiento de los registros.
+ Ejecutar herramientas de evaluación comparativa mediante el tráfico real de jugadores.
+ Investigar problemas específicos relacionados con una sesión de juego o un proceso del servidor.

Cuando te conectes a una instancia, ten en cuenta lo siguiente:
+ Puede conectarse a cualquier instancia de una flota activa. Por lo general, no puede conectarse a flotas inactivas, como las que están en el proceso de activación o las que tienen un estado de error (es posible que estas flotas tengan una disponibilidad limitada durante un corto período de tiempo). Si necesita ayuda en relación con los problemas de activación de la flota, consulte [Depuración de problemas relacionados con flotas de Amazon GameLift Servers](fleets-creating-debug.md).
+ La conexión a una instancia activa no afecta a la actividad de alojamiento de la instancia. La instancia sigue iniciando y deteniendo los procesos del servidor en función de la configuración del tiempo de ejecución. Activa y ejecuta sesiones de juego. Es posible que la instancia se cierre en respuesta a un evento de reducción vertical o de otro tipo.
+ Los cambios que haga en los archivos o la configuración de una instancia pueden afectar a las sesiones de juego activas de la instancia y a los jugadores conectados.

# Conéctese a instancias de flota
<a name="fleets-remote-access"></a>

Puede conectarse de forma remota a cualquier instancia de EC2 Amazon GameLift Servers gestionada activa o de una flota de contenedores gestionada para solucionar problemas con el servidor del juego, inspeccionar los registros y depurar el comportamiento del tiempo de ejecución. Connect mediante la Amazon GameLift Servers consola o la AWS CLI.

## Acceso remoto a través de la consola
<a name="fleets-remote-access-console"></a>

Puede conectarse a instancias de la flota directamente desde la consola de Amazon GameLift Servers mediante Amazon EC2 Systems Manager (SSM). Este método proporciona un acceso seguro sin necesidad de configuración adicional ni administración de credenciales. En el caso de las flotas de contenedores, después de conectarse a la instancia, puede acceder a los contenedores individuales que se ejecutan en ella. Para obtener más información, consulte [Conéctese a contenedores](containers-remote-access.md).

1. En la consola de Amazon GameLift Servers, elija **EC2 administrado** o **Contenedores administrados** en el panel de navegación, seguido de **Flotas**.

1. Elija el ID de la flota que contiene la instancia a la que desea acceder.

1. En la página de detalles de la flota, seleccione la pestaña **Instancias** para ver todas las instancias de computación de la flota.

1. Seleccione la instancia a la que desea conectarse y, a continuación, elija **Conectar**. Esto abre el cuadro de diálogo Conectar a la instancia, que le informa de los detalles de la conexión y le permite ver el script que se utilizará para conectarse a la instancia. Para confirmar, seleccione **Conectar** nuevamente.

1. 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.

**nota**  
El acceso remoto basado en consola está disponible para las flotas que ejecutan el SDK del servidor versión 5.x. Para las flotas que ejecutan versiones anteriores del SDK, utilice el método AWS CLI que se describe en la siguiente sección.

## Acceso remoto con la AWS CLI
<a name="fleets-remote-access-cli"></a>

Las siguientes instrucciones describen cómo conectarse de forma remota a una instancia mediante la interfaz de la línea de comandos (CLI) de AWS . También puede realizar llamadas programáticas mediante el AWS SDK, tal y como se documenta en la [referencia de la API de servicio correspondiente Amazon GameLift Servers](https://docs.aws.amazon.com/gamelift/latest/apireference/) a.

### Recopilación de datos de instancias
<a name="fleets-remote-access-getinfo"></a>

Para conectarse a una instancia de flota de EC2 administrada por Amazon GameLift Servers, necesita la siguiente información: 
+ El ID de la instancia a la que desea conectarse. Puede utilizar el ARN o el ID de la instancia.
+ La versión del SDK del servidor de Amazon GameLift Servers que se utiliza en la instancia. El SDK del servidor está integrado con la compilación del juego que se ejecuta en la instancia. 

Las siguientes instrucciones describen cómo completar estas tareas mediante la AWS CLI. Debe conocer el ID de la flota de la instancia a la que desea conectarse.

1. **Obtenga el nombre del recurso de computación.** Obtenga una lista de todos los recursos de computación activos de la flota. Llame a [list-compute](https://docs.aws.amazon.com/cli/latest/reference/gamelift/list-compute.html) con el ARN o ID de una flota. Si se trata de una flota de una sola ubicación, especifique únicamente el identificador de la flota. Si es una flota con múltiples ubicaciones, especifique el identificador de la flota y una ubicación. En el caso de las flotas de EC2 administradas, `list-compute` devuelve una lista de instancias de flota y la propiedad `ComputeName` es el ID de la instancia. Busque el recurso de computación al que desea acceder. 

   **Solicitud**

   ```
   aws gamelift list-compute \
     --fleet-id  fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \
     --location sa-east-1
   ```

   **Respuesta**

   ```
   {
     "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. **Busque la versión del SDK del servidor.** Para obtener esta información, debe buscar la compilación implementada en la flota. La versión del SDK del servidor es una propiedad de compilación.

   1. Llame [describe-fleet-attributes](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-attributes.html)con un identificador de flota o un ARN para obtener el identificador de construcción y el ARN de la flota.

   1. Llame a [describe-build](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html) con el ARN o el ID de la compilación para obtener la versión del SDK del servidor de compilación. 

      Por ejemplo:

      **Solicitud**

   ```
   aws gamelift describe-fleet-attributes \
     --fleet-ids  fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
   ```

   **Respuesta**

   ```
   {
     "FleetAttributes": [
       {
         "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
         "ComputeType": "EC2",
         "BuildId": "build-3333cccc-44dd-55ee-66ff-00001111aa22",
         . . .
       }
     ]
   }
   ```

   **Solicitud**

   ```
   aws gamelift describe-build \
     --build-id build-3333cccc-44dd-55ee-66ff-00001111aa22
   ```

   **Respuesta**

   ```
   "Build": {
     "BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
     "Name": "My_Game_Server_Build_One",
     "OperatingSystem": "AMAZON_LINUX_2023",
     "ServerSdkVersion": "5.1.1",
     . . .
   }
   ```

## Conexión a una instancia (SDK 5 de servidor)
<a name="fleets-remote-access-connect-5"></a>

Si la instancia a la que quiere conectarse ejecuta una compilación de juego con la versión 5.x del SDK del servidor, conéctese a la instancia mediante Amazon EC2 Systems Manager (SSM). Puede acceder a las instancias remotas que se ejecuten en Windows o Linux. En el caso de las flotas de contenedores, tras conectarse a la instancia, podrá acceder a los contenedores individuales que se estén ejecutando en ella. Para obtener más información, consulte [Conéctese a contenedores](containers-remote-access.md).

**Antes de comenzar:**  
Complete los pasos de configuración de SSM e instale el complemento de SSM en el equipo local. Para obtener más información, consulte [Configuración de SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-getting-started.html) e [instalación del complemento Session Manager para la AWS CLI en la](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) Guía del usuario de *Amazon EC2 Systems Manager*.

1. **Solicite credenciales de acceso para la instancia.** Llame [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)con el ID de flota y el nombre de procesamiento de la instancia a la que desee conectarse. Amazon GameLift Serversdevuelve un conjunto de credenciales temporales para acceder a la instancia. Por ejemplo: 

   **Solicitud**

   ```
   aws gamelift get-compute-access \
   --compute-name i-11111111a222b333c \
   --fleet-id fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa
   --region us-west-2
   ```

   **Respuesta**

   ```
   {
     "ComputeName": "i-11111111a222b333c",
     "Credentials": {
       "AccessKeyId": "ASIAIOSFODNN7EXAMPLE",
       "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
       "SessionToken": "AQoDYXdzEJr...<remainder of session token>"
     },
     "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
     "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa"
   }
   ```

1. **Exporte las credenciales de acceso (opcional).** Puede exportar las credenciales a variables de entorno y utilizarlas para configurar la AWS CLI para el usuario predeterminado. Para obtener más información, consulte [Variables de entorno para configurar la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) en la Guía del AWS Command Line Interface usuario.

   ```
   export AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
   export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   export AWS_SESSION_TOKEN=AQoDYXdzEJr...<remainder of session token>
   ```

1. **Conéctese a la instancia de la flota.** Inicie una sesión de SSM con la instancia a la que desea conectarse. Incluya la AWS región o la ubicación de la instancia. Para obtener más información, incluido cómo configurar SSM y el complemento SSM, consulte [Iniciar una sesión (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html#sessions-start-cli) en la Guía del usuario de *Amazon EC2 Systems Manager*. 

   La solicitud start-session utilizará automáticamente las credenciales que haya obtenido en el paso 1. 

   ```
   aws ssm start-session \
   --target i-11111111a222b333c \
   --region us-west-2 \
   ```
**nota**  
Si recibe un error de acceso denegado, es posible que tenga una variable de `AWS_PROFILE` entorno configurada en un AWS perfil, lo que provoca que la AWS CLI utilice credenciales incorrectas para el acceso remoto. Para resolver este problema, desactive temporalmente la variable de entorno `AWS_PROFILE`. Como alternativa, puede crear un AWS perfil personalizado para sus credenciales de acceso remoto y añadir el parámetro de línea de `--profile` comandos a su `start-session` solicitud. 

## Conexión a una instancia (SDK 4.x, o anterior, de servidor)
<a name="fleets-remote-access-connect"></a>

Si la instancia a la que quiere conectarse ejecuta una compilación de juego con la versión 4, o anterior, del SDK del servidor, observe las siguientes instrucciones. Puede conectarse a instancias que se ejecuten en Windows o Linux. Para conectarse a una instancia de Windows, utilice un cliente de protocolo de escritorio remoto (RDP). Para conectarse a una instancia de Linux, utilice un cliente SSH. 

1. **Solicite credenciales de acceso para la instancia.** Cuando tengas un ID de instancia, usa el comando [get-instance-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-instance-access.html)para solicitar las credenciales de acceso. Si funciona correctamente, Amazon GameLift Servers devuelve el sistema operativo, la dirección IP y un conjunto de credenciales (nombre de usuario y clave secreta) de la instancia. El formato de las credenciales depende del sistema operativo de la instancia. Siga las siguientes instrucciones para recuperar las credenciales para RDP o SSH. 
   + **Para instancias Windows**: para conectarse a una instancia Windows, RDP requiere un nombre de usuario y una contraseña. La solicitud `get-instance-access` devuelve estos valores en forma de cadenas simples, por lo que puede utilizar los valores devueltos tal cual. Credenciales de ejemplo: 

     ```
     "Credentials": {
         "Secret": "aA1bBB2cCCd3EEE",
         "UserName": "gl-user-remote"
     }
     ```
   + **Para instancias de Linux**: para conectarse a una instancia de Linux, SSH requiere un nombre de usuario y una clave privada. Amazon GameLift Servers emite claves privadas RSA y las devuelve en forma de una única cadena, con el carácter de nueva línea (`\n`) para marcar los saltos de línea. Para poder usar la clave privada, (1) convierta la cadena en un archivo `.pem` y (2) establezca los permisos para el nuevo archivo. Credenciales de ejemplo devueltas: 

     ```
     "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"
     }
     ```

     Al usar la AWS CLI, puede generar automáticamente un `.pem` archivo al incluir los parámetros *--query* y *--output* en su `get-instance-access` solicitud. 

     Para establecer permisos en el nuevo archivo `.pem`, ejecute el siguiente comando:

     ```
     $ chmod 400 MyPrivateKey.pem
     ```

1. **Abra un puerto para la conexión remota.** Puede acceder a las instancias en flotas de Amazon GameLift Servers mediante cualquier puerto autorizado en la configuración de la flota. Puede ver la configuración de los puertos de la flota mediante el comando [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). 

   Recomendamos abrir los puertos para el acceso remoto solo cuando se necesiten y cerrarlos cuando haya terminado. No puede actualizar la configuración de los puertos después de crear una flota y antes de que esté activa. Si no puede continuar, vuelva a crear la flota con la configuración de puertos abierta.

   Utilice el comando [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) para añadir una configuración de puerto para la conexión remota (como `22` para SSH o `3389` para RDP). Para el valor del rango de IP, especifique las direcciones IP de los dispositivos que desea utilizar para conectarse (convertidos al formato CIDR). Ejemplo: 

   ```
   $ 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"
   ```

   En el siguiente ejemplo se abre el puerto 3389 en una flota de 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. **Abra un cliente de conexión remoto.** Utilice el escritorio remoto para Windows o SSH para instancias Linux. Conéctese a la instancia a través de la dirección IP, la configuración del puerto y las credenciales de acceso.

   Ejemplo de SSH: 

   ```
   ssh -i MyPrivateKey.pem gl-user-remote@192.0.2.0
   ```

## Visualización de archivos en instancias remotas
<a name="fleets-remote-access-permissions"></a>

Una vez conectado a una instancia de flota, tiene pleno acceso administrativo y de usuario. Esto significa que también tendrá la capacidad de provocar errores y fallos al alojar juegos. Si la instancia aloja juegos con jugadores activos, podrías correr el riesgo de bloquear las sesiones de juego y perder jugadores, o de interrumpir los procesos de cierre de los juegos, lo que podría provocar errores en los datos y registros guardados.

En el caso de las flotas de contenedores, tras acceder al contenedor (consulte[Conéctese a contenedores](containers-remote-access.md)), se aplicarán las siguientes ubicaciones de archivos dentro del sistema de archivos del contenedor. En el caso de las flotas de EC2, estas ubicaciones de archivos se aplican directamente a la instancia.

Busque los siguientes recursos en una instancia de alojamiento:
+ **Archivos de compilación de juegos.** Estos archivos son la compilación del juego que ha cargado en Amazon GameLift Servers. Incluyen uno o más ejecutables, activos y dependencias del servidor de juegos. Los archivos de la compilación del juego se encuentran en un directorio raíz llamado `game`: 
  + En Windows: `c:\game`
  + En Linux: `/local/game`
+ **Archivos de log de juegos.** Busque los archivos de registro generados por el servidor de juegos en el directorio raíz `game`, en la ruta de directorio que haya especificado.
+ **Recursos de alojamiento de Amazon GameLift Servers.** El directorio raíz `Whitewater` contiene archivos usados por el servicio de Amazon GameLift Servers para administrar la actividad de alojamiento de juegos. No modifique estos archivos bajo ningún concepto. 
+ **Configuración de tiempos de ejecución.** No acceda a la configuración de tiempo de ejecución para instancias individuales. Para realizar cambios en una propiedad de configuración en tiempo de ejecución, actualice la configuración en tiempo de ejecución de la flota (consulte la operación del AWS SDK [UpdateRuntimeConfiguration](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateRuntimeConfiguration.html)o la AWS CLI [update-runtime-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-runtime-configuration.html)).
+ **Datos de la flota.** Un archivo JSON contiene información sobre la flota a la que pertenece la instancia, para que la usen los procesos del servidor que se ejecutan en la instancia. El archivo JSON se almacena en la siguiente ubicación:
  + En Windows: `C:\GameMetadata\gamelift-metadata.json`
  + En Linux: `/local/gamemetadata/gamelift-metadata.json`
+ **Certificados TLS.** Si la instancia está en una flota que tiene habilitada la generación de certificados TLS, busque los archivos de certificados, como el certificado, la cadena de certificados, la clave privada y el certificado raíz, en la siguiente ubicación:
  + En Windows: `c:\\GameMetadata\Certificates`
  + En Linux: `/local/gamemetadata/certificates/`

# Conéctese a contenedores
<a name="containers-remote-access"></a>

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
<a name="containers-remote-access-connect"></a>

**Antes de comenzar:**  
Conéctese a la instancia de la flota. Para obtener instrucciones, consulte [Conéctese a instancias de flota](fleets-remote-access.md).

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
<a name="containers-remote-access-console"></a>

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**.

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

1. 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.

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

1. 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.

1. 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
<a name="containers-remote-access-game-session"></a>

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-sessions](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-game-sessions.html)`ComputeName`para 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`).

1. **Obtenga el acceso al cómputo y los atributos del contenedor.** Llame [get-compute-access](https://docs.aws.amazon.com/cli/latest/reference/gamelift/get-compute-access.html)con 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"
   }
   ```

1. **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](fleets-remote-access.md).

1. **Busca el nombre del contenedor del servidor del juego.** Llama [describe-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-container-group-definition.html)usando 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`).

1. **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`.

1. **Conéctese al contenedor.** `ContainerRuntimeId`Utilícelo como identificador del contenedor y ejecute el siguiente comando:

   ```
   sudo docker exec -it 02accb92cd9bef3373300e7151d5c2b3dcca3b06eff1bb4e345085fc008d4678 sh
   ```