Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
[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.
[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:
Acesse a página Clusters do GKE. Esta
página mostra todos os clusters.
Selecione o projeto do Google Cloud em que o cluster está.
Clique no nome do cluster que você quer desanexar e selecione Conferir mais detalhes no painel lateral.
Próximo à parte superior da janela, clique em delete
Excluir.
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:
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.
Para cancelar o registro de um cluster indisponível, execute o seguinte comando:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[],[],null,["# Unregistering a cluster\n\nThis page describes how to manually unregister a cluster from a Google Cloud fleet.\nWhen you manually unregister a cluster, its connection to the fleet is\nremoved but the cluster remains. [Deleting a registered GKE cluster on Google Cloud](/kubernetes-engine/docs/how-to/deleting-a-cluster) using either the Google Cloud console or gcloud CLI also deletes the cluster's fleet membership.\n\nYou can unregister GKE clusters on Google Cloud and attached\nthird-party clusters only. Other cluster types can't be unregistered.\n\nNote that moving registered clusters between fleets (unregistering then\nreregistering) is not recommended, as it can result in unexpected\nor unwanted behavior: for example, your workloads' fleet Workload Identity\nwill change, potentially resulting in blocked requests and outages. The\nrecommended approach is to create a new cluster in the fleet in which you\nwant your workloads to reside, then move your workloads from your old cluster\nto the new cluster.\n\nUnregister a cluster\n--------------------\n\n### gcloud\n\n### Unregister a GKE cluster\n\nThis command can only be used to unregister GKE clusters registered using `gcloud container clusters update` or `gcloud container clusters create`.\n\nRun the following command: \n\n```\ngcloud container clusters update CLUSTER_NAME --clear-fleet-project\n```\n\nReplace \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e with the cluster's name you want to delete.\n\n### Unregister a GKE cluster (legacy command)\n\nIf you registered a cluster using the older `register` command, run either of the following commands to unregister it: \n\n```\ngcloud container fleet memberships unregister [MEMBERSHIP_NAME] \\\n --project=[PROJECT_ID] \\\n --gke-uri=[GKE_URI]\n``` \n\n```\ngcloud container fleet memberships unregister [MEMBERSHIP_NAME] \\\n --project=[PROJECT_ID] \\\n --gke-cluster=[GKE_CLUSTER]\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003e[PROJECT_ID]\u003c/var\u003e is your Google Cloud project ID. [Learn how to find\n this value](/resource-manager/docs/creating-managing-projects#identifying_projects).\n- \u003cvar translate=\"no\"\u003e[MEMBERSHIP_NAME]\u003c/var\u003e is the membership name that corresponds to your cluster. To list all the memberships on the Hub, run: `gcloud container fleet memberships list`.\n- \u003cvar translate=\"no\"\u003e[GKE_URI]\u003c/var\u003e is the URI of the GKE cluster, for example: 'https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster'. You can obtain the URI by running `gcloud container clusters list --uri`. The provided URI will be validated to confirm that it maps to the valid GKE cluster.\n- \u003cvar translate=\"no\"\u003e[GKE_CLUSTER]\u003c/var\u003e is the `location/name` of the GKE cluster. The location can be a zone or a region for example: `us-central1-a/my-cluster`.\n\n### Unregister an attached cluster\n\nThese instructions apply to clusters registered using the latest version of our attached clusters feature. Clusters attached using the deprecated previous generation of this feature should use the legacy command in the next section.\n\n- [Detach an EKS cluster](/anthos/clusters/docs/multi-cloud/attached/eks/how-to/detach-cluster)\n- [Detach an AKS cluster](/anthos/clusters/docs/multi-cloud/attached/aks/how-to/detach-cluster)\n- [Detach another attached cluster type](/anthos/clusters/docs/multi-cloud/attached/generic/how-to/detach-cluster)\n\n### Unregister an attached cluster (legacy command)\n\nIf you registered a cluster using the previous generation of attached clusters, run the following command to unregister it: \n\n```\ngcloud container fleet memberships unregister [MEMBERSHIP_NAME] \\\n --project=[PROJECT_ID] \\\n --context=[KUBECONFIG_CONTEXT] \\\n --kubeconfig=[KUBECONFIG_PATH]\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003e[PROJECT_ID]\u003c/var\u003e is your Google Cloud project ID. [Learn how to find\n this value](/resource-manager/docs/creating-managing-projects#identifying_projects).\n- \u003cvar translate=\"no\"\u003e[MEMBERSHIP_NAME]\u003c/var\u003e is the membership name that corresponds to your cluster. To get list of all the memberships on the Hub, run: `gcloud container fleet memberships list`.\n- \u003cvar translate=\"no\"\u003e[KUBECONFIG_PATH]\u003c/var\u003e is the local path where your kubeconfig containing an entry for the cluster file is stored. This defaults to `$KUBECONFIG` if that environment variable is set, otherwise this defaults to `$HOME/.kube/config`.\n- \u003cvar translate=\"no\"\u003e[KUBECONFIG_CONTEXT]\u003c/var\u003e is the cluster's context as it appears in the kubeconfig file. You can get this value from the command line by running `kubectl config current-context`.\n\n### Console\n\n### Unregister a GKE cluster on Google Cloud\n\nTo unregister a GKE cluster:\n\n1. Go to the **GKE Clusters** page. This\n page shows all your clusters.\n\n [Go to the GKE Clusters page](https://console.cloud.google.com/kubernetes/list/overview)\n2. Click more_vert **Actions** next to the cluster in the list that you want to unregister.\n\n3. In the Actions menu, select **Unregister**.\n\n4. In the dialog that displays, type the name of the cluster and click **Unregister** to confirm the action.\n\n### Unregister an attached third-party cluster\n\n\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\n\u003cbr /\u003e\n\nTo unregister an attached cluster:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine clusters\n overview** page.\n\n [Go to GKE clusters](https://console.cloud.google.com/kubernetes/list/overview)\n2. Select the Google Cloud project that the cluster is in.\n\n3. Click the name of the cluster you want to detach, and then select\n **View more details** in the side panel.\n\n4. Near the top of the window, click delete **Delete**.\n\n5. When prompted to confirm, enter the name of the cluster and\n click **Confirm**.\n\n### Terraform\n\nTo unregister a GKE cluster that you registered using Terraform:\n\nDelete the following block from the `google_container_cluster` resource configuration of the cluster: \n\n fleet {\n project = \u003cvar translate=\"no\"\u003e\"FLEET_HOST_PROJECT\"\u003c/var\u003e\"\n }\n\n\u003cvar translate=\"no\"\u003eFLEET_HOST_PROJECT\u003c/var\u003e is the Google Cloud project ID your cluster is registered to.\n\nManage the Connect Agent\n------------------------\n\nThe following steps apply only to unregistering attached clusters, where the Connect Agent is installed on the cluster as part of registration.\n\n### Optional: Verify that the Connect Agent namespace is deleted\n\nAfter you unregister a cluster, you can verify that the namespace used by the\nConnect Agent has been deleted. This applies to registrations that install the Connect Agent only. To do so, run: \n\n```\nkubectl get ns -l hub.gke.io/project\n```\n\nIf this command returns no output, the namespace has already been deleted.\n\n### Delete the Connect Agent Service Account\n\nIf you created a service account for the Connect Agent, you can delete it as follows: \n\n```\ngcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]\n```\n\nUnregister an unavailable cluster\n---------------------------------\n\nIf you want to unregister a cluster that you can no longer access, perform\nthe following steps:\n\n1. List the clusters (a.k.a memberships) that are currently registered:\n\n ```\n gcloud container fleet memberships list\n ```\n\n In the command output, the `Name` column lists the membership names of registered\n clusters, and the `EXTERNAL_ID` column lists the clusters' UIDs of the kube-system\n namespace.\n2. To unregister an unavailable cluster, run the following command:\n\n ```\n gcloud container fleet memberships delete [MEMBERSHIP_NAME]\n ```\n\n where \u003cvar translate=\"no\"\u003e[MEMBERSHIP_NAME]\u003c/var\u003e is the membership name that corresponds to\n your cluster."]]
