Annullamento della registrazione di un cluster

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 connessione al parco risorse viene rimossa, ma il cluster rimane. L'eliminazione di un cluster GKE registrato su Google Cloud tramite la console Google Cloud o gcloud CLI comporta anche l'eliminazione dell'appartenenza al parco risorse del cluster.

Puoi annullare la registrazione dei cluster GKE su Google Cloud di terze parti. 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, in quanto può comportare comportamenti imprevisti o indesiderati: ad esempio, l'identità del carico di lavoro del parco risorse dei tuoi carichi di lavoro cambierà, con potenziali richieste bloccate e interruzioni del servizio. 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.

Annullare la registrazione di un cluster

gcloud

Annullare 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'abbonamento che corrisponde al tuo in un cluster Kubernetes. Per elencare tutte le iscrizioni 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.
  • [GKE_CLUSTER] è il location/name del cluster GKE. La località può essere una zona o una regione, ad esempio us-central1-a/my-cluster.

Annullare la registrazione di un cluster collegato

Queste istruzioni si applicano ai cluster registrati utilizzando la versione più recente della nostra funzionalità dei cluster collegati. I cluster collegati utilizzando la generazione precedente deprecata di questa funzionalità devono utilizzare il comando precedente nella sezione successiva.

Annullare la registrazione di un cluster collegato (comando precedente)

Se hai registrato un cluster utilizzando la generazione precedente di cluster collegati, esegui il seguente 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'abbonamento che corrisponde al tuo in un cluster Kubernetes. Per ottenere l'elenco di tutti gli abbonamenti nell'hub, esegui: gcloud container fleet memberships list.
  • [KUBECONFIG_PATH] è il percorso locale in cui è archiviato il file kubeconfig contenente una voce per il file del cluster. Il valore predefinito è $KUBECONFIG se la variabile di ambiente è impostata, altrimenti il valore predefinito è $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] è il contesto del cluster così come nel file kubeconfig. Puoi recuperare questo valore dalla riga di comando eseguendo kubectl config current-context.

Console

Annullare la registrazione di un cluster GKE su Google Cloud

Per annullare la registrazione di un cluster GKE:

  1. Vai alla pagina Cluster GKE. Questa pagina mostra tutti i tuoi cluster.

    Vai alla pagina Cluster GKE

  2. Fai clic su Azioni accanto al cluster nell'elenco per cui vuoi annullare la registrazione.

  3. Nel menu Azioni, seleziona Disregistrazione.

  4. Nella finestra di dialogo visualizzata, digita il nome del cluster e fai clic su Disregistra per confermare l'azione.

Annullare la registrazione di un cluster di terze parti collegato

Per annullare la registrazione di un cluster collegato:

  1. Nella console Google Cloud, vai ai cluster Google Kubernetes Engine Panoramica.

    Vai ai cluster GKE

  2. Seleziona il progetto Google Cloud in cui si trova il cluster.

  3. Fai clic sul nome del cluster da scollegare e seleziona Visualizza altri dettagli nel riquadro laterale.

  4. Nella parte superiore della finestra, fai clic su Elimina.

  5. 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 seguente blocco dalla configurazione delle risorse 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 passaggi seguenti si applicano solo all'annullamento della registrazione dei cluster collegati, in cui l'agente Connect è installato nel cluster come parte 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 per le registrazioni che installano solo 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 Connect Agent

Se hai creato un account di servizio per l'agente di connessione, puoi eliminarlo nel seguente modo:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Annullare la registrazione di un cluster non disponibile

Se vuoi annullare la registrazione di un cluster a cui non puoi più accedere, svolgi i seguenti passaggi:

  1. Elenca i cluster (ovvero appartenenze) attualmente registrati:

    gcloud container fleet memberships list

    Nell'output comando, la colonna Name elenca i nomi delle appartenenze registrate cluster e nella colonna EXTERNAL_ID sono elencati i cluster UID del sistema kube-system nello spazio dei nomi.

  2. 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 che corrisponde al tuo cluster.