Eliminazione di un cluster di amministrazione

Questa pagina descrive come eliminare un cluster di amministrazione creato con il software Google Distributed Cloud solo per VMware.

Prima di iniziare

Prima di eliminare un cluster di amministrazione, completa i seguenti passaggi:

  • Elimina i cluster utente. Consulta Eliminazione di un cluster utente.
  • Elimina dal cluster di amministrazione tutti i workload che utilizzano PodDisruptionBudgets.
  • Elimina tutti gli oggetti esterni, come i PersistentVolume, dal cluster di amministrazione.
  • Nella workstation di amministrazione, imposta una variabile di ambiente KUBECONFIG che punti al kubeconfig del cluster di amministrazione che vuoi eliminare:

    export KUBECONFIG=ADMIN_CLUSTER_KUBECONFIG
    

    dove ADMIN_CLUSTER_KUBECONFIG è il percorso del file kubeconfig del cluster di amministrazione.

  • Facoltativamente, esegui questo comando sulla workstation di amministrazione per ottenere il nome del cluster di amministrazione:

    kubectl get -n=kube-system onpremadmincluster
    

Annullamento della registrazione del cluster di amministrazione

Se il cluster di amministrazione è registrato nell'API GKE On-Prem, devi annullare la registrazione dall'API prima di eliminare qualsiasi altra risorsa del cluster. L'annullamento della registrazione del cluster rimuove le risorse dell'API GKE On-Prem da Google Cloud. Se non annulli la registrazione del cluster, questo continuerà a essere visualizzato nella consoleGoogle Cloud nella pagina Kubernetes Engine > Cluster.

Se hai creato il cluster di amministrazione utilizzando la console Google Cloud o Terraform, il cluster viene registrato automaticamente nell'API GKE On-Prem. I cluster di amministrazione creati con la versione 1.16 o successive utilizzando lo strumento a riga di comando gkectl vengono registrati automaticamente con l'API GKE On-Prem. Se il cluster di amministrazione è stato creato utilizzando gkectl con una versione precedente, viene registrato nell'API nei seguenti casi:

  1. Elenca tutti i cluster di amministrazione registrati nel tuo progetto:

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

    Sostituisci PROJECT_ID con l'ID del progetto host del parco risorse.

    Il comando restituisce il nome di ogni cluster di amministrazione registrato nell'API GKE On-Prem nel progetto, insieme alla regione Google Cloud .

    Se imposti --location=-, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'elenco, imposta --location sulla regione specificata durante la registrazione del cluster.

  2. Annulla la registrazione del cluster dall'API GKE On-Prem:

    gcloud container vmware admin-clusters unenroll  ADMIN_CLUSTER_NAME \
        --project=PROJECT_ID \
        --location=REGION \
        --allow-missing \
        --ignore-errors
    

    Sostituisci quanto segue:

    • ADMIN_CLUSTER_NAME: il nome del cluster di amministrazione.
    • PROJECT_ID: l'ID del progetto host del parco risorse.
    • REGION: la regione Google Cloud .

    Il flag --allow-missing restituisce un esito positivo se il cluster non viene trovato.

    Il flag --ignore-errors garantisce che l'annullamento della registrazione di una risorsa del cluster di amministrazione venga completato correttamente anche se si verificano errori durante l'annullamento della registrazione.

Eliminazione di logging e monitoraggio

Salta questa sezione se il tuo cluster è alla versione 1.30 o successiva. Poiché il deployment delle risorse personalizzate di logging e monitoraggio non viene eseguito sui cluster con versione 1.30 e successive, se esegui i comandi, non verrà restituito alcun risultato.

I pod di logging e monitoraggio di Google Distributed Cloud, di cui è stato eseguito il deployment da StatefulSet, utilizzano PDB che possono impedire il corretto svuotamento dei nodi. Per eliminare correttamente un cluster di amministrazione, devi eliminare questi pod.

Per eliminare i pod di logging e monitoraggio, esegui questi comandi:

kubectl delete monitoring --all -n kube-system
kubectl delete stackdriver --all -n kube-system

L'eliminazione del monitoraggio pulisce i PersistentVolume (PV) associati ai StatefulSet, ma il PersistentVolume per Stackdriver deve essere eliminato separatamente.

L'eliminazione del VP di Stackdriver è facoltativa. Se scegli di non eliminare il VP, registra la posizione e il nome del VP associato in una posizione esterna al cluster utente.

L'eliminazione del PV verrà propagata tramite l'eliminazione della richiesta di volume permanente (PVC).

Per trovare la PVC di Stackdriver, esegui questo comando:

kubectl get pvc -n kube-system

Per eliminare la PVC, esegui questo comando:

kubectl delete pvc -n kube-system PVC_NAME

Verifica della rimozione di logging e monitoraggio

Per verificare che il logging e il monitoraggio siano stati rimossi, esegui questi comandi:

kubectl get pvc -n kube-system
kubectl get statefulsets -n kube-system

Pulizia della partizione F5 di un cluster di amministrazione

Salta questa sezione se non utilizzi il bilanciatore del carico F5.

L'eliminazione dello spazio dei nomi gke-system dal cluster di amministrazione garantisce la corretta pulizia della partizione F5, consentendoti di riutilizzarla per un altro cluster di amministrazione.

Per eliminare lo spazio dei nomi gke-system, esegui questo comando:

kubectl delete ns gke-system

Quindi, elimina tutti i servizi rimanenti di tipo LoadBalancer. Per elencare tutti i servizi, esegui questo comando:

