Crear o actualizar un lanzamiento

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:
  • Cloud Shell

    Para iniciar Cloud Shell, sigue estos pasos:

    1. Ve a la consola de Google Cloud.

      Consola de Google Cloud

    2. Desde la esquina superior derecha de la consola, haz clic en el botón Activar Cloud Shell: .

    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:

    1. Crea una cuenta de servicio.
    2. Descarga una clave privada como un archivo JSON.
    3. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

    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

  1. En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

  3. Haz clic en Manage Rollout.

  4. En la lista Select a config, elige una configuración predeterminada que se aplique a todos los dominios (opcional).

  5. Haz clic en Guardar.

gcloud

Para actualizar la configuración predeterminada de un lanzamiento de Game Servers con Google Cloud CLI, sigue estos pasos:

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

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

  1. En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

  3. Haz clic en Manage Rollout.

  4. En la lista Select a config, elige la opción (no default config).

  5. Haz clic en Guardar.

gcloud

Para borrar la configuración predeterminada de un lanzamiento de Game Servers con Google Cloud CLI, sigue estos pasos:

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

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

  1. En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

  3. Haz clic en Manage Rollout.

  4. 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).

  5. En Override configs, puedes especificar una o más configuraciones de anulación y los dominios con los que se asociarán.

    1. Selecciona una configuración de anulación de la lista Config y el dominio con el cual asociarla de la lista Realm.
    2. Usa los botones de flecha para cambiar el orden de prioridad de las configuraciones de anulación en la lista.
    3. Haga clic en Agregar.
  6. Haz clic en Guardar.

gcloud

Para aplicar anulaciones de configuración a dominios particulares mediante Google Cloud CLI, sigue estos pasos:

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

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

  1. En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

  3. Haz clic en Manage Rollout.

  4. En Override configs, haz clic en el ícono de la papelera junto a la configuración que quieres borrar.

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

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

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

  1. En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

  3. 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:
    1. 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 estado Running, ejecuta el siguiente comando:
      kubectl get pods -n agones-system -l agones.dev/role=controller
      
    2. 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.
    3. Asegúrate de que la versión instalada de Agones sea compatible con los servidores para videojuegos.
  • Consulta la guía de solución de problemas de Agones.
  • Comprueba que el recurso de implementación de Game Servers esté configurado correctamente:
    1. 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.
    2. 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.
    3. 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.