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. Excluir um cluster do GKE registrado no Google Cloud usando o console do Google Cloud ou a CLI gcloud também exclui a associação da frota do cluster.

Só é possível cancelar o registro de clusters do GKE no Google Cloud e clusters de terceiros. Não é possível cancelar o registro de outros tipos de cluster.

Não é recomendável mover clusters registrados entre frotas (cancelar o registro e registrar novamente), porque isso pode resultar em comportamentos inesperados ou indesejados. Por exemplo, a Identidade da carga de trabalho da frota das cargas de trabalho será alterada, o que pode resultar em interrupções do serviço e solicitações bloqueadas. A abordagem recomendada é criar um novo cluster na frota em que você quer que as cargas de trabalho fiquem e, em seguida, movê-las do cluster antigo para o novo.

Cancelar o registro de um cluster

gcloud

Cancelar o registro de um cluster do GKE

Esse comando só pode ser usado para cancelar o registro de clusters do GKE registrados usando gcloud container clusters update ou gcloud container clusters create.

Execute este comando:

gcloud container clusters update CLUSTER_NAME --clear-fleet-project

Substitua CLUSTER_NAME pelo nome do cluster que você quer excluir.

Cancelar o registro de um cluster do GKE (comando legado)

Se você registrou um cluster usando o comando register mais antigo, execute um destes comandos para cancelar o registro:

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

em que:

  • [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 fleet 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 um cluster anexado

Estas instruções se aplicam aos clusters registrados com a versão mais recente do nosso recurso de clusters anexados. Os clusters anexados usando a geração anterior deste recurso, descontinuada, devem usar o comando legado na próxima seção.

Cancelar o registro de um cluster anexado (comando legado)

Se você registrou um cluster usando a geração anterior de clusters anexados, execute o seguinte comando para cancelar o registro:

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

em que:

  • [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 fleet 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 no Google Cloud

Para cancelar o registro de um cluster do GKE:

  1. Acesse a página Clusters do GKE. Esta página mostra todos os clusters.

    Acesse a página Clusters do GKE.

  2. Clique em Ações ao lado do cluster na lista para cancelar o registro.

  3. No menu "Ações", selecione Cancelar registro.

  4. Na caixa de diálogo exibida, digite o nome do cluster e clique em Cancelar registro para confirmar a ação.

Cancelar o registro de um cluster de terceiros anexado

Para cancelar o registro de um cluster anexado:

  1. No console do Google Cloud, acesse a página Visão geral dos clusters do Google Kubernetes Engine.

    Acesse os clusters do GKE

  2. Selecione o projeto do Google Cloud em que o cluster está.

  3. Clique no nome do cluster que você quer desanexar e selecione Conferir mais detalhes no painel lateral.

  4. Próximo à parte superior da janela, clique em Excluir.

  5. Quando for solicitado que você confirme, insira o nome do cluster e clique em Confirmar.

Terraform

Para cancelar o registro de um cluster do GKE que você registrou usando o Terraform:

Exclua o seguinte bloco da configuração de recursos google_container_cluster do cluster:

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT é o ID do projeto do Google Cloud em que o cluster está registrado.

Gerenciar o agente do Connect

As etapas a seguir se aplicam apenas ao cancelamento do registro de clusters anexados, em que o agente do Connect está instalado no cluster como parte do registro.

Opcional: verificar se o namespace do agente do Connect foi excluído

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 agente do Connect

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 fleet 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 fleet memberships delete [MEMBERSHIP_NAME]

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