Crea un Amazon GameLift Anywhere flota - Amazon GameLift

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.

Crea un Amazon GameLift Anywhere flota

En este tema se describe cómo crear un Amazon GameLift Anywhere flota. Con una flota de Anywhere, puedes usar las funciones principales de administración de sesiones de GameLift juegos de Amazon y, al mismo tiempo, organizar sesiones de juego con tus propios recursos informáticos. Crea una flota de Anywhere para tu hardware local u otros recursos basados en la nube.

Las flotas de Anywhere se utilizan habitualmente junto con las flotas GameLift gestionadas por Amazon en una solución de alojamiento híbrida. También proporcionan entornos de prueba útiles a la hora de desarrollar un juego para alojarlo en Amazon GameLift. Consulta estos temas para obtener más información sobre cuándo y cómo incorporar Amazon GameLift Anywhere flotas en una solución de alojamiento de juegos:

Como las flotas de Anywhere se autogestionan, configurar una flota requiere un poco de trabajo adicional. Para que una flota de Anywhere esté lista para albergar sesiones de juego y jugadores, debes completar las siguientes tareas:

Antes de comenzar

Antes de crear una flota de Anywhere, realiza las siguientes tareas. Para obtener una guía más detallada, consulte la Hoja de ruta de desarrollo para el alojamiento con Amazon Anywhere GameLift oHoja de ruta de desarrollo para el alojamiento híbrido con Amazon GameLift.

  • Integra el código de tu servidor de juegos con la SDK versión 5.x (o superior) GameLift del servidor de Amazon. No necesitas completar todas las tareas de integración del juego, solo las necesarias para crear un servidor de juegos. Una práctica habitual es configurar tu máquina local como una flota de Anywhere y utilizar una interfaz de línea de comandos para probar la integración del servidor de juegos (consultaConfigura las pruebas locales con Amazon GameLift Anywhere). Puedes incorporar componentes adicionales (como un cliente de juego GameLift compatible con Amazon) a medida que los vayas desarrollando.

  • Package su software de servidor de juegos para instalarlo en los ordenadores de su flota Anywhere. El paquete debe incluir la versión integrada del servidor de juegos y todo el software de soporte necesario para ejecutar el servidor de juegos.

  • Decide si quieres usar Amazon GameLift Agent con tu flota de Anywhere. El agente es una herramienta de gestión de procesos informática que automatiza algunas de las tareas clave relacionadas con la gestión de los procesos y los cálculos del servidor para su uso con Amazon. GameLift Para obtener más información, consulte Trabaja con el GameLift agente de Amazon.

Creación de una ubicación personalizada

Cree una ubicación personalizada para representar la ubicación física de sus recursos informáticos. Al crear una flota de Anywhere, debe tener al menos una ubicación personalizada ya definida. Puedes crear ubicaciones personalizadas adicionales y añadirlas a una flota existente en cualquier momento.

Para crear una ubicación personalizada

Usa la GameLift consola de Amazon o AWS Command Line Interface (AWS CLI) para crear una ubicación personalizada.

Console

En la GameLift consola de Amazon, usa el panel de navegación para abrir la página Ubicaciones. Selecciona Crear ubicación para abrir el cuadro de diálogo Crear.

  1. En el cuadro de diálogo, introduzca un nombre de ubicación. Como práctica recomendada, utilice un nombre que describa una ubicación significativa para un conjunto de recursos informáticos. Pueden ser ubicaciones geográficas, el nombre de un centro de datos u otro identificador de ubicación. Amazon GameLift añade custom - al nombre de tu ubicación personalizada.

  2. (Opcional) Añade etiquetas a tu ubicación personalizada. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Asigne etiquetas a AWS los recursos que desee clasificar de forma útil, por ejemplo, por propósito, propietario o entorno. Para cada etiqueta que desee añadir, elija Añadir etiqueta nueva.

  3. Seleccione Crear.

