Risoluzione dei problemi di creazione o aggiornamento dei cluster

Questa pagina mostra come risolvere i problemi relativi all'installazione o all'upgrade di GKE su Azure.

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

Errori di creazione del cluster

Quando effettui una richiesta di creazione di un cluster, GKE su Azure esegue innanzitutto una serie di test preflight per verificare la richiesta. Se la creazione del cluster non riesce, il motivo potrebbe essere che uno di questi test preflight non è riuscito o che un passaggio della procedura di creazione del cluster non è stato completato.

Se un test preflight non riesce, il cluster non crea risorse e ti restituisce direttamente le informazioni sull'errore. Ad esempio, se provi a creare un cluster con il nome invalid%%%name, il test preflight per un nome cluster valido non riesce e la richiesta restituisce il seguente errore:

ERROR: (gcloud.container.azure.clusters.create) INVALID_ARGUMENT: must be
between 1-63 characters, valid characters are /[a-z][0-9]-/, should start with a
letter, and end with a letter or a number: "invalid%%%name",
field: azure_cluster_id

La creazione del cluster può non riuscire anche dopo il superamento dei test preflight. Questo può accadere diversi minuti dopo l'inizio della creazione del cluster, dopo che GKE su Azure ha creato risorse in Google Cloud Azure. In questo caso, nel tuo Google Cloud progetto esisterà una risorsa Azure con lo stato impostato su ERROR.

Per visualizzare i dettagli dell'errore, esegui il seguente comando:

gcloud container azure clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --format "value(state, errors)"

Sostituisci quanto segue:

  • CLUSTER_NAME con il nome del cluster di cui stai eseguendo una query sullo stato
  • GOOGLE_CLOUD_LOCATION con il nome della Google Cloud regione che gestisce questo cluster Azure

In alternativa, puoi ottenere i dettagli dell'errore di creazione descrivendo la risorsa Operation associata alla chiamata API create cluster.

gcloud container azure operations describe OPERATION_ID

Sostituisci OPERATION_ID con l'ID dell'operazione che ha creato il cluster. Se non hai l'ID operazione della richiesta di creazione del cluster, puoi recuperarlo con il seguente comando:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

Utilizza il timestamp o le informazioni correlate per identificare l'operazione di creazione del cluster di tuo interesse.

Errori di aggiornamento del cluster

Quando aggiorni un cluster, proprio come quando crei un nuovo cluster, GKE su Azure esegue innanzitutto una serie di test preflight per verificare la richiesta. Se l'aggiornamento del cluster non riesce, il motivo potrebbe essere che uno di questi test preflight non è riuscito o che un passaggio della procedura di aggiornamento del cluster non è stato completato.

Se un test preflight non riesce, il cluster non aggiorna le risorse e ti restituisce direttamente le informazioni sull'errore. Ad esempio, se provi ad aggiornare un cluster in modo che utilizzi una coppia di chiavi SSH con il nome test_ec2_keypair, il test preflight tenta di recuperare la coppia di chiavi EC2, ma non riesce e la richiesta restituisce il seguente errore:

ERROR: (gcloud.container.azure.clusters.update) INVALID_ARGUMENT: key pair
"test_ec2_keypair" not found,
field: azure_cluster.control_plane.ssh_config.ec2_key_pair

Gli aggiornamenti dei cluster possono non riuscire anche dopo il superamento dei test preflight. Questo può accadere diversi minuti dopo l'inizio dell'aggiornamento del cluster e la risorsa Azure nel tuo progetto ha lo stato impostato su Google Cloud .DEGRADED

Per visualizzare i dettagli dell'errore e dell'operazione correlata, segui i passaggi descritti in Errori di creazione del cluster.

Passaggi successivi