Annullamento della registrazione di un cluster

In questa pagina viene descritto come annullare manualmente la registrazione di un cluster da un Google Cloud parco risorse. 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 o gcloud CLI elimina anche l'appartenenza al parco risorse del cluster. Google Cloud

Puoi annullare la registrazione solo dei cluster GKE su Google Cloud e dei cluster di terze parti collegati. Non è possibile annullare la registrazione di altri tipi di cluster.

Tieni presente che lo spostamento dei cluster registrati tra i parchi risorse (annullamento della registrazione e nuova registrazione) non è consigliato, in quanto può causare comportamenti imprevisti o indesiderati: ad esempio, la Workload Identity del parco risorse dei tuoi carichi di lavoro cambierà, con la conseguente possibilità di bloccare le richieste e causare 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.

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 progetto. Google Cloud Scopri come trovare questo valore.
  • [MEMBERSHIP_NAME] è il nome dell'appartenenza che corrisponde al tuo cluster. Per elencare tutte le appartenenze 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 esegue il mapping 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 nostra funzionalità dei cluster collegati. I cluster collegati utilizzando la generazione precedente obsoleta 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 generazione precedente di 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 progetto. Google Cloud Scopri come trovare questo valore.
  • [MEMBERSHIP_NAME] è il nome dell'appartenenza che corrisponde al tuo cluster. Per ottenere l'elenco di tutte le appartenenze nell'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:

  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 di cui vuoi annullare la registrazione.

  3. Nel menu Azioni, seleziona Annulla registrazione.

  4. Nella finestra di dialogo visualizzata, digita il nome del cluster e fai 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:

  1. Nella Google Cloud console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.

    Vai ai cluster GKE

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

  3. Fai clic sul nome del cluster che vuoi scollegare, quindi 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 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' Google Cloud ID progetto in cui è registrato il cluster.

Gestisci l'agente Connect

I seguenti passaggi si applicano solo all'annullamento della registrazione dei cluster collegati, in cui l'agente Connect viene 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 Connect

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 hai più accesso, segui questi passaggi:

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

    gcloud container fleet memberships list

    Nell'output del comando, la colonna Name elenca i nomi delle appartenenze dei cluster registrati e la colonna EXTERNAL_ID elenca gli UID dei cluster dello spazio dei nomi kube-system.

  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 a il tuo cluster.