Eliminazione di un cluster utente

Questa pagina descrive come eliminare un cluster utente GKE su VMware. L'eliminazione del cluster utente annulla la registrazione del cluster dal parco risorse ed elimina i carichi di lavoro, i pool di nodi, i nodi del piano di controllo e le risorse corrispondenti, come VM, partizioni F5 e dischi dati.

Scegli uno strumento per eliminare un cluster

La modalità di eliminazione di un cluster utente varia a seconda che il cluster sia registrato o meno nell'API GKE On-Prem. Un cluster utente viene registrato nell'API GKE On-Prem se una delle seguenti condizioni è vera:

  • Il cluster è stato creato utilizzando la console Google Cloud, Google Cloud CLI (gcloud CLI) o Terraform, che registra automaticamente il cluster nell'API GKE On-Prem. Collettivamente, queste applicazioni standard sono dette client API GKE On-Prem.

  • Il cluster è stato creato utilizzando gkectl, ma è stato registrato nell'API GKE On-Prem.

Se il cluster è registrato nell'API GKE On-Prem, utilizza un client API GKE On-Prem per eliminarlo. Se il cluster non è registrato nell'API GKE On-Prem, utilizza gkectl sulla workstation di amministrazione per eliminarlo.

Per trovare tutti i cluster utente registrati nell'API GKE On-Prem in un progetto specifico, esegui questo comando:

gcloud container vmware clusters list \
    --project=PROJECT_ID \
    --location=-

Quando imposti --location=-, significa che vengono elencati tutti i cluster in tutte le regioni. Se hai bisogno di restringere l'elenco, puoi impostare --location su una regione specifica.

Se il cluster è elencato, viene registrato nell'API GKE On-Prem. Se non sei un proprietario del progetto, devi solo disporre del ruolo di Identity and Access Management roles/gkeonprem.admin nel progetto per eliminare i cluster registrati. Per i dettagli sulle autorizzazioni incluse in questo ruolo, consulta Ruoli dell'API GKE On-Prem nella documentazione IAM.

Elimina carichi di lavoro stateful

Prima di eliminare il cluster, elimina i carichi di lavoro stateful, PVC e PV eseguendo kubectl delete.

Eliminazione di un cluster utente

Gkectl

Puoi utilizzare gkectl per eliminare i cluster non registrati nell'API GKE On-Prem. Se le regole del firewall e del proxy della tua organizzazione consentono al traffico di raggiungere gkeonprem.googleapis.com e gkeonprem.mtls.googleapis.com (i nomi dei servizi per l'API GKE On-Prem), gkectl potrà eliminare i cluster registrati.

Esegui questo comando sulla workstation di amministrazione per eliminare il cluster:

gkectl delete cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --cluster CLUSTER_NAME

dove

  • ADMIN_CLUSTER_KUBECONFIG è il percorso del file kubeconfig del cluster di amministrazione.
  • CLUSTER_NAME è il nome del cluster utente che vuoi eliminare.

Se l'eliminazione non riesce e viene visualizzato un messaggio simile al seguente:

Exit with error:
...
failed to unenroll user cluster CLUSTER_NAME
failed to create GKE On-Prem API client

Ciò significa che il cluster è stato registrato, ma gkectl non è riuscito a raggiungere l'API GKE On-Prem. In questo caso, la cosa più semplice da fare è utilizzare un client API GKE On-Prem per eliminare il cluster.

Se l'eliminazione del cluster utente non riesce a metà, puoi eseguire gkectl con il flag --force per ignorare l'errore a metà e continuare l'eliminazione.

gkectl delete cluster \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--cluster CLUSTER_NAME \
--force

Se utilizzi il bilanciatore del carico in bundle di Seesaw, elimina il bilanciatore del carico.

Console

Se il cluster utente è gestito dall'API GKE On-Prem, segui questi passaggi per eliminarlo:

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

    Vai ai cluster GKE

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

  3. Nell'elenco dei cluster, individua quello che vuoi eliminare. Se il valore Tipo è esterno, significa che il cluster è stato creato utilizzando gkectl e non è stato registrato nell'API GKE On-Prem. In questo caso, segui i passaggi nella scheda gkectl per eliminare il cluster.

    Se l'icona nella colonna Stato indica un problema, segui i passaggi nella scheda gcloud CLI per eliminare il cluster. Dovrai aggiungere il flag --ignore-errors al comando delete.

  4. Fai clic sul nome del cluster che vuoi eliminare.

  5. Nel riquadro Details, nella parte superiore della finestra, fai clic su Elimina.

  6. Quando ti viene chiesto di confermare, inserisci il nome del cluster e fai clic su Rimuovi.

