Como excluir um cluster de usuário

Nesta página, descrevemos como excluir clusters do Anthos no cluster do usuário do VMware (GKE no local).

Escolher uma ferramenta para excluir um cluster

A maneira como você exclui um cluster de usuário depende se ele é gerenciado pela API Anthos On-Prem. Um cluster de usuário será gerenciado pela API GKE On-Prem se uma das condições a seguir for verdadeira:

O cluster foi criado no console do Google Cloud ou usando a CLI do Google Cloud (CLI gcloud), que configura automaticamente a API Anthos On-Prem para gerenciar o cluster.
O cluster foi criado usando gkectl, mas foi configurado para ser gerenciado pela API Anthos On-Prem.

Se a API Anthos On-Prem estiver gerenciando um cluster de usuário, será possível usar qualquer ferramenta para excluir o cluster. Se o cluster de usuário não for gerenciado pela API Anthos On-Prem, use gkectl na estação de trabalho de administrador para excluir o cluster.

Excluir um cluster de usuário

gkectl

É possível usar gkectl para excluir qualquer cluster de usuário, incluindo clusters gerenciados pela API Anthos On-Prem.

gkectl delete cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --cluster CLUSTER_NAME

onde

ADMIN_CLUSTER_KUBECONFIG é o caminho para o arquivo kubeconfig do cluster de administrador.
CLUSTER_NAME é o nome do cluster de usuário que você quer excluir.

Se a exclusão do cluster de usuário falhar, é possível executar gkectl com a sinalização --force para limpar os recursos do cluster.

gkectl delete cluster \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--cluster CLUSTER_NAME \
--force

Se você estiver usando o balanceador de carga em pacote Seesaw, exclua o balanceador de carga.

Console do Google Cloud

Se o cluster de usuário for gerenciado pela API Anthos On-Prem, siga as etapas abaixo para excluí-lo:

No console do Google Cloud, acesse a página Clusters do Anthos.

Acesse a página de clusters do Anthos
Selecione o projeto do Cloud em que o cluster de usuário está.
Na lista de clusters, clique no cluster que você quer editar.
No painel Detalhes, se o Tipo for vm Anthos (VMware), siga as etapas a seguir para excluir o cluster usando o console do Google Cloud:
1. No painel Detalhes, clique em Mais detalhes.
2. Próximo à parte superior da janela, clique em Excluir.
3. Quando solicitado a confirmar, clique em Excluir novamente.
Se o Tipo for externo, isso indicará que o cluster foi criado usando gkectl. Nesse caso, use gkectl para excluir o cluster.

CLI da gcloud

Se o cluster de usuário for gerenciado pela API Anthos On-Prem, faça o seguinte em um computador que tenha a CLI gcloud instalada:

Faça login com sua Conta do Google:
```
gcloud auth login
```
Atualize os componentes:
```
gcloud components update
```
Receba uma lista de clusters para garantir que seja especificado o nome correto do cluster no comando de exclusão:
```
gcloud alpha container vmware clusters list \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION
```
Substitua:
- FLEET_HOST_PROJECT_ID: o ID do projeto em que o cluster está registrado.
- LOCATION: o local do Google Cloud associado ao cluster de usuário.
O resultado será assim:
```
NAME                      LOCATION    VERSION          ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.14.1-gke.39    example-admin-cluster-1   RUNNING
```
Use o comando a seguir para excluir o cluster:
```
gcloud alpha container vmware clusters delete USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing
```
Substitua:
- USER_CLUSTER_NAME: o nome do cluster de usuário a ser verificado.
- FLEET_HOST_PROJECT_ID: o ID do projeto em que o cluster está registrado.
- LOCATION: o local do Google Cloud associado ao cluster de usuário.
A sinalização --force permite excluir um cluster que tenha pools de nós. Sem a sinalização --force, é necessário excluir os pools de nós primeiro e, em seguida, excluir o cluster.

A sinalização --allow-missing é uma sinalização padrão da API do Google. Ao incluir essa sinalização, o comando retornará que a operação foi bem-sucedida, se o cluster não for encontrado.

Se o comando retornar um erro que contenha o texto failed connecting to the cluster's control plane, isso indica problemas de conectividade com o cluster de administrador, o agente do Connect ou o no ambiente local.
- Se você acha que o problema de conectividade é temporário, por exemplo, por causa de problemas de rede, aguarde e execute o comando novamente.
- Se a tentativa de comando continuar a falhar, consulte Como coletar registros do agente do Connect para resolver problemas com o agente.
- Se você souber que o cluster de administrador foi excluído e se as VMs do administrador ou do cluster de usuário tiverem sido encerradas ou estiverem inacessíveis, inclua a sinalização --ignore-errors e tente executar o comando novamente.
Atenção: quando os clusters de administrador e usuário estão inacessíveis e você inclui --ignore-errors, o comando de exclusão remove apenas os recursos do Google Cloud. Alguns recursos do F5 ou do vSphere podem ser deixados para trás. Consulte a seção Como limpar recursos para ver informações sobre como limpar os recursos restantes.

Para informações sobre outras sinalizações, consulte a referência da CLI gcloud.

Limpar recursos

Se houve problemas quando você excluiu o cluster, alguns recursos F5 ou vSphere podem ser deixados para trás. As seções a seguir explicam como limpar esses recursos restantes.

Como limpar as VMs de um cluster de usuário no vSphere

Para verificar se as VMs do cluster de usuário foram excluídas, execute as seguintes etapas:

No menu Navigator do lado esquerdo do Cliente da Web do vSphere, clique no menu Hosts and Clusters.
Encontre o pool de recursos do cluster de administrador. Esse é o valor de vCenter.resourcePool no arquivo de configuração do cluster de administrador.
No pool de recursos, localize as VMs com o prefixo do nome do seu cluster de usuário. Esses são os nós do plano de controle do cluster de usuário. Haverá um ou três deles dependendo se o cluster de usuário tem um plano de controle de alta disponibilidade.
Encontre o pool de recursos do seu cluster de usuário. Esse é o valor de vCenter.resourcePool no arquivo de configuração do cluster de usuário. Se o arquivo de configuração do cluster de usuário não especificar um pool de recursos, ele será herdado do cluster de administrador.
No pool de recursos, localize as VMs com o prefixo do nome de um pool de nós no cluster de usuário. Esses são os nós de trabalho no cluster de usuário.
Para cada nó do plano de controle e cada nó de trabalho:
1. No vSphere Web Client, clique com o botão direito do mouse na VM e selecione Power > Power Off.
2. Quando a VM estiver desativada, clique com o botão direito na VM e selecione Delete from Disk.

Como limpar a partição F5 de um cluster de usuário

Se houver entradas restantes na partição do cluster de usuário, execute as seguintes etapas:

No console F5 BIG-IP, no canto superior direito do console, alterne para a partição do cluster de usuário que você quer limpar.
Selecione Local Traffic > Virtual Servers > Virtual Server List.
No menu Virtual Servers, remova todos os IPs virtuais.
Selecione Pools e exclua todos os pools.
Selecione Nodes e exclua todos os nós.

Depois de terminar

Depois que o cluster for excluído, será possível excluir o kubeconfig dele.