Risolvere i problemi relativi alla creazione o all'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 aiuto, contatta l'assistenza clienti Google Cloud.

Errori di creazione del cluster

Quando effettui una richiesta per creare un cluster, GKE su Azure esegue prima una serie di test pre-flight per verificare la richiesta. Se la creazione del cluster non va a buon fine, il motivo potrebbe essere che uno di questi test pre-flight non è riuscito o che un passaggio dello stesso processo di creazione del cluster non è stato completato.

Se un test pre-flight non va a buon fine, il cluster non crea alcuna risorsa e restituisce direttamente le informazioni sull'errore. Ad esempio, se provi a creare un cluster con il nome invalid%%%name, il test pre-flight per un nome di cluster valido non va a buon fine 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ò anche non riuscire dopo il superamento dei test pre-flight. Questo 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 progetto Google Cloud esiste una risorsa Azure con lo stato impostato su ERROR.

Per visualizzare 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 la query
  • GOOGLE_CLOUD_LOCATION con il nome della regione Google Cloud che gestisce questo cluster Azure

In alternativa, puoi ottenere i dettagli dell'errore di creazione descrivendo la risorsa Operation associata alla chiamata API di creazione del 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 che ti interessa.

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 pre-flight per verificare la richiesta. Se l'aggiornamento del cluster non va a buon fine, il motivo potrebbe essere che uno di questi test pre-flight non è riuscito o che un passaggio nello stesso processo di aggiornamento del cluster non è stato completato.

Se un test pre-flight non va a buon fine, il cluster non aggiorna nessuna risorsa e restituisce direttamente le informazioni sull'errore. Ad esempio, se provi ad aggiornare un cluster per utilizzare una coppia di chiavi SSH denominata test_ec2_keypair, il test preliminare tenta di recuperare la coppia di chiavi EC2 e ha esito negativo 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 anche non riuscire dopo il superamento dei test pre-flight. Ciò può verificarsi diversi minuti dopo l'inizio dell'aggiornamento del cluster e lo stato della risorsa Azure nel tuo progetto Google Cloud è impostato su DEGRADED.

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

Passaggi successivi