Cluster Anthos su VMware ora è Google Distributed Cloud (solo software) per VMware. 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 esaminare i problemi di 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 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 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 è 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).

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

Il cluster di amministrazione non viene visualizzato nell'elenco a discesa Impostazioni di base del cluster

Il cluster di amministrazione deve essere registrato a un parco risorse prima che tu possa creare cluster utente nella console Google Cloud. Se non vedi il cluster di amministrazione nell'elenco a discesa della sezione Nozioni di base sui cluster della console Google Cloud, il cluster di amministrazione non è stato registrato o è stato registrato utilizzando il comando gcloud container fleet memberships register. Questo comando gcloud non registra correttamente i cluster di amministrazione.

Controlla lo stato della registrazione:

Nella console Google Cloud, vai alla pagina Kubernetes Engine > Cluster e seleziona lo stesso progetto Google Cloud in cui hai tentato di creare il cluster di utenti.

Vai alla pagina dei cluster GKE
- Se il cluster di amministrazione non è visualizzato nell'elenco, consulta Registrare un cluster di amministrazione.
- Se il cluster di amministrazione è visualizzato nell'elenco, questo comportamento indica che il cluster è stato registrato utilizzando il comando gcloud container hub memberships register. Questo comando gcloud non registra correttamente i cluster di amministrazione.

Per risolvere il problema di registrazione, svolgi i seguenti passaggi:

Elimina l'appartenenza al parco risorse del cluster di amministrazione.
```
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=global
```
- ADMIN_CLUSTER_NAME: il nome del cluster di amministrazione.
- PROJECT_ID: l'ID del progetto host del parco risorse. Si tratta del progetto selezionato quando hai tentato di creare il cluster utente nella console Google Cloud.
Segui i passaggi descritti in Registrare un cluster di amministrazione per registrare di nuovo il cluster.

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 di utenti non riesce con 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 entri in conflitto con un cluster esistente.

Errore relativo ai gruppi anti-affinità

La creazione del cluster di utenti non riesce con un messaggio di errore simile al seguente:

- Validation Category: VCenter
    - [FATAL] Hosts for AntiAffinityGroups: Anti-affinity groups enabled with
    available vsphere host number 1 less than 3, please add more vsphere hosts
    or disable anti-affinity groups.

Le regole anti-affinità Distributed Resource Scheduler (DRS) di VMware richiedono almeno 3 host fisici nell'ambiente vSphere. Per risolvere il problema, disabilita Gruppi anti-affinità nella sezione Funzionalità della pagina Dettagli cluster per il tuo cluster, come segue:

Nella console Google Cloud, vai alla pagina dei cluster GKE.

Vai alla pagina dei cluster GKE
Seleziona il progetto Google Cloud in cui si trova il cluster utente.
Nell'elenco dei cluster, fai clic sul nome del cluster e poi su Visualizza dettagli nel riquadro Dettagli.
Nella sezione Funzionalità, fai clic su Modifica.
Deseleziona Attiva gruppi anti-affinità e fai clic su Fine.
La console Google Cloud mostra Stato del cluster: modifiche in corso. Fai clic su Mostra dettagli per visualizzare la condizione dello stato della risorsa e i messaggi di stato.

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 control plane 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 sono in conflitto con un cluster esistente.

Rimuovere i cluster non funzionanti

Un cluster può diventare non in stato di salute per molti motivi, ad esempio:

Problemi di connettività con l'agente Connect o con 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.
La VM del cluster è stata eliminata prima dell'eliminazione del cluster.

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

gcloud components update

Successivamente, elimina le Google Cloud risorse.

Cluster utente

Elimina il cluster utente:
```
gcloud container vmware 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 di utenti da eliminare.
- PROJECT_ID: l'ID del progetto a cui è registrato il cluster.
- REGION: la Google Cloud località associata al cluster di utenti. La posizione viene visualizzata nella console.
  
  Il flag --force elimina un cluster con pool di nodi. Senza il flag --force, devi prima eliminare i pool di nodi e poi il cluster.
  
  Il flag --allow-missing consente al comando di continuare se il cluster non viene trovato.
  
  Il flag --ignore-errors rimuove Google Cloud le risorse quando i cluster di amministrazione e utente non sono raggiungibili. Alcune risorse F5 o vSphere potrebbero essere rimaste. Per informazioni su come eseguire la pulizia delle risorse rimanenti, consulta la sezione Pulisci le risorse.
  
  Questo comando elimina il cluster, se esistente, e rimuove sia le risorse dell'API Anthos On-Prem sia le risorse dell'abbonamento del parco risorse da Google Cloud.
Verifica che le risorse dell'API GKE On-Prem siano state eliminate:
```
gcloud container vmware 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 vmware admin-clusters unenroll ADMIN_CLUSTER_NAME \
 --project=PROJECT_ID \
 --location=REGION \
 --allow-missing 
```
Sostituisci quanto segue:
- ADMIN_CLUSTER_NAME: il nome del cluster di amministrazione.
- PROJECT_ID: l'ID del progetto host del parco risorse.
- REGION: la Google Cloud regione.
Il flag --allow-missing annulla la registrazione del cluster se l'appartenenza al parco risorse non viene trovata.

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 appartenenza al parco risorse da Google Cloud.
Verifica che le risorse dell'API GKE On-Prem siano state eliminate:
```
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID
```
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
```

Passaggi successivi

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