Excluir um cluster

Esta página explica como excluir um cluster do Game Servers.

Antes de começar

Antes de começar, recomendamos que você se familiarize com os principais conceitos na Visão geral do Game Servers. Verifique se você também realizou as seguintes tarefas:

  • Verifique se você ativou a API Game Services.
  • Ativar a API Game Services
  • Escolha um shell com a CLI gcloud instalada ou use um cliente de API:
  • Cloud Shell

    Para iniciar o Cloud Shell, execute os seguintes passos:

    1. Acesse o Console do Google Cloud.

      Console do Google Cloud

    2. No canto superior direito do console, clique no botão Ativar Cloud Shell:

    Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Use esse shell para executar comandos gcloud.

    Shell local

    Instale a CLI gcloud.

    Verifique se você definiu o projeto padrão desejado para a Google Cloud CLI. Caso contrário, será necessário especificar a sinalização --project explicitamente para cada comando mais tarde:

    gcloud config list project
    

    Caso contrário, execute o seguinte comando para definir um projeto padrão, substituindo PROJECT_ID pelo ID do projeto que você quer:

    gcloud config set project PROJECT_ID
    

    Execute o seguinte comando para verificar a versão da Google Cloud CLI. O Game Servers requer a versão 306.0.0 ou mais recente da CLI gcloud.

    gcloud version
    

    Para atualizar a instalação, execute o seguinte comando:

    gcloud components update
    

    curl / PowerShell

    Para usar a API REST com curl ou o Windows PowerShell, faça o seguinte:

    1. Crie uma conta de serviço.
    2. Faça o download de uma chave privada como um arquivo 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 de cliente

    O Game Servers do Google Cloud pode ser controlado de maneira programática usando uma biblioteca de cliente. Consulte Visão geral das bibliotecas de cliente para instruções sobre como usar a biblioteca e fazer a autenticação.

Excluir um cluster

A exclusão de um cluster do Game Servers não exclui nenhum recurso no cluster.

Console

  1. No Console do Google Cloud, acesse a página Domínios e clusters.

    Acessar o Game Servers

  2. Expanda um realm para ver os clusters do Game Servers que pertencem a ele.

  3. Na última coluna da tabela do cluster, clique nas reticências e selecione Remover cluster do Game Servers.

gcloud

É possível excluir um cluster global ou regional do Game Servers usando a Google Cloud CLI.

Para excluir um cluster global:

  1. Execute o seguinte comando e substitua os valores do marcador, como clusterID e realmID, pelos valores apropriados:

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

    A saída retorna targetState para que seja possível visualizar a operação antes de excluir o cluster.

  2. Para excluir o cluster, execute o seguinte comando:

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

Para excluir um cluster regional:

  1. Execute o seguinte comando e substitua os valores do marcador, como clusterID, pelos valores apropriados:

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

    A saída retorna targetState para que seja possível visualizar a operação antes de excluir o cluster.

  2. Para excluir o cluster, execute o seguinte comando:

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

Os marcadores das variáveis correspondem às seguintes descrições:

  • clusterID é o identificador exclusivo que você especificou para esse cluster.
  • realmID é o identificador exclusivo que você especificou para o realm pai desse cluster.
  • region é a região do cluster, se aplicável. Escolha o mesmo local do domínio pai.

REST

Antes de usar os dados da solicitação, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud listado nas Configurações do IAM
  • REALM_LOCATION: a região do realm ou global
  • REALM_ID: o identificador definido pelo usuário para o realm
  • GS_CLUSTER_ID: o identificador definido pelo usuário para o cluster

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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/gameServerClusters/GS_CLUSTER_ID",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Como verificar se o cluster foi excluído

Verifique se você excluiu o cluster listando os clusters globais ou regionais usando a Google Cloud CLI.

Para listar todos os clusters, execute o seguinte comando:

gcloud game servers clusters list

Para listar clusters em uma região, execute o comando a seguir e substitua region pela região em que você quer listar os clusters:

gcloud game servers clusters list --location=region

Para listar todos os clusters em um realm, execute o seguinte comando e substitua realmID pelo realm pai e region pela região do cluster, se aplicável:

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

O cluster excluído não aparece mais na resposta do comando.

A seguir

Aprenda os conceitos principais na Visão geral do Game Servers.