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.

Tutorial: Incorporación rápida con el envoltorio Amazon GameLift Servers

Bienvenido al tutorial de incorporación deAmazon GameLift Servers. En este tutorial, implementarás rápidamente tu servidor de juegos para que se aloje en una flota de recursos informáticos basados en la nube. Usa este tutorial para evitar la tarea de integrar el SDK del servidor Amazon GameLift Servers en el código del juego y, en su lugar, despliégalo con la funcionalidad mínima necesaria para comunicarse con el Amazon GameLift Servers servicio y ejecutar sesiones de juego. Configurarás una solución de alojamiento básica y la utilizarás para disfrutar de toda la gama de funciones, como el escalado automático y el emparejamiento. También es una forma estupenda de alojar un prototipo de tu juego como parte de una demostración en directo o para probarlo.

Principales ventajas de este método de incorporación:

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

Descripción general

En este tutorial podrás:

Paso 1: Obtén y crea el contenedor de servidores de juegos

Usa los siguientes comandos para obtener la fuente del contenedor del servidor de juegos y compilarlo. Estos comandos usan SSH, pero también puedes ir directamente al repositorio de Github.

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac y Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

Si la compilación se realiza correctamente, se añade un directorio «out» aamazon-gamelift-servers-game-server-wrapper. En este directorio hay tres carpetas, una para cada opción de flota de alojamiento compatible, que contienen un conjunto de artefactos de compilación. Para este tutorial, va a realizar la implementación en EC2 flotas gestionadas, por lo que utilizará la carpetagamelift-servers-managed-ec2.

Paso 2: Prepara la versión de tu servidor de juegos

En este paso, preparas los archivos de compilación de tu servidor de juegos para cargarlos enAmazon GameLift Servers.

Crea el directorio del juego

Ahora, prepara un directorio de juegos en tu máquina local. Este directorio debe contener todos los archivos que necesitas para ejecutar tu servidor de juegosAmazon GameLift Servers. Esto incluye el contenedor del servidor de juegos, la versión de tu servidor de juegos y el archivo config.yaml que hace que el contenedor funcione con tu servidor de juegos.

Utilice los siguientes pasos:

Un ejemplo de estructura de directorios se verá así:

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

Paso 3: Configure el contenedor para su flota

Amazon GameLift Serversgestiona el ciclo de vida de las instancias informáticas de una flota, activando nuevas instancias con la versión de servidor instalada y reciclando las instancias según sea necesario. El servicio gestiona el ciclo de vida de los procesos del servidor de juegos que se ejecuta en cada instancia. Una EC2 flota gestionada puede tener instancias en varias ubicaciones para ayudar a los jugadores estén donde estén.

Edite el archivo config.yaml para configurar el contenedor para el registro, la configuración de los puertos y la inicialización del servidor.

Ejemplo de configuración:

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

Paso 4: Sube la versión del servidor del juego

Ya has completado todos los elementos necesarios de la compilación del servidor de juegos (el contenedor del servidor de juegos, config.yaml y los archivos del servidor de juegos) y estás listo para cargar la compilación de tu juego para alojarla. Amazon GameLift Servers La forma más rápida de cargar la versión del juego es mediante el AWS CLI comando que se muestra en el upload-build siguiente ejemplo.

Cargar una versión de juego con Windows:

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2016 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

Al crear la compilación, registre el ID de compilación de la respuesta de la API para usarlo en la creación de la flota.

Paso 5: Crea la EC2 flota gestionada

Los siguientes pasos describen una configuración mínima de la flota, para que pueda empezar a funcionar lo antes posible.

Para crear tu flota:

Paso 6: Crea una sesión de juego y conéctate a ella

Si el estado de tu flota es Activa, significa que los servidores del juego están listos para albergar una sesión de juego. Para iniciar una sesión de juego, realiza una solicitud de sesión de juego al Amazon GameLift Servers servicio. Aquí, utilizarás el AWS CLI para realizar esta solicitud.

Usa lo siguiente para crear una sesión de juego:

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