AWS CLI

Cree una ubicación personalizada mediante el comando create-location. Proporcione un location-name valor, que debe empezar custom- por. Como práctica recomendada, utilice un nombre que describa una ubicación significativa para un conjunto de recursos informáticos. Pueden ser ubicaciones geográficas, el nombre de un centro de datos u otro identificador de ubicación.

aws gamelift create-location \ --location-name custom-location-1

Salida

{ "Location": { "LocationName": "custom-location-1", "LocationArn": "arn:aws:gamelift:us-east-1:111122223333:location/custom-location-1" } }

Cree una flota en cualquier lugar

Cree una flota en cualquier lugar para un conjunto de recursos informáticos de su propiedad. Una nueva flota de Anywhere comienza vacía; para añadir cálculos a la flota, basta con registrarlos.

Al crearla, una nueva Anywhere la flota se mueve rápidamente por los estados de la flota de NEW aACTIVE. Puede añadir cálculos a la flota una vez que llegue. ACTIVE

Para crear una flota de Anywhere

Usa la GameLift consola Amazon o AWS Command Line Interface (AWS CLI) para crear una flota de Anywhere.

Console

En la GameLift consola de Amazon, usa el panel de navegación para abrir la página Flotas. Selecciona Crear flota para iniciar el flujo de trabajo de creación de flotas.

Paso 1: Elija el tipo de cómputo

Seleccione la opción en cualquier lugar y elija Siguiente.

Paso 2: Defina los detalles de la flota

En este paso, especifique algunos ajustes clave para toda la flota.

  1. Rellene la sección de detalles de la flota:

    1. Introduce un nombre de flota. Recomendamos utilizar un patrón de nomenclatura de flota que facilite la identificación de los tipos de flota al consultar las listas de flotas.

    2. Proporcione una breve descripción de la flota.

  2. Establezca estos detalles adicionales opcionales según sea necesario. Puedes actualizar la configuración de la flota más adelante.

    1. Al crear una flota para pruebas de producción o previas a la producción, usa esta configuración para especificar un valor de coste por hora para los cálculos de la flota. Amazon GameLift puede utilizar esta información durante el proceso de colocación de la sesión de juego para seleccionar los recursos de alojamiento en función del coste.

    2. Si quieres combinar los datos de las métricas de esta flota y de otras, especifica un nombre de grupo métrico. Utilice el mismo nombre de grupo métrico para todas las flotas que desee combinar. Consulte las métricas del grupo de métricas para ver los datos agregados.

  3. Agrega etiquetas opcionales a tu ubicación personalizada. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Asigne etiquetas a AWS los recursos que desee clasificar de maneras útiles, como por propósito, propietario o entorno. Para cada etiqueta que desee añadir, elija Añadir etiqueta nueva.

  4. Seleccione Siguiente para continuar con el flujo de trabajo.

Paso 3: Seleccione ubicaciones personalizadas

En este paso, identifique la ubicación física de los ordenadores que planea añadir a esta flota. Ahora puede especificar una o más ubicaciones y añadir o eliminar ubicaciones más adelante, según sea necesario.

  1. En Ubicaciones personalizadas, selecciona una o más ubicaciones para los cálculos de la flota. La lista incluye todas las ubicaciones personalizadas que se han definido en las ubicaciones seleccionadas Región de AWS actualmente. Para definir una nueva ubicación personalizada que desee añadir a la flota, elija Crear ubicación.

  2. Seleccione Siguiente para continuar con el flujo de trabajo.

Paso 4: Revisa y crea

Revisa tu configuración antes de crear la flota.

Cuando esté listo para desplegar la nueva flota, elija Crear. Amazon comienza GameLift inmediatamente el proceso de activación de la flota, asignando un identificador único y poniendo la flota en NEW estado. Puedes hacer un seguimiento del progreso de la flota en la página de Flotas.

AWS CLI

