Eliminazione di un cluster utente

In questa pagina viene descritto come eliminare un utente Google Distributed Cloud in un cluster Kubernetes. L'eliminazione del cluster utente annulla la registrazione del cluster dal parco risorse elimina carichi di lavoro, pool di nodi, nodi del piano di controllo e ad esempio VM, partizioni F5 e dischi dati.

Scegli uno strumento per eliminare un cluster

La modalità di eliminazione di un cluster utente dipende dalla sua registrazione o meno nella l'API GKE On-Prem. Un cluster utente è registrato nell'API GKE On-Prem se uno dei che segue è vero:

  • Il cluster è stato creato utilizzando la console Google Cloud e Google Cloud CLI (gcloud CLI) o Terraform, che registra automaticamente nell'API GKE On-Prem. Collettivamente, queste applicazioni standard noti come 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, usa un'API GKE On-Prem per eliminare il cluster. Se il cluster non è registrato nel L'API GKE On-Prem, usa gkectl sulla workstation di amministrazione per eliminare il cluster.

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

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

La configurazione di --location=- comporta l'elenco di tutti i cluster in tutte le regioni. Se hai bisogno di restringere l'ambito dell'elenco, puoi impostare --location su una specifica region.

Se il cluster è presente nell'elenco, è registrato nell'API GKE On-Prem. In caso contrario proprietario del progetto, devi disporre almeno di Identity and Access Management il ruolo roles/gkeonprem.admin nel progetto per eliminare i cluster registrati. Per sulle autorizzazioni incluse in questo ruolo, consulta Ruoli dell'API GKE On-Prem nella documentazione di IAM.

Elimina carichi di lavoro stateful

Prima di eliminare il cluster, elimina i carichi di lavoro stateful, le richieste PVC e i volumi permanenti con kubectl delete.

Eliminazione di un cluster utente

Gkectl

Puoi utilizzare gkectl per eliminare i cluster che non sono registrati nell' l'API GKE On-Prem. Se le regole del proxy e del firewall della tua organizzazione consentono traffico per raggiungere gkeonprem.googleapis.com e gkeonprem.mtls.googleapis.com (i nomi dei servizi per l'API GKE On-Prem), allora 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 dell'amministratore kubeconfig del cluster.
  • CLUSTER_NAME è il nome del cluster utente che vuoi da 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 è registrato, ma gkectl non è riuscito a raggiungere il l'API GKE On-Prem. In questo caso, la cosa più semplice è utilizzare una all'API GKE On-Prem per eliminare il cluster.

Se l'eliminazione del cluster utente non riesce a metà, puoi eseguire gkectl con --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 eliminare il cluster:

  1. Nella console, vai alla panoramica dei cluster 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 Tipo è external, indica che il cluster è stato creato utilizzando gkectl e non è stato registrato per l'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 indicati. nella scheda gcloud CLI per eliminare il cluster. Dovrai aggiungi il flag --ignore-errors al comando delete.

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

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

  6. Quando ti viene richiesta una conferma, 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 le operazioni seguenti in una computer su cui è installato gcloud CLI:

  1. Aggiorna i componenti:

    gcloud components update

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

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

    Sostituisci quanto segue:

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

    • LOCATION: la località di Google Cloud associata a per il cluster utente.

    L'output è simile al seguente:

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

  3. Utilizza il comando seguente 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 che in cui è registrato il cluster.

    • LOCATION: la località di Google Cloud associata a per il cluster utente.

    Il flag --force consente di eliminare un cluster che ha pool di nodi. Senza il flag --force, devi elimina i pool di nodi per poi eliminare il cluster.

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

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

    • Se ritieni che il problema di connettività sia temporaneo, ad esempio perché di problemi di rete, attendi e riprova.

    • Se l'errore persiste, vedi Raccolta dei log dell'agente Connect per risolvere i problemi con l'agente Connect.

    • Se sai che il cluster di amministrazione è stato eliminato, o se le VM per l'amministratore o il cluster utente sono stati arrestati o sono altrimenti inaccessibile, includi il flag --ignore-errors e riprova a eseguire il comando.

Per informazioni su altri flag, consulta Riferimento dell'interfaccia a riga di comando gcloud.

Esegui la pulizia delle risorse

Se si sono verificati problemi quando hai eliminato il cluster, alcune risorse F5 o vSphere potrebbe essere rimasto. Le sezioni seguenti spiegano come rimuovere questi elementi le risorse rimaste.

Esegui la pulizia delle VM di un cluster utente in vSphere

Per verificare che le VM del cluster utente vengano eliminate, segui questi passaggi:

  1. Dal menu Navigator di sinistra di vSphere Web Client, fai clic sull'icona Host e cluster.

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

  3. Nel pool di risorse, individua le VM con il prefisso del nome dell'utente in un cluster Kubernetes. Questi sono i nodi del piano di controllo per il cluster utente. Ci sarà essere uno o tre di questi, a seconda che il cluster utente disponga di una dal piano di controllo per l'alta disponibilità.

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

  5. Nel pool di risorse, individua le VM con il prefisso del nome di un pool di nodi in del cluster utente. Questi sono i nodi worker nel cluster utente.

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

    1. Da vSphere Web Client, fai clic con il tasto destro del mouse sulla VM e seleziona Alimentazione > Spegni.

    2. Quando la VM è spenta, 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 sono ancora presenti voci, esegui seguenti passaggi:

  1. Dalla console BIG-IP di F5, nell'angolo in alto a destra, passa a la partizione del cluster utente di cui vuoi eseguire la pulizia.
  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 oggetto kubeconfig.