También puedes pasar las propiedades personalizadas del juego al ejecutable de tu servidor. Consulta los argumentos del servidor de juegos en el archivo README para obtener más información. Cuando reciba la create-game-session llamada, dígale Amazon GameLift Servers al contenedor que inicie el ejecutable del servidor de juegos e inicie una sesión de juego. Lo que hay en él config.yaml afecta a la configuración del servidor del juego, y los parámetros de inicio establecidos en la consola determinan la configuración de la sesión de juego en sí.

Ejemplo de formato para añadir propiedades del juego:

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

Paso 7: Gestiona y monitorea tu flota

Ahora que tu flota de servidores de juegos está configurada y ha empezado una sesión de juego, puedes gestionarla y monitorizarla desde la Amazon GameLift Servers consola. La mejor forma de hacerlo es desde la página de detalles de la flota, donde puedes editar los detalles de la flota o cambiar la escala y la capacidad de la flota en la pestaña Escalamiento. Consulta la siguiente sección sobre cómo escalar los servidores de tus juegos.

Selecciona la pestaña Métricas para ver los gráficos que muestran la supervisión de las métricas de actividad y hardware. Para obtener más información sobre los gráficos de métricas, selecciona el enlace Información situado junto al identificador de tu flota. Además, aunque puedes supervisar de cerca tus servidores de juegos desde la pestaña Métricas, también puedes añadir alarmas a estas métricas en el CloudWatch panel de control.

Para navegar hasta el CloudWatch panel de control desde la consola, sigue estos pasos:

Paso 8: Escala tus servidores de juegos

Para el siguiente paso, debe configurar el escalado automático. Con el escalado automático, escala dinámicamente la capacidad de su flota en respuesta a la actividad del servidor del juego. A medida que los jugadores llegan e inician las sesiones de juego, el escalado automático agrega más instancias y, a medida que disminuye la demanda de los jugadores, el escalado automático libera las instancias no utilizadas. Esta es una forma eficaz de minimizar los recursos y los costes de alojamiento y, al mismo tiempo, ofrecer una experiencia de juego rápida y fluida.

Mientras te preparas para el lanzamiento del juego, querrás configurar el escalado automático para tus flotas. Se recomienda el escalado automático como una forma eficaz de minimizar los recursos y los costes de alojamiento y, al mismo tiempo, ofrecer una experiencia de juego rápida y fluida.

Para configurar manualmente la capacidad de la flota

Para configurar manualmente la capacidad de la flota

Para usar el escalado automático basado en objetivos

Para usar el escalado automático basado en objetivos

El escalado automático basado en objetivos (seguimiento de objetivos) vincula el escalado de la flota con el porcentaje de sesiones de juego disponibles. A medida que los jugadores se lanzan a jugar a tu juego y disminuyen las sesiones de juego disponibles, la aplicación responde añadiendo automáticamente más instancias a la flota.

El escalado automático basado en reglas le brinda un control más detallado, como la capacidad de vincular el escalado con otras métricas de la flota y establecer umbrales personalizados y respuestas de escalado. Ofrece opciones potentes, pero también requiere el uso de la CLI y pruebas importantes para comprender cómo se comportan las reglas personalizadas en acción. Este tutorial se centra primero en configurar el enfoque basado en objetivos.

Solución de problemas comunes

Los siguientes son problemas comunes que pueden surgir al ejecutar los servidores y las sesiones de juego. Si el servidor o la sesión de juego no funcionan correctamente, el primer paso consiste en comprobar los registros, ya que pueden revelar alguno de los problemas que se describen a continuación en relación con nuevas implementaciones o juegos en producción.

En los registros suele aparecer lo siguiente:

Para ver los registros de eventos de su Amazon GameLift Servers flota

Para ver los registros de eventos de su Amazon GameLift Servers flota

Para ver los registros de las sesiones de juego

Para ver los registros de las sesiones del juego

Para ver los registros de las sesiones del juego con la CLI, usa la GetGameSessionLogURL API. Amazon GameLift Serversalmacena automáticamente los registros durante 14 días.

También puedes configurar CloudWatch los registros de Amazon para tu flota. Esto proporciona capacidades de registro adicionales e integración con otros servicios AWS de monitoreo.

Para acceder a los registros en tiempo real o prolongar los períodos de retención mediante CloudWatch:

Pasos a seguir a continuación