Como cancelar o registro de um cluster

Nesta página, descrevemos como cancelar manualmente o registro de um cluster em uma frota do Google Cloud. Quando você cancela manualmente o registro de um cluster, sua conexão com a frota é removida, mas o cluster permanece.

Cancelar o registro de um cluster

gcloud

Cancelar o registro de um cluster do GKE

Execute um dos seguintes comandos:

gcloud container hub memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-uri=[GKE_URI]
gcloud container hub memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-cluster=[GKE_CLUSTER]

onde:

  • [PROJECT_ID] é o ID do projeto no Google Cloud. Saiba como encontrar esse valor.
  • [MEMBERSHIP_NAME] é o nome da associação que corresponde ao seu cluster. Para listar todas as assinaturas no Hub, execute: gcloud container hub memberships list.
  • [GKE_URI] é o URI do cluster do GKE, por exemplo: "https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster". Para conseguir o URI, execute gcloud container clusters list --uri. O URI fornecido será validado para confirmar que é mapeado no cluster válido do GKE.
  • [GKE_CLUSTER] é o location/name do cluster do GKE. O local pode ser uma zona ou região, por exemplo: us-central1-a/my-cluster.

Cancelar o registro de qualquer outro tipo de cluster

Execute este comando:

gcloud container hub memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --context=[KUBECONFIG_CONTEXT] \
   --kubeconfig=[KUBECONFIG_PATH]

onde:

  • [PROJECT_ID] é o ID do projeto no Google Cloud. Saiba como encontrar esse valor.
  • [MEMBERSHIP_NAME] é o nome da associação que corresponde ao seu cluster. Para ver uma lista de todas as assinaturas no hub, execute: gcloud container hub memberships list.
  • [KUBECONFIG_PATH] é o caminho de arquivo local em que o kubeconfig que contém uma entrada para o arquivo de cluster está armazenado; O padrão é $KUBECONFIG se essa variável de ambiente estiver definida. Caso contrário, o padrão será $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] é o contexto do cluster como ele aparece no arquivo kubeconfig. É possível conseguir esse valor a partir da linha de comando executando kubectl config current-context.

Console

Cancelar o registro de um cluster do GKE

Para cancelar o registro de um cluster do GKE:

  1. Acessar a página Clusters do Anthos. Esta página mostra todos os clusters registrados.

    Acessar a página de clusters do Anthos

  2. Selecione o cluster para cancelamento do registro na lista. Um painel de detalhes é exibido.

  3. No painel de detalhes, clique em Cancelar registro.

  4. Na caixa de diálogo exibida, clique em Cancelar registro novamente para confirmar a ação.

Cancelar o registro de qualquer outro tipo de cluster

Para cancelar o registro de qualquer outro cluster da frota:

  1. No Console do Cloud, acesse a página Clusters do GKE.

    Acesse os clusters do GKE

  2. Na lista de clusters, clique em Ações ao lado do cluster registrado e em Cancelar registro.

  3. Na caixa de diálogo exibida, clique em Cancelar registro novamente para confirmar a ação.

Verificar se o namespace do agente do Connect foi excluído (opcional)

Depois de cancelar o registro de um cluster, é possível verificar se o namespace usado pelo agente do Connect foi excluído. Isso se aplica aos registros que instalam apenas o agente do Connect. Para isso, execute:

kubectl get ns -l hub.gke.io/project

Se esse comando não retornar nenhuma saída, o namespace já foi excluído.

Exclua a conta de serviço do Google Cloud

Se você criou uma conta de serviço para o agente do Connect, poderá excluí-la da seguinte maneira:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Cancelar o registro de um cluster indisponível

Caso queira cancelar o registro de um cluster que você não consegue mais acessar, siga estas etapas:

  1. Liste os clusters (também conhecidos como assinaturas) que estão registrados no momento:

    gcloud container hub memberships list

    Na saída do comando, a coluna Name lista os nomes de associação de clusters registrados, e a coluna EXTERNAL_ID lista os UIDs dos clusters do namespace do kube-system.

  2. Para cancelar o registro de um cluster indisponível, execute o seguinte comando:

    gcloud container hub memberships delete [MEMBERSHIP_NAME]

    em que [MEMBERSHIP_NAME] é o nome da associação que corresponde ao seu cluster.