Anthos clusters on bare metal è ora Google Distributed Cloud (solo software) per bare metal. Per ulteriori informazioni, consulta la panoramica del prodotto.

Questa pagina è stata tradotta dall'API Cloud Translation.

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

Questa pagina mostra come analizzare i problemi durante la creazione di un Cluster utente Google Distributed Cloud nella console Google Cloud.

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

Se hai bisogno di ulteriore assistenza, contatta l'assistenza clienti Google Cloud.

Errori di creazione del cluster

Questa sezione descrive alcuni errori che si verificano durante la creazione del cluster nella console Google 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 consiste nell'eliminare e ricreare il cluster:

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

Errore relativo a indirizzi IP in conflitto

La creazione del cluster di utenti non riesce con 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 piano di controllo e VIP di ingresso nella sezione Bilanciatore del carico della pagina Dettagli cluster nella console Google Cloud. Per correggere gli indirizzi IP in conflitto, elimina e ricrea il cluster:

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

Rimuovere i cluster non funzionanti

Un cluster può trovarsi in uno stato non integro per molti motivi, tra cui:

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

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

gcloud components update

Dopodiché, elimina le risorse Google Cloud.

Cluster utente

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 utente eliminare.
- PROJECT_ID: l'ID del progetto a cui è registrato il cluster.
- REGION: la località Google Cloud associata al cluster di utenti. La posizione viene visualizzata nella console.
  
  Il flag --force elimina un cluster che ha pool di nodi. Senza il flag --force, devi prima eliminare i pool di nodi e poi il cluster.
  
  Il flag --allow-missing consente di continuare il comando se non è stato 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 esistente, e rimuove sia l'API GKE On-Prem sia le risorse di adesione al parco risorse da Google Cloud.
Conferma che le risorse dell'API GKE On-Prem siano state eliminate:
```
gcloud container bare-metal clusters list \
  --project=PROJECT_ID \
  --location=-
```
Se imposti --location=-, vengono elencati tutti i cluster in tutte le regioni. Se devi restringere l'ambito dell'elenco, imposta --location su una regione specifica.
Verifica che le risorse di adesione al parco siano state eliminate:
```
gcloud container fleet memberships list \
  --project=PROJECT_ID
```

Cluster di amministrazione

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 risorse.
- REGION: la regione Google Cloud.
Il flag --allow-missing annulla la registrazione del cluster se l'appartenenza al parco risorse non viene trovata.

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

Questo comando rimuove le risorse dell'API GKE On-Prem da Google Cloud.
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 adesione al parco risorse da Google Cloud.
Conferma che le risorse dell'API GKE On-Prem siano state eliminate:
```
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID
```
L'impostazione di --location=- consente di elencare tutti i cluster in regioni. Se devi restringere l'ambito dell'elenco, imposta --location su un una specifica regione.
Verifica che le risorse di appartenenza del parco risorse 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.