Interfaccia a riga di comando gcloud

Se il cluster utente è gestito dall'API GKE On-Prem, esegui queste operazioni su un computer su cui è installato gcloud CLI:

  1. Aggiorna componenti:

    gcloud components update

  2. Ottieni un elenco di cluster per assicurarti di specificare il nome del cluster corretto nel comando di eliminazione:

    gcloud container vmware clusters list \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION

    Sostituisci quanto segue:

    • FLEET_HOST_PROJECT_ID: l'ID del progetto in cui è registrato il cluster.

    • LOCATION: la località Google Cloud associata al cluster utente.

    L'output è simile al seguente:

    NAME                      LOCATION    VERSION          ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.29.0-gke.1456    example-admin-cluster-1   RUNNING

  3. Usa questo comando per eliminare il cluster:

    gcloud container vmware clusters delete USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing

    Sostituisci quanto segue:

    • USER_CLUSTER_NAME: il nome del cluster utente da eliminare.

    • FLEET_HOST_PROJECT_ID: l'ID del progetto in cui è registrato il cluster.

    • LOCATION: la località Google Cloud associata al cluster utente.

    Il flag --force consente di eliminare un cluster che ha pool di nodi. Senza il flag --force, devi prima eliminare i pool di nodi, quindi eliminare il cluster.

    Il flag --allow-missing è un flag standard dell'API di Google. Quando includi questo flag, il comando restituisce successo se il cluster non viene trovato.

    Se il comando restituisce un errore che contiene il testo failed connecting to the cluster's control plane, questo indica problemi di connettività con il cluster di amministrazione, l'agente Connect o l'ambiente on-premise.

    • Se ritieni che il problema di connettività sia temporaneo, ad esempio a causa di problemi di rete, attendi e riprova a eseguire il comando.

    • Se l'esecuzione del nuovo comando continua a non riuscire, consulta Raccolta dei log dell'agente Connect per risolvere i problemi dell'agente Connect.

    • Se sai che il cluster di amministrazione è stato eliminato, o se le VM per il cluster utente o di amministrazione sono state arrestate o non sono accessibili in altro modo, includi il flag --ignore-errors e riprova a eseguire il comando.

Per informazioni sugli altri flag, consulta il riferimento di gcloud CLI.

Esegui la pulizia delle risorse

Se si sono verificati problemi durante l'eliminazione del cluster, alcune risorse F5 o vSphere potrebbero essere rimaste. Le seguenti sezioni spiegano come eseguire la pulizia di queste risorse rimaste.

Pulisci le VM di un cluster utente in vSphere

Per verificare che le VM del cluster utente vengano eliminate:

  1. Nel menu Navigator di sinistra del client vSphere Web, fai clic sul menu Hosts and Clusters.

  2. Trova il pool di risorse per il cluster di amministrazione. Questo è il valore di vCenter.resourcePool nel file di configurazione del cluster di amministrazione.

  3. Sotto il pool di risorse, individua le VM che contengono il nome del cluster utente come prefisso. Questi sono i nodi del piano di controllo per il cluster utente. Ce ne saranno uno o tre, a seconda che il cluster utente abbia un piano di controllo ad alta disponibilità.

  4. Trova il pool di risorse per il cluster utente. Questo è il valore di vCenter.resourcePool nel file di configurazione del cluster utente. Se il file di configurazione del cluster utente non specifica un pool di risorse, questo viene ereditato dal cluster di amministrazione.

  5. Sotto il pool di risorse, individua le VM che hanno come prefisso il nome di un pool di nodi nel tuo cluster utente. Questi sono i nodi worker nel cluster utente.

  6. Per ogni nodo del piano di controllo e ogni nodo worker:

    1. Dal client web vSphere, fai clic con il tasto destro del mouse sulla VM e seleziona Alimentazione > Spegni.

    2. Dopo aver spento la VM, fai clic con il tasto destro del mouse sulla VM e seleziona Elimina dal disco.

Esegui la pulizia della partizione F5 di un cluster utente

Se nella partizione del cluster utente rimangono delle voci, esegui questi passaggi:

  1. Dalla console BIG-IP di F5, nell'angolo in alto a destra della console, passa alla partizione del cluster utente che vuoi pulire.
  2. Seleziona Traffico locale > Server virtuali > Elenco di server virtuali.
  3. Nel menu Server virtuali, rimuovi tutti gli IP virtuali.
  4. Seleziona Pool, quindi elimina tutti i pool.
  5. Seleziona Nodi, quindi elimina tutti i nodi.

Al termine

Dopo aver eliminato il cluster, puoi eliminare il relativo kubeconfig.