Utilice el create-fleetcomando para crear una flota de tipo ANYWHERE informático. Proporcione un nombre y al menos una ubicación personalizada. Amazon GameLift crea el recurso de flota Anywhere con tu configuración predeterminada actual Región de AWS (o puedes añadir una etiqueta --region para especificar una diferente Región de AWS).

El siguiente ejemplo de solicitud crea una nueva flota con la configuración mínima requerida. Sustituya FleetName y custom-location con su propia información.

aws gamelift create-fleet \ --name FleetName \ --compute-type ANYWHERE \ --locations "Location=custom-location"

Ejemplo de respuesta

{ "FleetAttributes": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Name": "HardwareAnywhere", "CreationTime": "2023-02-23T17:57:42.293000+00:00", "Status": "ACTIVE", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "DISABLED" }, "ComputeType": "ANYWHERE" } }

Al crearla, una nueva Anywhere la flota pasa rápidamente al estado de flotaACTIVE. Puede añadir cálculos a la flota una vez que llegueACTIVE.

Ten en cuenta que la respuesta no incluye las ubicaciones de la flota. Puede obtener todos los detalles de la flota llamando a describe-fleet-attributesy describe-fleet-location-attributes.

Agregue un cómputo a la flota

Para añadir un recurso informático a una flota y prepararla para albergar sesiones de juego, lleve a cabo las siguientes tareas:

  • Registra el cómputo en la flota. El registro indica a Amazon GameLift qué recursos de alojamiento físico forman parte de la flota.

  • Solicita un token de autenticación para el proceso. Cada servidor de juegos que se ejecuta en el ordenador necesita este token para conectarse al GameLift servicio de Amazon. Los tokens de autenticación son temporales y deben actualizarse periódicamente.

nota

Si vas a implementar el software de tu servidor de juegos con Amazon GameLift Agent, puedes saltarte este paso. El agente registra automáticamente cada proceso y mantiene un token de autenticación válido para el proceso. Consulte Trabaja con el GameLift agente de Amazon.

Puede registrar un proceso y solicitar un token de autenticación mediante AWS CLI o realizando llamadas programáticas a AWS SDK Amazon GameLift. Estas acciones no están disponibles a través de la GameLift consola de Amazon.

Como práctica recomendada, recomendamos automatizar estas dos tareas añadiendo un script de inicio a cada proceso. El script de inicio llama automáticamente a los get-compute-auth-token comandos register-compute y. También puede automatizar las tareas para actualizar periódicamente el token de autenticación durante toda la vida útil del proceso y anular el registro del proceso al apagarlo.

Cada una de las acciones de inicio devuelve valores específicos del proceso que debes almacenar en él. Cuando se inicia un proceso de servidor de juegos en el ordenador, debe pasar estos valores como parámetros del servidor al inicializar una conexión con el GameLift servicio de Amazon (consulta ServerParameters la SDK referencia del servidor). Te recomendamos que establezcas estos valores informáticos específicos (o sus ubicaciones almacenadas) como variables de entorno. Si utilizas Amazon GameLift Agent, esta tarea se realiza por ti. Los valores específicos del cálculo son los siguientes:

  • register-computedevuelve un valor para. GameLiftServiceSdkEndpoint Establezca este valor en el parámetro webSocketUrl del servidor.

  • compute-auth-tokendevuelve el token de autenticación. Establezca este valor en el parámetro authToken del servidor.

AWS CLI

Las siguientes instrucciones describen cómo enviar manualmente cada solicitud mediante el AWS CLI.

Para registrar un ordenador

Llame register-computepara registrar un ordenador. Identifique el ID de la flota a la que desee añadir el cómputo. Proporcione la siguiente información de procesamiento: un nombre, una dirección IP y una ubicación significativos. La ubicación del cómputo debe ser una ubicación personalizada que ya esté asociada a la flota. Si quieres usar una ubicación personalizada diferente, usa la GameLift consola de Amazon para actualizar la flota o llama al AWS CLI comando create-fleet-locationspara añadir una ubicación personalizada a la flota.

En el siguiente ejemplo, sustituye los valores de los marcadores de posición de tu ordenador y de tu flota. El fleet-id valor se devuelve al crear una flota de Anywhere. Puede recuperar todos los detalles de la flota llamando a describe-fleet-attributesy describe-fleet-location-attributes.

aws gamelift register-compute \ --compute-name HardwareAnywhere \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --ip-address 10.1.2.3 \ --location custom-location-1

Ejemplo de resultado

{ "Compute": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-west-2:111122223333:compute/HardwareAnywhere", "IpAddress": "10.1.2.3", "ComputeStatus": "Active", "Location": "custom-location-1", "CreationTime": "2023-02-23T18:09:26.727000+00:00", "GameLiftServiceSdkEndpoint": "wss://us-west-2.api.amazongamelift.com" } }

Para solicitar un token de autenticación

Llame get-compute-auth-tokenpara solicitar un token de autenticación válido. Registre un equipo. Identifique el identificador de la flota y el nombre del equipo.

En el siguiente ejemplo, sustituya los valores de los marcadores de posición del cálculo y de la flota. El fleet-id valor se devuelve al crear una flota de Anywhere. Puedes recuperar todos los detalles de la flota llamando describe-fleet-attributes. Para obtener información sobre el cómputo, llama list-computecon el identificador de la flota para ver todos los cálculos registrados en la flota.

aws gamelift get-compute-auth-token \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --compute-name HardwareAnywhere

Ejemplo de resultado

{ "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-east-1:111122223333:compute/HardwareAnywhere", "AuthToken": "0c728041-3e84-4aaa-b927-a0fb202684c0", "ExpirationTimestamp": "2023-02-23T18:47:54+00:00" }

Inicia un servidor de juegos

Una vez que hayas creado una flota de Anywhere y hayas añadido uno o más ordenadores a la flota, estarás listo para empezar a ejecutar tus servidores de juegos.

Paso 1: Instala el software del servidor de juegos

Instale la versión de su servidor de juegos y todo el software dependiente en cada ordenador de su flota de Anywhere. La versión del servidor de juegos debe estar integrada con la SDK versión 5.x (o superior) GameLift del servidor de Amazon con la funcionalidad mínima requerida para comunicarse con el GameLift servicio de Amazon.

Paso 2: Prepara tus ordenadores para ejecutar un servidor de juegos

Asegúrese de que cada ordenador esté registrado y tenga un token de autenticación válido. Si utilizas scripts para administrar estas tareas, asegúrate de que los scripts se ejecuten en cada equipo antes de iniciar cualquier proceso del servidor de juegos.

Si has implementado el Amazon GameLift Agent con el software de tu servidor de juegos, asegúrate de que se inicie el ejecutable del Agente.

Paso 3: Inicia un proceso de servidor de juegos

Ejecute una instancia del ejecutable de su servidor de juegos en una computadora. Si la versión del servidor de juegos está correctamente integrada, el proceso del servidor de juegos invoca la SDK acción del servidor InitSDK() con un conjunto de parámetros de servidor válidos. Cuando el proceso del servidor está listo para albergar una sesión de juego, llamaProcessReady().

nota

Si implementaste el software de tu servidor de juegos con Amazon GameLift Agent, puedes saltarte este paso. El agente inicia automáticamente los procesos del servidor de juegos en función de las instrucciones de tiempo de ejecución que proporciones.

Puedes supervisar el progreso consultando las métricas de los procesos del servidor para activar y activar los procesos del servidor. Consulte Métricas de Amazon GameLift para flotas. Si el proceso del servidor del juego no se inicializa, comprueba que el proceso esté recuperando los valores de los parámetros del servidor correctos para el ordenador en el que se está ejecutando.