Esta página foi traduzida pela API Cloud Translation.

Anular o registo de um cluster

Esta página descreve como anular manualmente o registo de um cluster numa Google Cloud frota. Quando anula manualmente o registo de um cluster, a respetiva ligação à frota é removida, mas o cluster permanece. A eliminação de um cluster do GKE registado no Google Cloud através da Google Cloud consola ou da CLI gcloud também elimina a associação à frota do cluster.

Só pode anular o registo de clusters do GKE no Google Cloud e de clusters de terceiros anexados. Não é possível anular o registo de outros tipos de clusters.

Tenha em atenção que a movimentação de clusters registados entre frotas (anular o registo e, em seguida, registar novamente) não é recomendada, uma vez que pode resultar num comportamento inesperado ou indesejado. Por exemplo, a identidade de carga de trabalho da frota das suas cargas de trabalho vai mudar, o que pode resultar em pedidos bloqueados e interrupções. A abordagem recomendada é criar um novo cluster na frota em que quer que as cargas de trabalho residam e, em seguida, mover as cargas de trabalho do cluster antigo para o novo cluster.

Anule o registo de um cluster

gcloud

Anule o registo de um cluster do GKE

Este comando só pode ser usado para anular o registo de clusters do GKE registados através do gcloud container clusters update ou gcloud container clusters create.

Execute o seguinte comando:

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

Substitua CLUSTER_NAME pelo nome do cluster que quer eliminar.

Anule o registo de um cluster do GKE (comando antigo)

Se registou um cluster com o comando register mais antigo, execute um dos seguintes comandos para anular o registo:

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]

where:

[PROJECT_ID] é o ID do seu Google Cloud projeto. Saiba como encontrar este valor.
[MEMBERSHIP_NAME] é o nome da subscrição que corresponde ao seu cluster. Para apresentar uma lista de todas as subscrições 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". Pode obter o URI executando gcloud container clusters list --uri. O URI fornecido é validado para confirmar que é mapeado para o cluster do GKE válido.
[GKE_CLUSTER] é o location/name do cluster do GKE. A localização pode ser uma zona ou uma região, por exemplo: us-central1-a/my-cluster.

Anule o registo de um cluster anexado

Estas instruções aplicam-se a clusters registados através da versão mais recente da nossa funcionalidade de clusters anexados. Os clusters anexados através da geração anterior descontinuada desta funcionalidade devem usar o comando antigo na secção seguinte.

Anule o registo de um cluster anexado (comando antigo)

Se registou um cluster com a geração anterior de clusters anexados, execute o seguinte comando para anular o registo:

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

where:

[PROJECT_ID] é o ID do seu Google Cloud projeto. Saiba como encontrar este valor.
[MEMBERSHIP_NAME] é o nome da subscrição que corresponde ao seu cluster. Para obter uma lista de todas as subscrições no Hub, execute o seguinte: gcloud container fleet memberships list.
[KUBECONFIG_PATH] é o caminho local onde o seu kubeconfig que contém uma entrada para o ficheiro do cluster está armazenado. A predefinição é $KUBECONFIG se essa variável de ambiente estiver definida. Caso contrário, a predefinição é $HOME/.kube/config.
[KUBECONFIG_CONTEXT] é o contexto do cluster, tal como aparece no ficheiro kubeconfig. Pode obter este valor na linha de comandos executando kubectl config current-context.

Consola

Anule o registo de um cluster do GKE no Google Cloud

Para anular o registo de um cluster do GKE:

Aceda à página Clusters do GKE. Esta página mostra todos os seus clusters.

Aceda à página Clusters do GKE
Clique em Ações junto ao cluster na lista que quer anular o registo.
No menu Ações, selecione Anular registo.
Na caixa de diálogo apresentada, escreva o nome do cluster e clique em Anular registo para confirmar a ação.

Anule o registo de um cluster de terceiros associado

Para anular o registo de um cluster anexado:

Na Google Cloud consola, aceda à página Vista geral dos clusters do Google Kubernetes Engine.

Aceda aos clusters do GKE
Selecione o Google Cloud projeto no qual o cluster se encontra.
Clique no nome do cluster que quer desassociar e, de seguida, selecione Ver mais detalhes no painel lateral.
Junto à parte superior da janela, clique em Eliminar.
Quando lhe for pedido que confirme, introduza o nome do cluster e clique em Confirmar.

Terraform

Para anular o registo de um cluster do GKE que registou através do Terraform:

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

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT é o Google Cloud ID do projeto ao qual o cluster está registado.

Faça a gestão do agente do Connect

Os passos que se seguem aplicam-se apenas à anulação do registo de clusters anexados, em que o agente do Connect está instalado no cluster como parte do registo.

Opcional: verifique se o espaço de nomes do agente Connect foi eliminado

Depois de anular o registo de um cluster, pode verificar se o espaço de nomes usado pelo agente do Connect foi eliminado. Isto aplica-se apenas a registos que instalam o agente de ligação. Para o fazer, execute:

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

Se este comando não devolver nenhum resultado, significa que o espaço de nomes já foi eliminado.

Elimine a conta de serviço do agente do Connect

Se criou uma conta de serviço para o agente do Connect, pode eliminá-la da seguinte forma:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Anule o registo de um cluster indisponível

Se quiser anular o registo de um cluster ao qual já não tem acesso, siga os passos abaixo:

Indique os clusters (também conhecidos como subscrições) que estão atualmente registados:
```
gcloud container fleet memberships list
```
Na saída do comando, a coluna Name apresenta os nomes dos membros dos clusters registados e a coluna EXTERNAL_ID apresenta os UIDs dos clusters do espaço de nomes kube-system.
Para anular o registo 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.