Crea una implementación

En esta página, se explica cómo crear, enumerar, describir y actualizar implementaciones de Game Servers. Una implementación administra una o más versiones de software que puedes implementar en cualquiera o todos 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.

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

    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.

Crea una implementación

Consola

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

    Ir a Game Servers

  2. Haz clic en Create Deployment.

  3. En el cuadro Name, ingresa un identificador único para esta implementación.

  4. En el cuadro Description, ingresa una descripción para esta implementación (opcional).

  5. Haz clic en Crear.

gcloud

Puede crear una implementación con Google Cloud CLI.

Para crear una implementación, ejecuta el siguiente comando y reemplaza deploymentID por un valor adecuado:

gcloud game servers deployments create deploymentID

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",
}

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": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Enumera implementaciones

Consola

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

    Ir a Game Servers

  2. Puedes usar el cuadro de filtro para filtrar la lista de implementaciones según diferentes propiedades.

gcloud

Puedes enumerar las implementaciones con Google Cloud CLI.

Para enumerar las implementaciones, ejecuta el siguiente comando:

gcloud game servers deployments list

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "gameServerDeployments": [
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-1",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
    },
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-2",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "az38kwIY4X3WdP2SA0fkTGib9hwVj7iXLFXAtIzMLpc"
    }
  ]
}

Describe una implementación

Consola

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

    Ir a Game Servers

  2. Puedes usar el cuadro de filtro para filtrar la lista de implementaciones según diferentes propiedades.

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

  4. A fin de crear una configuración nueva para la implementación, haz clic en Create Config. Para actualizar el lanzamiento, haz clic en Manage Rollout.

gcloud

Puedes obtener detalles sobre una implementación, como la hora de creación o de actualización, con Google Cloud CLI.

Para describir una implementación, ejecuta el siguiente comando y reemplaza deploymentID por el identificador de una implementación que creaste anteriormente:

gcloud game servers deployments describe deploymentID

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 el 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",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
}

Actualiza una implementación

gcloud

Para actualizar un campo de una implementación, ejecuta el comando gcloud game servers deployments update después de reemplazar deploymentID para una implementación existente. El siguiente comando actualiza el campo de descripción de una implementación.

gcloud game servers deployments update deploymentID --description="My updated description"

Para encontrar las marcas de otros campos de implementación, consulta la referencia de gcloud.

REST

En el siguiente ejemplo, se actualiza el campo description. Para actualizar otros campos, agrega los nombres de campo al parámetro de búsqueda ?updateMask= y solicita el cuerpo JSON.

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 el identificador definido por el usuario para la implementación.

Cuerpo JSON de la solicitud:

{
  "description": "My updated description"
}

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
}

¿Qué sigue?