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.
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:
No painel Detalhes, clique em Mais detalhes.
Próximo à parte superior da janela, clique em
Excluir.Quando solicitado a confirmar, clique em Excluir novamente.
Se o Tipo for externo, isso indicará que o cluster foi criado usando
gkectl
. Nesse caso, usegkectl
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.
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:
No vSphere Web Client, clique com o botão direito do mouse na VM e selecione Power > Power Off.
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.