Crea un dominio

En esta página, se explica cómo crear, enumerar, describir y actualizar dominios de Game Servers. Un dominio es una agrupación definida por el usuario de clústeres de servidores de videojuegos según los requisitos de latencia del juego para las poblaciones de jugadores.

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.

   Ejemplo: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Ejemplo: Windows

   Para PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

   Por ejemplo:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Para el símbolo del sistema:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

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 un dominio

Los dominios pueden ser globales o regionales. Un dominio global es una buena opción si los clústeres registrados en un dominio pertenecen a regiones que abarcan varias ubicaciones geográficas, como América del Norte, América del Sur o Europa y Asia. Un dominio regional es una buena opción si los clústeres se encuentran en la misma región, como Europa Occidental. En el caso de una interrupción de red entre regiones, es posible que un dominio global no pueda administrar clústeres en todas las regiones. Para aumentar la resiliencia contra las interrupciones de red entre las regiones, asegúrate de crear dominios regionales en regiones lo más cerca posible de los clústeres del servidor para videojuegos asociados.

Por ejemplo, si creas clústeres en las regiones europe-west1, europe-west2 y europe-west3 para entregar servicios a los usuarios en el oeste de Europa, también puedes crear un dominio regional en una de estas regiones. Esta configuración garantiza que el dominio pueda continuar administrando los clústeres en caso de que no se pueda acceder a estas regiones desde otras partes del mundo debido a una interrupción en la red.

Si no sabes dónde crear tu dominio, puedes crearlo como dominio global. A medida que cambian tus requisitos, puedes crear un dominio nuevo en una región más cercana a los clústeres que necesita administrar. Luego, puedes mover los clústeres existentes al dominio regional nuevo. Para ello, primero borra y cancela el registro de los clústeres del dominio global y, luego, regístralos en el nuevo dominio regional.

Consola

1. En la consola de Google Cloud, ve a la página Dominios y clústeres.

   Ir a Game Servers

2. Haz clic en Create Realm.

3. En el cuadro Realm name, ingresa un identificador único para este dominio.

4. En el cuadro Timezone, selecciona una zona horaria para este dominio. Cuando programas eventos basados en el tiempo, como las políticas de escalamiento, es para esta zona horaria.

5. Haz clic en Crear.

gcloud

Puede crear dominios con Google Cloud CLI. Para crear un dominio global, ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como realmID, por los valores adecuados:

gcloud game servers realms create realmID --time-zone tz

Para crear un dominio regional, ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como realmID, por los valores apropiados:

gcloud game servers realms create realmID --time-zone tz --location=region

Los marcadores de posición de variables corresponden a las siguientes descripciones:

• realmID es un identificador único que puedes especificar para este dominio.
• tz es la zona horaria para este dominio. Cuando programas eventos basados en el tiempo, como las políticas de escalamiento, es para esta zona horaria.
• region es la región del dominio. Si quieres controlar los dominios con fallas, especifica una región. Te recomendamos crear un dominio global y omitir esta opción.

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. Si deseas controlar los dominios con fallas, especifica una región de la lista de ubicaciones compatibles. Te recomendamos que especifiques un dominio global.
• REALM_ID: Es un identificador definido por el usuario para el dominio nuevo.
• TIME_ZONE: La zona horaria para este dominio (por ejemplo, US/Eastern). Debes programar eventos basados en el tiempo, como las políticas de escalamiento, para esta zona horaria.

Cuerpo JSON de la solicitud:

{
  "timeZone": "TIME_ZONE"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "timeZone": "TIME_ZONE"
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms?realmId=REALM_ID"

PowerShell (Windows)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "timeZone": "TIME_ZONE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms?realmId=REALM_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Genera listas de dominios

Consola

1. En la consola de Google Cloud, ve a la página Dominios y clústeres.

   Ir a Game Servers

2. Puedes usar el cuadro de filtro para filtrar la lista de dominios directos por diferentes propiedades.

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 para los dominios o global.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/"

PowerShell (Windows)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/" | Select-Object -Expand Content

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

{
  "realms": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm1",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "US/Eastern",
      "etag": "PlXtLrUJ5pHQoZk0Lz-pWkPFN_dt3PXhIpRrJ5HHWu8"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm2",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "America/Eirunepe",
      "etag": "ay1tXqeujLSsSd93n6uhlZwlxdNTOfG7El992Tsiz98"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm3",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "Asia/Anadyr",
      "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk"
    }
  ]
}

gcloud

Puede enumerar dominios globales o regionales con Google Cloud CLI.

Para enumerar los dominios globales y regionales, ejecuta el siguiente comando:

gcloud game servers realms list

Para enumerar los dominios en una ubicación específica, ejecuta el siguiente comando y reemplaza region por global o una región de Google Cloud:

gcloud game servers realms list --location=region

Describe los dominios

Consola

1. En la consola de Google Cloud, ve a la página Dominios y clústeres.

   Ir a Game Servers

2. Puedes usar el cuadro de filtro para filtrar la lista de dominios directos por diferentes propiedades.

3. En la última columna de la tabla, haz clic en las elipsis y selecciona View details.

gcloud

Puedes obtener detalles sobre un dominio, como la hora de creación o la zona horaria, con Google Cloud CLI.

Para describir un dominio global, ejecuta el siguiente comando y reemplaza realmID por el identificador para un dominio que creaste antes:

gcloud game servers realms describe realmID

Si creaste uno o más dominios que no eran globales, puedes describir los detalles de un dominio en una región específica. Para describir un dominio en una región, reemplaza realmID por el identificador de un dominio que creaste antes y region por la región en la que está el dominio:

gcloud game servers realms describe realmID --location=region

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 para el dominio o global.
• REALM_ID: Es un identificador definido por el usuario para el dominio.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"

PowerShell (Windows)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "timeZone": "Asia/Anadyr",
  "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk"
}

Actualiza un dominio

gcloud

Para actualizar un campo para un dominio, ejecuta el comando gcloud game servers realms update después de reemplazar realmID y region para un dominio existente. El siguiente comando actualiza el valor de la zona horaria para un dominio. Reemplaza tz por un valor de zona horaria compatible.

gcloud game servers realms update realmID --location=region \
    --time-zone=tz --no-dry-run

Para encontrar las marcas de otros campos de dominio, consulta la referencia de gcloud.

REST

En el siguiente ejemplo, se actualiza el campo timeZone. 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.
• LOCATION: Es la región del dominio.
• REALM_ID: Es el identificador definido por el usuario para el dominio.
• TIME_ZONE: Es la zona horaria para este dominio (por ejemplo, US/Eastern). Debes programar eventos basados en el tiempo, como las políticas de escalamiento, para esta zona horaria.

Cuerpo JSON de la solicitud:

{
  "timeZone": "TIME_ZONE"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "timeZone": "TIME_ZONE"
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID?updateMask=timeZone"

PowerShell (Windows)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "timeZone": "TIME_ZONE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID?updateMask=timeZone" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

¿Qué sigue?

• Aprende a registrar un clúster.
• Obtén más información sobre cómo borrar un dominio.