Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive come annullare manualmente la registrazione di un cluster da una Google Cloud fleet.
Quando annulli manualmente la registrazione di un cluster, la sua connessione al parco risorse viene
rimossa, ma il cluster rimane. L'eliminazione di un cluster GKE registrato su Google Cloud utilizzando la console Google Cloud o gcloud CLI elimina anche l'appartenenza del cluster al parco risorse.
Puoi annullare la registrazione solo dei cluster GKE su Google Cloud e dei cluster di terze parti collegati. Gli altri tipi di cluster non possono essere annullati.
Tieni presente che lo spostamento dei cluster registrati da un parco risorse all'altro (annullamento della registrazione e nuova registrazione) non è consigliato, in quanto può causare comportamenti imprevisti o indesiderati: ad esempio, l'identità del workload del parco risorse dei tuoi workload cambierà, il che potrebbe comportare richieste bloccate e interruzioni. L'approccio consigliato è creare un nuovo cluster nel parco risorse in cui devono risiedere i carichi di lavoro, quindi spostare i carichi di lavoro dal cluster precedente a quello nuovo.
Annulla la registrazione di un cluster
gcloud
Annulla la registrazione di un cluster GKE
Questo comando può essere utilizzato solo per annullare la registrazione dei cluster GKE registrati utilizzando gcloud container clusters update o gcloud container clusters create.
[MEMBERSHIP_NAME] è il nome dell'abbonamento che corrisponde al tuo
cluster. Per elencare tutti gli abbonamenti sull'hub, esegui: gcloud container fleet memberships list.
[GKE_URI] è l'URI del cluster GKE,
ad esempio: "https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster".
Puoi ottenere l'URI eseguendo gcloud container clusters list --uri.
L'URI fornito verrà convalidato per verificare che sia mappato al cluster GKE valido.
[GKE_CLUSTER] è il location/name del
cluster GKE. La località può essere una zona o una regione,
ad esempio: us-central1-a/my-cluster.
Annulla la registrazione di un cluster collegato
Queste istruzioni si applicano ai cluster registrati utilizzando l'ultima versione della funzionalità dei cluster collegati. I cluster collegati utilizzando la generazione precedente e obsoleta di questa funzionalità devono utilizzare il comando legacy nella sezione successiva.
[MEMBERSHIP_NAME] è il nome dell'abbonamento che corrisponde al tuo
cluster. Per ottenere l'elenco di tutti gli abbonamenti sull'hub, esegui:
gcloud container fleet memberships list.
[KUBECONFIG_PATH] è il percorso locale in cui è archiviato il file kubeconfig contenente una voce per il cluster.
Per impostazione predefinita, questo percorso sarà $KUBECONFIG se è impostata questa variabile di ambiente,
altrimenti sarà $HOME/.kube/config.
[KUBECONFIG_CONTEXT] è il contesto del cluster così come
appare nel file kubeconfig. Puoi ottenere questo valore dalla riga di comando eseguendo kubectl config current-context.
Console
Annulla la registrazione di un cluster GKE su Google Cloud
Per annullare la registrazione di un cluster GKE:
Vai alla pagina Cluster GKE. Questa
pagina mostra tutti i tuoi cluster.
Seleziona il progetto Google Cloud in cui si trova il cluster.
Fai clic sul nome del cluster che vuoi scollegare, poi seleziona
Visualizza altri dettagli nel riquadro laterale.
Nella parte superiore della finestra, fai clic su delete
Elimina.
Quando ti viene chiesto di confermare, inserisci il nome del cluster e fai clic su Conferma.
Terraform
Per annullare la registrazione di un cluster GKE registrato utilizzando Terraform:
Elimina il seguente blocco dalla configurazione della risorsa google_container_cluster del cluster:
fleet {
project = "FLEET_HOST_PROJECT""
}
FLEET_HOST_PROJECT è l'ID progetto Google Cloud a cui è registrato il cluster.
Gestisci l'agente Connect
I seguenti passaggi si applicano solo alla registrazione dei cluster collegati, in cui l'agente Connect è installato sul cluster nell'ambito della registrazione.
(Facoltativo) Verifica che lo spazio dei nomi dell'agente Connect sia stato eliminato
Dopo aver annullato la registrazione di un cluster, puoi verificare che lo spazio dei nomi utilizzato dall'agente
Connect sia stato eliminato. Questo vale solo per le registrazioni che installano l'agente Connect. Per farlo, esegui:
kubectl get ns -l hub.gke.io/project
Se questo comando non restituisce alcun output, lo spazio dei nomi è già stato eliminato.
Elimina il service account dell'agente di connessione
Se hai creato un account di servizio per l'agente Connect, puoi eliminarlo nel seguente modo:
gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]
Annulla la registrazione di un cluster non disponibile
Se vuoi annullare la registrazione di un cluster a cui non puoi più accedere, segui
questi passaggi:
Elenca i cluster (ovvero le iscrizioni) attualmente registrati:
gcloud container fleet memberships list
Nell'output del comando, la colonna Name elenca i nomi dei membri dei cluster registrati e la colonna EXTERNAL_ID elenca gli UID dei cluster dello spazio dei nomi kube-system.
Per annullare la registrazione di un cluster non disponibile, esegui questo comando:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-01 UTC."],[],[],null,["This 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\ngcloud\n\nUnregister 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\nUnregister 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\nUnregister 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\nUnregister 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\nConsole\n\nUnregister 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\nUnregister 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\nTerraform\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\nThe following steps apply only to unregistering attached clusters, where the Connect Agent is installed on the cluster as part of registration.\n\nOptional: 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\nDelete 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\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."]]
