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:
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.
Crea una implementación
Consola
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Haz clic en Create Deployment.
En el cuadro Name, ingresa un identificador único para esta implementación.
En el cuadro Description, ingresa una descripción para esta implementación (opcional).
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
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
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:
- PROJECT_ID: Es tu ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
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
En la consola de Google Cloud, ve a la página Implementaciones de servidor de juegos.
Puedes usar el cuadro de filtro para filtrar la lista de implementaciones según diferentes propiedades.
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.
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?
- Obtén más información sobre cómo crear una configuración.
- Obtén información para crear o actualizar un lanzamiento.
- Aprende a borrar una implementación.