Risolvere i problemi relativi ai cluster registrati nell'API GKE On-Prem

Questa pagina mostra come esaminare i problemi relativi alla creazione di un cluster utente Google Distributed Cloud nella console Google Cloud .

L'API GKE On-Prem è un'API ospitata da Google Cloud che ti consente di gestire il ciclo di vita dei tuoi cluster on-premise utilizzando Terraform e gli strumentiGoogle Cloud standard. L'API GKE On-Prem viene eseguita nell'infrastruttura di Google Cloud. Terraform, la console Google Cloud e Google Cloud CLI sono client dell'API e la utilizzano per creare, aggiornare, eseguire l'upgrade ed eliminare cluster nel tuo data center. Se hai creato il cluster utilizzando un client standard, il cluster è registrato nell'API GKE On-Prem, il che significa che puoi utilizzare i client standard per gestire il ciclo di vita del cluster (con alcune eccezioni).

Errori di creazione del cluster

Questa sezione descrive alcuni errori che si verificano durante la creazione del cluster nella consoleGoogle Cloud .

Errore: la risorsa esiste già

La creazione del cluster utente non riesce e viene visualizzato un messaggio di errore simile al seguente:

Resource 'projects/1234567890/[...]/user-cluster1'
already exists
Request ID: 129290123128705826

Questo messaggio di errore indica che il nome del cluster è già in uso.

Una soluzione per risolvere il problema è eliminare e ricreare il cluster:

  1. Elimina il cluster.
  2. Crea di nuovo il cluster con un altro nome che non sia in conflitto con un cluster esistente.

Errore relativo agli indirizzi IP in conflitto

La creazione del cluster utente non riesce e viene visualizzato un messaggio di errore simile al seguente:

- Validation Category: Network Configuration
- [FAILURE] CIDR, VIP and static IP (availability and overlapping): user: user
  cluster control plane VIP "10.251.133.132" overlaps with
  example-cluster1/control plane VIP "10.251.133.132"

Non puoi modificare campi come VIP del control plane e VIP Ingress nella sezione Bilanciatore del carico della pagina Dettagli cluster nella consoleGoogle Cloud . Per risolvere il problema degli indirizzi IP in conflitto, elimina e ricrea il cluster:

  1. Elimina il cluster.
  2. Crea di nuovo il cluster con indirizzi IP che non siano in conflitto con un cluster esistente.

Rimuovere i cluster non integri

Un cluster può trovarsi in uno stato non integro per molti motivi, ad esempio:

  • Problemi di connettività con Connect Agent o l'ambiente on-premise.
  • Il cluster di amministrazione per un cluster utente è stato eliminato o si sono verificati problemi di connettività tra i cluster di amministrazione e utente.

Se la console non è in grado di eliminare un cluster, utilizza i comandi gcloud CLI per eliminare le risorse Google Cloud dai cluster non integri. Se non hai aggiornato gcloud CLI di recente, esegui questo comando per aggiornare i componenti:

gcloud components update

Poi elimina le risorse Google Cloud .

Cluster utente

  1. Elimina il cluster utente:

    gcloud container bare-metal clusters delete USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --force \
  --allow-missing \
  --ignore-errors

    Sostituisci quanto segue:

    • USER_CLUSTER_NAME: il nome del cluster utenti da eliminare.

    • PROJECT_ID: l'ID del progetto a cui è registrato il cluster.

    • REGION: la Google Cloud posizione associata al cluster utente. La posizione viene visualizzata nella console.

      Il flag --force elimina un cluster con node pool. Senza il flag --force, devi prima eliminare i pool di nodi e poi eliminare il cluster.

      Il flag --allow-missing consente al comando di continuare se il cluster non viene trovato.

      Il flag --ignore-errors rimuove le risorse Google Cloud quando i cluster di amministrazione e utente non sono raggiungibili.

      Questo comando elimina il cluster se esiste e rimuove sia le risorse dell'API GKE On-Prem sia quelle di appartenenza al parco risorse da Google Cloud.

  2. Conferma che le risorse dell'API GKE On-Prem sono state eliminate:

    gcloud container bare-metal clusters list \
  --project=PROJECT_ID \
  --location=-

    Quando imposti --location=-, significa elencare tutti i cluster in tutte le regioni. Se devi ridurre l'elenco, imposta --location su una regione specifica.

  3. Verifica che le risorse di appartenenza al parco auto siano state eliminate:

    gcloud container fleet memberships list \
  --project=PROJECT_ID

Cluster di amministrazione

  1. Se hai registrato il cluster di amministrazione nell'API GKE On-Prem, annulla la registrazione:

    gcloud container bare-metal 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.
    • REGION: la Google Cloud regione.

    Il flag --allow-missing annulla la registrazione del cluster se non viene trovata l'appartenenza al parco risorse.

    Il flag --ignore-errors rimuove le risorseGoogle Cloud quando i cluster di amministrazione e utente non sono raggiungibili.

    Questo comando rimuove le risorse dell'API GKE On-Prem da Google Cloud.

  2. Rimuovi il cluster dal parco risorse:

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

    Questo comando rimuove le risorse di appartenenza al parco risorse da Google Cloud.

  3. Conferma che le risorse dell'API GKE On-Prem sono state eliminate:

    gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID

    Quando imposti --location=-, significa elencare tutti i cluster in tutte le regioni. Se devi ridurre l'elenco, imposta --location su una regione specifica.

  4. Verifica che le risorse di appartenenza al parco auto siano state eliminate:

    gcloud container fleet memberships list \
  --project=PROJECT_ID

Passaggi successivi

Se hai bisogno di ulteriore assistenza, contatta l'assistenza clienti Google Cloud. Puoi anche consultare la sezione Richiedere assistenza per ulteriori informazioni sulle risorse di assistenza, tra cui:

  • Requisiti per l'apertura di una richiesta di assistenza.
  • Strumenti per aiutarti a risolvere i problemi, ad esempio la configurazione dell'ambiente, i log e le metriche.
  • Componenti supportati.