Risolvere i problemi di creazione o aggiornamento del 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 invii una richiesta di creazione di un cluster, GKE su Azure esegue innanzitutto una serie di test pre-volo per verificare la richiesta. Se la creazione del cluster non va a buon fine, il motivo può essere il mancato superamento di uno di questi test pre-volo o il mancato completamento di un passaggio nella procedura di creazione del cluster.

Se un test pre-volo non va a buon fine, 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 pre-volo per un nome di 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. Ciò può accadere diversi minuti dopo l'inizio della creazione del cluster, dopo che GKE su Azure ha creato risorse in Google Cloud e Azure. In questo caso, nel tuo progetto Google Cloud esisterà una risorsa Azure con lo stato impostato su ERROR.

Per ottenere i dettagli dell'errore, esegui questo 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 dettagli sull'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 ne crei uno nuovo, GKE su Azure esegue prima una serie di test preflight per verificare la richiesta. Se l'aggiornamento del cluster non va a buon fine, il motivo può essere il mancato superamento di uno di questi test pre-volo o il mancato completamento di un passaggio della procedura di aggiornamento del cluster.

Se un test pre-volo non va a buon fine, il cluster non aggiorna alcuna risorsa 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 preliminare 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 del cluster possono non riuscire anche dopo il superamento dei test preflight. Ciò può verificarsi diversi minuti dopo l'inizio dell'aggiornamento del cluster e la risorsa Azure nel tuo progetto Google Cloud ha lo stato impostato su DEGRADED.

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

Passaggi successivi