Solucionar problemas de creación o actualización de clústeres

En esta página se explica cómo resolver problemas relacionados con la instalación o la actualización de GKE en Azure.

Si necesitas más ayuda, ponte en contacto con el servicio de atención al cliente de Cloud.

Fallos en la creación de clústeres

Cuando haces una solicitud para crear un clúster, GKE en Azure primero ejecuta un conjunto de pruebas previas para verificar la solicitud. Si falla la creación del clúster, puede deberse a que no se haya superado una de estas pruebas previas o a que no se haya completado un paso del proceso de creación del clúster.

Si una prueba previa al vuelo falla, el clúster no crea ningún recurso y te devuelve información sobre el error directamente. Por ejemplo, si intentas crear un clúster con el nombre invalid%%%name, la prueba previa para comprobar si el nombre del clúster es válido falla y la solicitud devuelve el siguiente error:

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 creación de clústeres también puede fallar después de que se hayan superado las pruebas previas. Esto puede ocurrir varios minutos después de que se haya iniciado la creación del clúster, una vez que GKE en Azure haya creado recursos en Google Cloud y Azure. En este caso, habrá un recurso de Azure en tu proyecto con el estado ERROR. Google Cloud

Para obtener información sobre el error, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • CLUSTER_NAME con el nombre del clúster cuyo estado quieres consultar
  • GOOGLE_CLOUD_LOCATION con el nombre de la Google Cloud región que gestiona este clúster de Azure

También puedes obtener información sobre el error de creación describiendo el recurso Operation asociado a la llamada a la API de creación de clústeres.

gcloud container azure operations describe OPERATION_ID

Sustituye OPERATION_ID por el ID de la operación que ha creado el clúster. Si no tienes el ID de operación de tu solicitud de creación de clúster, puedes obtenerlo con el siguiente comando:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

Usa la marca de tiempo o la información relacionada para identificar la operación de creación del clúster que te interese.

Errores de actualización del clúster

Cuando actualizas un clúster, al igual que cuando creas uno nuevo, GKE en Azure primero ejecuta una serie de pruebas previas para verificar la solicitud. Si se produce un error en la actualización del clúster, puede deberse a que no se haya superado una de estas pruebas previas o a que no se haya completado un paso del proceso de actualización del clúster.

Si falla una prueba previa, el clúster no actualiza ningún recurso y te devuelve información sobre el error directamente. Por ejemplo, si intentas actualizar un clúster para que use un par de claves SSH con el nombre test_ec2_keypair, la prueba previa al vuelo intentará obtener el par de claves de EC2, pero no podrá hacerlo y la solicitud devolverá el siguiente error:

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

Las actualizaciones de clústeres también pueden fallar después de que se hayan superado las pruebas previas. Esto puede ocurrir varios minutos después de que se haya iniciado la actualización del clúster y el recurso de Azure de tu proyecto tenga el estado DEGRADED. Google Cloud

Para obtener información sobre el error y la operación relacionada, sigue los pasos que se describen en Errores de creación de clústeres.

Siguientes pasos