Questa pagina descrive come annullare manualmente la registrazione di un cluster da un parco risorse Google Cloud. Quando annulli manualmente la registrazione di un cluster, la relativa 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 al parco risorse del cluster.
Puoi annullare la registrazione dei cluster GKE su Google Cloud e solo dei cluster di terze parti collegati. Non è possibile annullare la registrazione di altri tipi di cluster.
Tieni presente che lo spostamento dei cluster registrati da un parco risorse all'altro (annullamento della registrazione e nuova registrazione) non è consigliato perché ciò può causare comportamenti imprevisti o indesiderati. Ad esempio, Workload Identity del parco di carichi di lavoro cambierà, causando potenzialmente il blocco di richieste e interruzioni del servizio. L'approccio consigliato consiste nel 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
.
Esegui questo comando:
gcloud container clusters update CLUSTER_NAME --clear-fleet-project
Sostituisci CLUSTER_NAME con il nome del cluster che vuoi eliminare.
Annulla la registrazione di un cluster GKE (comando legacy)
Se hai registrato un cluster utilizzando il comando register
precedente, esegui uno dei seguenti comandi per annullarne la registrazione:
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]
dove:
- [PROJECT_ID] è l'ID del tuo progetto Google Cloud. Scopri come trovare questo valore.
- [MEMBERSHIP_NAME] è il nome dell'appartenenza corrispondente al cluster. Per elencare tutti gli abbonamenti nell'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 confermare che sia mappato al cluster GKE valido. - [GKE_CLUSTER] è la
location/name
del cluster GKE. La località può essere una zona o una regione, ad esempious-central1-a/my-cluster
.
Annulla la registrazione di un cluster collegato
Queste istruzioni si applicano ai cluster registrati utilizzando la versione più recente della nostra funzionalità per i cluster collegati. I cluster collegati tramite la generazione precedente deprecata di questa funzionalità devono utilizzare il comando legacy nella sezione successiva.
Annulla la registrazione di un cluster collegato (comando legacy)
Se hai registrato un cluster utilizzando la precedente generazione dei cluster collegati, esegui questo comando per annullarne la registrazione:
gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \ --project=[PROJECT_ID] \ --context=[KUBECONFIG_CONTEXT] \ --kubeconfig=[KUBECONFIG_PATH]
dove:
- [PROJECT_ID] è l'ID del tuo progetto Google Cloud. Scopri come trovare questo valore.
- [MEMBERSHIP_NAME] è il nome dell'appartenenza corrispondente al cluster. Per ottenere l'elenco di tutti gli abbonamenti nell'hub, esegui:
gcloud container fleet memberships list
. - [KUBECONFIG_PATH] è il percorso locale in cui è archiviato
kubeconfig contenente una voce per il file del cluster.
Il valore predefinito è
$KUBECONFIG
se è impostata la variabile di ambiente, altrimenti è$HOME/.kube/config
. - [KUBECONFIG_CONTEXT] è il contesto del cluster
come viene visualizzato 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
Puoi annullare la registrazione dei cluster GKE su Google Cloud dalla console Google Cloud solo utilizzando le pagine Anthos legacy. L'annullamento della registrazione dalla pagina dei cluster GKE non è supportata.
Per annullare la registrazione di un cluster GKE:
Vai alla pagina Cluster Anthos. Questa pagina mostra tutti i cluster registrati.
Seleziona dall'elenco il cluster di cui vuoi annullare la registrazione. Viene visualizzato un riquadro dei dettagli.
Nel riquadro dei dettagli, fai clic su Annulla registrazione.
Nella finestra di dialogo visualizzata, fai di nuovo clic su Annulla registrazione per confermare l'azione.
Annulla la registrazione di un cluster di terze parti collegato
Per annullare la registrazione di un cluster collegato:
Nella console Google Cloud, vai alla pagina della panoramica dei cluster di Google Kubernetes Engine.
Seleziona il progetto Google Cloud in cui si trova il cluster.
Fai clic sul nome del cluster che vuoi scollegare, quindi seleziona Visualizza altri dettagli nel riquadro laterale.
Nella parte superiore della finestra, fai clic su
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 che hai registrato utilizzando Terraform:
Elimina il blocco seguente dalla configurazione delle risorse google_container_cluster
del cluster:
fleet {
project = "FLEET_HOST_PROJECT"
"
}
FLEET_HOST_PROJECT
è l'ID progetto Google Cloud in cui è registrato il cluster.
Gestisci l'agente Connect
I passaggi seguenti si applicano solo all'annullamento della registrazione dei cluster collegati, in cui l'agente Connect è installato sul cluster durante la registrazione.
(Facoltativo) Verifica che lo spazio dei nomi agente Connect sia 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 l'account di servizio dell'agente Connect
Se hai creato un account di servizio per l'agente Connect, puoi eliminarlo come segue:
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 (chiamati anche appartenenze) attualmente registrati:
gcloud container fleet memberships list
Nell'output comando, la colonna
Name
elenca i nomi delle appartenenze dei cluster registrati, mentre la colonnaEXTERNAL_ID
elenca gli UID dei cluster dello spazio dei nomi kube-system.Per annullare la registrazione di un cluster non disponibile, esegui questo comando:
gcloud container fleet memberships delete [MEMBERSHIP_NAME]
dove [MEMBERSHIP_NAME] è il nome dell'appartenenza corrispondente al tuo cluster.