En esta página, se explica cómo crear, actualizar y ver los detalles de un lanzamiento de Game Servers en una implementación. El lanzamiento asigna la configuración del servidor para videojuegos a fin de que se oriente a los dominios. Para ver un ejemplo de extremo a extremo sobre cómo crear una implementación, agrega una configuración y, luego, impleméntala, consulta Configura el comportamiento de escalamiento del clúster.
Figura 1. La versión 1.0 de configuración se lanzó en el dominio de EE.UU. y la versión 1.1 se lanzó en los dominios de Europa y Japón.
Para obtener más información, consulta la descripción general de Game Servers.
Antes de comenzar
Antes de comenzar, te recomendamos que te familiarices con los conceptos clave en la Descripción general de servidores para juegos. Asegúrate de haber realizado las siguientes tareas:
- Asegúrate de haber habilitado la API de los servicios de juego. Habilitar la API de servicios de juego
- Elige una shell que tenga gcloud CLI instalada o usa un cliente de API:
Ve a la consola de Google Cloud.
Desde la esquina superior derecha de la consola, haz clic en el botón Activar Cloud Shell:
.
- Crea una cuenta de servicio.
- Descarga una clave privada como un archivo JSON.
-
Set the environment variable
GOOGLE_APPLICATION_CREDENTIALS
to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.
Cloud Shell
Para iniciar Cloud Shell, sigue estos pasos:
Se abrirá una sesión de Cloud Shell dentro de un marco en la parte inferior en la consola.
Usa esta shell para ejecutar los comandos de gcloud
.
Shell local
Instala la CLI de gcloud
Verifica que hayas configurado el proyecto predeterminado que deseas para Google Cloud CLI (de lo contrario, debes especificar la marca --project
de forma explícita para cada comando más adelante):
gcloud config list project
Si no puedes ejecutar el siguiente comando para configurar un proyecto predeterminado, reemplaza PROJECT_ID
por el ID del proyecto deseado:
gcloud config set project PROJECT_ID
Ejecuta el siguiente comando para verificar tu versión de Google Cloud CLI.
Game Servers requiere la versión 306.0.0
o una posterior de gcloud CLI.
gcloud version
Para actualizar la instalación, ejecuta el siguiente comando:
gcloud components update
curl / PowerShell
Para usar la API de REST con curl
o Windows PowerShell, haz lo siguiente:
Biblioteca cliente
Google Cloud Game Servers se puede controlar de manera programática mediante una biblioteca cliente. Consulta Descripción general de bibliotecas cliente a fin de obtener instrucciones para usar la biblioteca y la autenticación.
Actualiza un lanzamiento
El proceso para actualizar un lanzamiento es el mismo que se usa para crear uno. Primero, asegúrate de haber creado un dominio de Game Servers. Si deseas orientar dominios específicos con una configuración diferente, crea una configuración de anulación separada.
Cómo actualizar la configuración predeterminada de un lanzamiento
La configuración predeterminada del servidor para videojuegos se implementa en todos los dominios. Para orientar dominios específicos con una configuración diferente, consulta Anula la configuración para ciertos dominios.
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis more_vert y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.
Haz clic en Manage Rollout.
En la lista Select a config, elige una configuración predeterminada que se aplique a todos los dominios (opcional).
Haz clic en Guardar.
gcloud
Para actualizar la configuración predeterminada de un lanzamiento de Game Servers con Google Cloud CLI, sigue estos pasos:
Ejecuta el siguiente comando después de reemplazar los siguientes valores de marcador de posición:
- deploymentID es el identificador único de la implementación.
- configID es un identificador único para la configuración.
gcloud game servers deployments update-rollout deploymentID --default-config configID --dry-run
El resultado muestra el
targetState
para que puedas obtener una vista previa de los cambios.Para aplicar los cambios, ejecuta el siguiente comando:
gcloud game servers deployments update-rollout deploymentID --default-config configID --no-dry-run
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
- DEPLOYMENT_ID Es un identificador definido por el usuario para la implementación.
- CONFIG_ID: Es un identificador definido por el usuario para la configuración.
Cuerpo JSON de la solicitud:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "defaultGameServerConfig": "CONFIG_ID" }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Cómo borrar la configuración predeterminada de un lanzamiento
Borra la configuración predeterminada para quitar la configuración de flota de esta implementación de todos los clústeres de Game Servers.
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis more_vert y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.
Haz clic en Manage Rollout.
En la lista Select a config, elige la opción (no default config).
Haz clic en Guardar.
gcloud
Para borrar la configuración predeterminada de un lanzamiento de Game Servers con Google Cloud CLI, sigue estos pasos:
Ejecuta el siguiente comando después de reemplazar el siguiente valor de marcador de posición:
- deploymentID es el identificador único de la implementación.
gcloud game servers deployments update-rollout deploymentID --clear-default-config --dry-run
El resultado muestra el
targetState
para que puedas obtener una vista previa de los cambios.Para aplicar los cambios, ejecuta el siguiente comando:
gcloud game servers deployments update-rollout deploymentID --clear-default-config --no-dry-run
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
- DEPLOYMENT_ID Es un identificador definido por el usuario para la implementación.
Cuerpo JSON de la solicitud:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "defaultGameServerConfig": "" }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Anula la configuración para ciertos dominios
Si deseas orientar dominios específicos con una configuración diferente, crea una configuración de anulación separada y, luego, selecciona uno o más dominios que recibirán esta configuración de anulación (y no la configuración predeterminada).
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis more_vert y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.
Haz clic en Manage Rollout.
En la lista Select a config, elige una configuración predeterminada que se aplique a todos los dominios que no coincidan con una configuración de anulación (opcional).
En Override configs, puedes especificar una o más configuraciones de anulación y los dominios con los que se asociarán.
- Selecciona una configuración de anulación de la lista Config y el dominio con el cual asociarla de la lista Realm.
- Usa los botones de flecha para cambiar el orden de prioridad de las configuraciones de anulación en la lista.
- Haga clic en Agregar.
Haz clic en Guardar.
gcloud
Para aplicar anulaciones de configuración a dominios particulares mediante Google Cloud CLI, sigue estos pasos:
Copia el siguiente código en un archivo y reemplaza los siguientes valores de marcador de posición:
- realmID es el identificador completamente calificado para un dominio, como
projects/<projectID>/locations/<region>/realms/<realmID2>
. - configID es un identificador único para la configuración.
- realmsSelector: realms: - realmID configVersion: configID
- realmID es el identificador completamente calificado para un dominio, como
Ejecuta el siguiente comando después de reemplazar los siguientes valores de marcador de posición:
- deploymentID es el identificador único de la implementación.
- configOverrideFile es la ruta al archivo con la configuración de anulación.
gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile --dry-run
El resultado muestra el
targetState
para que puedas obtener una vista previa de los cambios.Para aplicar los cambios, ejecuta el siguiente comando:
gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile --no-dry-run
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
- LOCATION: Es la región del dominio (o
global
) - DEPLOYMENT_ID Es un identificador definido por el usuario para la implementación.
- REALM_ID: Es el identificador definido por el usuario para el dominio.
- OVERRIDE_CONFIG_ID: Es un identificador definido por el usuario para la configuración de anulación.
Cuerpo JSON de la solicitud:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "gameServerConfigOverrides": [ { "realmsSelector": { "realms": [ "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID" ] }, "configVersion": "OVERRIDE_CONFIG_ID" } ] }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Borra anulaciones de configuración
Borra la configuración de anulación para quitar la configuración de flota de esta implementación de los dominios objetivo.
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis more_vert y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.
Haz clic en Manage Rollout.
En Override configs, haz clic en el ícono de la papelera junto a la configuración que quieres borrar.
Haz clic en Guardar.
gcloud
Para borrar las anulaciones de configuración de un lanzamiento de Game Servers con Google Cloud CLI, sigue estos pasos:
Ejecuta el siguiente comando después de reemplazar el siguiente valor de marcador de posición:
- deploymentID es el identificador único de la implementación.
gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --dry-run
El resultado muestra el
targetState
para que puedas obtener una vista previa de los cambios.Para aplicar los cambios, ejecuta el siguiente comando:
gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --no-dry-run
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
- DEPLOYMENT_ID Es un identificador definido por el usuario para la implementación.
Cuerpo JSON de la solicitud:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "gameServerConfigOverrides": [] }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Visualiza detalles sobre un lanzamiento
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis more_vert y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.
Haz clic en Manage Rollout.
gcloud
Puedes ver detalles sobre un lanzamiento, como los parámetros de configuración en uso, con Google Cloud CLI:
Para ver los detalles de un lanzamiento, ejecuta el siguiente comando después de reemplazar el siguiente valor de marcador de posición:
- deploymentID es el identificador único de la implementación superior.
gcloud game servers deployments describe-rollout deploymentID
El resultado muestra los detalles del lanzamiento.
También puedes ver el estado de los clústeres del servidor de juegos después de que se aplicó el lanzamiento mediante Google Cloud CLI:
gcloud game servers deployments fetch-state deploymentID
En el resultado, se muestran los cambios que aplicó el lanzamiento en cada clúster del servidor para videojuegos.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
- DEPLOYMENT_ID Es un identificador definido por el usuario para la implementación.
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "defaultGameServerConfig": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID", "gameServerConfigOverrides": [ { "realmsSelector": { "realms": [ "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID" ] }, "configVersion": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/OVERRIDE_CONFIG_ID" } ], "etag": "cN31kxa6fWHtaZWUnUZ7LfamUN7Ggz13DWS58Sc5jIQ" }
Soluciona problemas de lanzamientos
En esta sección, se describe por qué es posible que Game Servers no pueda actualizar los clústeres del servidor para videojuegos. Una causa común puede deberse a una mala configuración de Game Servers o de los clústeres del servidor para videojuegos. Puedes revisar la siguiente lista de tareas para ayudarte a diagnosticar posibles problemas que tengas:
- Comprueba que se cumplan los siguientes requisitos previos para un clúster de Agones:
- Asegúrate de que el clúster esté en ejecución y que Agones esté instalado. Para verificar que el pod
agones-controller
esté en el estadoRunning
, ejecuta el siguiente comando:kubectl get pods -n agones-system -l agones.dev/role=controller
- Asegúrate de que el espacio de nombres del servidor para videojuegos tenga los permisos de acceso según la función (RBAC) necesarios para el controlador Agones.
- Asegúrate de que la versión instalada de Agones sea compatible con los servidores para videojuegos.
- Asegúrate de que el clúster esté en ejecución y que Agones esté instalado. Para verificar que el pod
- Consulta la guía de solución de problemas de Agones.
- Comprueba que el recurso de implementación de Game Servers esté configurado correctamente:
- Si usas una configuración de anulación, asegúrate de que la implementación se aplique al dominio con el clúster de destino.
- Asegúrate de que la especificación de la flota esté configurada correctamente. Para validar la especificación de la flota, intenta abrir un servidor para videojuegos de forma manual.
- Si no se realizó un cambio programado, asegúrate de que el programa esté configurado correctamente. La zona horaria de un programa sigue la zona horaria del dominio.
¿Qué sigue?
Obtén más información sobre cómo borrar una configuración.