kubectl get services --all-namespaces

Elimina ogni servizio di tipo LoadBalancer eseguendo questo comando:

kubectl delete service SERVICE_NAME -n SERVICE_NAMESPACE

Poi, dalla console BIG-IP di F5:

  1. Nell'angolo in alto a destra della console, passa alla partizione da pulire.
  2. Seleziona Local Traffic (Traffico locale) > Virtual Servers (Server virtuali) > Virtual Server List (Elenco server virtuali).
  3. Nel menu Virtual Servers (Server virtuali), rimuovi tutti gli IP virtuali.
  4. Seleziona Pool, quindi elimina tutti i pool.
  5. Seleziona Nodi, quindi elimina tutti i nodi.

Verifica che la partizione F5 sia pulita

Interfaccia a riga di comando

Verifica che il VIP non sia attivo eseguendo questo comando:

ping -c 1 -W 1 F5_LOAD_BALANCER_IP; echo $?

che restituirà 1 se il VIP non è attivo.

UI di F5

Per verificare che la partizione sia stata ripulita dall'interfaccia utente di F5, segui questi passaggi:

  1. Nell'angolo in alto a destra, fai clic sul menu a discesa Partizione. Seleziona la partizione del cluster di amministrazione.
  2. Dal menu Main (Principale) a sinistra, seleziona Local Traffic (Traffico locale) > Network Map (Mappa di rete). Sotto la mappa della rete di traffico locale non deve essere elencato nulla.
  3. In Local Traffic > Virtual Servers, seleziona Nodes, quindi seleziona Nodes List. Anche in questo caso, non dovrebbe essere elencato nulla.

Se rimangono voci, eliminale manualmente dalla UI.

Spegnimento delle macchine dei nodi di amministrazione

Innanzitutto, esegui questo comando per ottenere i nomi delle macchine prima di spegnerle.

kubectl get machines -o wide

L'output elenca i nomi delle macchine. Ora puoi trovarli nell'interfaccia utente di vSphere.

Per eliminare le macchine dei nodi del control plane di amministrazione, devi spegnere ciascuna delle VM di amministrazione rimanenti nel pool di risorse vSphere.

UI vSphere

Segui questi passaggi:

  1. Dal menu vSphere, seleziona la VM dal pool di risorse vSphere.
  2. Nella parte superiore del menu della VM, fai clic su Azioni.
  3. Seleziona Alimentazione > Spegni. Lo spegnimento della VM potrebbe richiedere alcuni minuti.

Eliminazione delle macchine dei nodi di amministrazione

Dopo aver spento la VM, puoi eliminarla.

UI di vSphere

Segui questi passaggi:

  1. Dal menu vSphere, seleziona la VM dal pool di risorse vSphere.
  2. Nella parte superiore del menu della VM, fai clic su Azioni.
  3. Fai clic su Elimina dal disco.

Eliminazione del disco dati

Dopo aver eliminato le VM, puoi eliminare il disco dati. I passaggi variano leggermente a seconda che tu abbia un cluster di amministrazione ad alta affidabilità (HA) o non HA.

Segui questi passaggi nell'interfaccia utente di vSphere:

Non HA

  1. Dal menu vSphere, seleziona il disco dati dal datastore come specificato nel campo vCenter.dataDisk nel file di configurazione del cluster di amministrazione.
  2. Al centro del menu del datastore, fai clic su Elimina.

HA

I percorsi dei dischi dati per le tre macchine del control plane di amministrazione vengono generati automaticamente in /anthos/ADMIN_CLUSTER/default/, ad esempio:

/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-0-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-1-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-2-data.vmdk

Per eliminare ogni disco dati, segui questi passaggi:

  1. Dal menu vSphere, seleziona il disco dati dal datastore.
  2. Al centro del menu del datastore, fai clic su Elimina.

Eliminazione del file checkpoint.yaml

Se stai eliminando un cluster di amministrazione ad alta affidabilità, salta questo passaggio perché i cluster di amministrazione ad alta affidabilità non supportano il file di checkpoint.

Il file DATA_DISK_NAME-checkpoint.yaml, dove DATA_DISK_NAME è il nome del disco dati, si trova nella stessa cartella del disco dati. Elimina questo file.

Annullamento della registrazione del cluster di amministrazione

Quando crei un cluster di amministrazione, questo viene registrato automaticamente in un parco risorseGoogle Cloud . Devi annullare la registrazione del cluster dopo aver eliminato le macchine dei nodi di amministrazione, altrimenti un controller nel cluster lo registrerà di nuovo automaticamente.

L'annullamento della registrazione del cluster rimuove le risorse di appartenenza al parco risorse daGoogle Cloud. Se non annulli la registrazione del cluster, questo continuerà a essere visualizzato nella console Google Cloud nella pagina Kubernetes Engine > Cluster.

  1. Esegui questo comando e prendi nota della località:

    gcloud container fleet memberships list \
        --project=PROJECT_ID
    
  2. Esegui questo comando per eliminare l'appartenenza al parco risorse, annullando la registrazione del cluster:

    gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
        --project=PROJECT_ID \
        --location=MEMBERSHIP_REGION
    

    Sostituisci MEMBERSHIP_REGION con la località restituita dal comando gcloud container fleet memberships list. Potrebbe essere global o una regione Google Cloud .

Al termine

Dopo aver completato l'eliminazione del cluster di amministrazione, elimina il relativo kubeconfig.