Acceda de forma remota a las instanciasGameLift de flota de Amazon

Puedes acceder de forma remota a cualquier instancia que se esté ejecutando actualmente en tusGameLift flotas de Amazon. Algunas de las razones más comunes para acceder directamente a una instancia son:

• Para solucionar problemas con:

  • cómo se inician y detienen los procesos del servidor de juegos en función de la configuración del tiempo de ejecución.

  • cómo interactúa tu servidor de juegos con elGameLift servicio de Amazon.

  • problemas con la sesión del juego y la conexión del jugador.

  • problemas de relleno de emparejamiento.

• Para obtener la actividad del servidor del juego en tiempo real, por ejemplo, para realizar un seguimiento de las actualizaciones del registro.

• Ejecutar herramientas de evaluación comparativa utilizando el tráfico real de los jugadores.

• Para investigar problemas específicos relacionados con una sesión de juego o un proceso del servidor de juegos.

Al acceder de forma remota aGameLift instancias de Amazon individuales, tenga en cuenta los siguientes problemas:

• Solo se puede acceder de forma remota a las instancias de flotas activas. Si su flota no se activa, no hay forma de obtener la información de conexión de la instancia. Para obtener ayuda sobre los problemas de activación de la flota, consulteSolucionar problemas con la GameLift flota de Amazon.

• La conexión remota a una instancia no afecta a la actividad de la instancia. La instancia sigue iniciando y deteniendo los procesos del servidor, alojando sesiones de juego cuando AmazonGameLift la coloca en la instancia y puede cancelarse en cualquier momento en respuesta a un evento de reducción de escala o a una interrupción puntual.

• Cualquier cambio que realices en una instancia puede afectar a las sesiones de juego activas de la instancia y a los jugadores conectados.

Conexión a una instancia

Puede acceder a las instancias remotas que se ejecuten en Windows o Linux. Para conectarse a una instancia Windows, utilice un cliente de protocolo de escritorio remoto (RDP). Para conectarse a una instancia Linux, utilice un cliente SSH.

Utilice la AWS CLI para obtener la información que necesita para acceder a una instancia remota. Para obtener ayuda, consulte la referencia deAWS CLI comandos. También puedes usar elAWS SDK, cuya documentación está disponible en la referencia de la APIGameLift de Amazon Service.

1. Abre la GameLiftconsola de Amazon.

2. Busque el ID de la instancia a la que desea conectarse. Al solicitar acceso, deberá especificar un ID de instancia. Usa el comando deAWS CLI describe-instances (o la llamada a la API DescribeInstances) con un ID de flota para obtener información sobre todas las instancias de la flota. Para obtener ayuda, como solicitudes y respuestas de ejemplo, consulte las guías de referencia de la CLI o la API.

3. Solicite credenciales de acceso para la instancia. Cuando tengas un ID de instancia, usa el comando get-instance-access(o la llamada a la API GetInstanceAccess) para solicitar credenciales de acceso y otra información. Para obtener ayuda, como solicitudes y respuestas de ejemplo, consulte las guías de referencia de la CLI o la API. Si tiene éxito, AmazonGameLift devuelve el sistema operativo de la instancia, la dirección IP y un conjunto de credenciales (nombre de usuario y clave secreta). 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 de Windows: para conectarse a una instancia de 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. AmazonGameLift emite claves privadas RSA y las devuelve como una sola cadena, con el carácter newline (\n) que indica los saltos de línea. Para que se pueda utiliza la clave privada, (1) debe convertir la cadena en un archivo .pem y (2) establecer permisos para el archivo nuevo. 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 utilizar laAWS CLI, puede generar automáticamente un.pem archivo con el formato adecuado al incluir los parámetros --query y --output en suget-instance-access solicitud.

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

     $ chmod 400 MyPrivateKey.pem

4. Abra un puerto para la conexión remota. Solo se puede acceder a las instanciasGameLift de las flotas de Amazon a través de los puertos autorizados en la configuración de la flota. Puede ver la configuración de los puertos de la flota mediante el comando describe-fleet-port-settings.

   Recomendamos abrir los puertos para el acceso remoto solo cuando se necesiten y cerrarlos cuando haya terminado. Por ejemplo, una vez que se crea una flota, pero antes de activarla, no se puede actualizar la configuración de sus puertos. Si está atascado, vuelva a crear la flota con la configuración del puerto abierta.

   Utilice el comando update-fleet-port-settings 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"

   El siguiente ejemplo 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"

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

Consulta de archivos en instancias remotas

Al conectarse a una instancia de forma remota, dispone de acceso administrativo y de usuario pleno. Esto significa que también tendrá la capacidad de provocar errores y fallos al alojar juegos. Si la instancia aloja juegos con jugadores activos, existe el riesgo de que bloquee sesiones de juego y desconecte a jugadores, así como de interrumpir los procesos de cierre de juegos y provocar errores en los datos y los logs de juego guardados.

Los recursos de alojamiento en una instancia se encuentra en las siguientes ubicaciones:

• Archivos de compilación de juegos. Estos son los archivos incluidos en la versión del juego que subiste a AmazonGameLift. Incluyen uno o más ejecutables del servidor de juegos, activos y dependencias. Estos archivos se encuentran en un directorio raíz llamado game:

  • En Windows: c:\game

  • En Linux: /local/game

• Archivos de log de juegos. Los archivos de registro que genera el servidor de juegos se almacenan en el directorio raíz game en la ruta de directorio que haya especificado.

• Recursos deGameLift alojamiento de Amazon. Los archivos utilizados por elGameLift servicio de Amazon para administrar el alojamiento de juegos se encuentran en un directorio raíz llamadoWhitewater. Estos archivos no deben modificarse por ningún motivo.

• Configuración de tiempos de ejecución. La configuración de tiempos de ejecución de la flota no es accesible para instancias individuales. Para probar los cambios en una configuración de tiempo de ejecución (ruta de lanzamiento, parámetros de lanzamiento, número máximo de procesos simultáneos), debe actualizar la configuración del tiempo de ejecución de toda la flota (consulte la acción delAWS SDK UpdateRuntimeConfigurationo laAWS CLI update-runtime-configuration).

• Datos de flota. Los atributos de la flota a la que pertenece la instancia se almacenan en un archivo JSON. Los procesos del servidor que se ejecutan en la instancia pueden utilizar esta información. 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, los archivos de certificados, incluidos el certificado, la cadena de certificados, la clave privada y el certificado raíz, se almacenan en la siguiente ubicación:

  • En Windows: c:\\GameMetadata\Certificates

  • En Linux: /local/gamemetadata/certificates/