Borra un clúster

En esta página, se explica cómo borrar un clúster 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 de juegos. Asegúrate de haber realizado las siguientes tareas:

  • Asegúrate de haber habilitado la API de servicios de juego.
  • Habilitar la API de servicios de juego
  • Elige una shell con el SDK de Cloud instalado o usa un cliente de API:
  • Cloud Shell

    Para iniciar Cloud Shell, sigue estos pasos:

    1. Ve a Google Cloud Console

      Google Cloud Console

    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 este shell para ejecutar los comandos de gcloud.

    Shell local

    Para instalar gcloud, instala el SDK de Cloud, que incluye la herramienta de línea de comandos de gcloud.

    Verifica que hayas configurado el proyecto predeterminado deseado para la herramienta de línea de comandos de gcloud (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 del SDK de Google Cloud. Game Servers requiere la versión 306.0.0 o posterior del SDK.

    gcloud version
    

    Para actualizar la instalación, ejecuta el siguiente comando:

    gcloud components update
    

    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.

Borra un clúster

Si borras un clúster de Game Servers, no se borrarán los recursos del clúster.

Comando de gcloud

Puedes borrar un clúster de Game Servers a nivel global o regional con la herramienta de línea de comandos de gcloud.

Para borrar un clúster global, sigue estos pasos:

  1. Ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como clusterID y realmID, con los valores apropiados:

    gcloud game servers clusters delete clusterID --realm=realmID --dry-run
    

    El resultado muestra el targetState para que puedas obtener una vista previa de la operación antes de borrar el clúster.

  2. Para borrar el clúster, ejecuta el siguiente comando:

    gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run
    

Para borrar un clúster regional, sigue estos pasos:

  1. Ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como clusterID, con los valores apropiados:

    gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
    

    El resultado muestra el targetState para que puedas obtener una vista previa de la operación antes de borrar el clúster.

  2. Para borrar el clúster, ejecuta el siguiente comando:

    gcloud game servers clusters delete clusterID --realm=realmID --location=region --no-dry-run
    

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

  • clusterID es el identificador único que especificaste para este clúster.
  • realmID es el identificador único que especificaste para el dominio superior de este clúster.
  • region es la región del clúster, si corresponde. Elige la misma ubicación que el padre o la madre.

Go


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// deleteCluster unregisters a game server cluster.
func deleteCluster(w io.Writer, projectID, location, realmID, clusterID string) error {
	// projectID := "my-project"
	// location := "global"
	// realmID := "myrealm"
	// clusterID := "mycluster"
	ctx := context.Background()
	client, err := gaming.NewGameServerClustersClient(ctx)
	if err != nil {
		return fmt.Errorf("NewGameServerClustersClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.DeleteGameServerClusterRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/realms/%s/gameServerClusters/%s", projectID, location, realmID, clusterID),
	}

	op, err := client.DeleteGameServerCluster(ctx, req)
	if err != nil {
		return fmt.Errorf("DeleteGameServerCluster: %v", err)
	}
	err = op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("Wait: %v", err)
	}

	fmt.Fprintf(w, "Cluster deleted.")
	return nil
}

Node.js

const {
  GameServerClustersServiceClient,
} = require('@google-cloud/game-servers');

const client = new GameServerClustersServiceClient();

async function deleteGameServerCluster() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  // const realmId = 'The ID of the realm to locate this cluster in';
  // const gameClusterId = 'The unique ID for this Game Server Cluster';
  const request = {
    // Provide full resource name of a Game Server Realm
    name: client.gameServerClusterPath(
      projectId,
      location,
      realmId,
      gameClusterId
    ),
  };

  const [operation] = await client.deleteGameServerCluster(request);
  await operation.promise();

  console.log('Game Server cluster deleted');
}

deleteGameServerCluster();

Python

def delete_cluster(project_id, location, realm_id, cluster_id):
    """Deletes a game server cluster."""

    client = gaming.GameServerClustersServiceClient()

    request = game_server_clusters.DeleteGameServerClusterRequest(
        name=f"projects/{project_id}/locations/{location}/realms/{realm_id}/gameServerClusters/{cluster_id}",
    )

    operation = client.delete_game_server_cluster(request)
    print(f"Delete cluster operation: {operation.operation.name}")
    operation.result(timeout=120)

Verifica que se haya borrado tu clúster

Verifica que hayas borrado correctamente el clúster mediante la enumeración de tus clústeres globales o regionales con la herramienta de línea de comandos de gcloud.

Para enumerar todos los clústeres, ejecuta el siguiente comando:

gcloud game servers clusters list

Para enumerar los clústeres en una región, ejecuta el siguiente comando y reemplaza region por la región en la que deseas enumerar los clústeres:

gcloud game servers clusters list --location=region

Para enumerar todos los clústeres en un dominio, ejecuta el comando siguiente y reemplaza realmID por el dominio superior y region por la región del clúster. si corresponde:

gcloud game servers clusters list --realm=realmID --location=region

El clúster borrado ya no aparece en el resultado del comando.

¿Qué sigue?

Obtén información sobre los conceptos clave en la descripción general de los servidores para juegos.