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

Esta página le muestra cómo resolver problemas relacionados con la instalación o actualización de GKE en Azure.

Si necesita ayuda adicional, comuníquese con Atención al cliente de Cloud .

Errores en la creación de clústeres

Al solicitar la creación de un clúster, GKE en Azure primero ejecuta un conjunto de pruebas previas al lanzamiento para verificar la solicitud. Si la creación del clúster falla, puede deberse a que una de estas pruebas previas falló o a que un paso del proceso de creación del clúster no se completó.

Si una prueba previa al vuelo falla, el clúster no crea ningún recurso y le devuelve directamente la información del error. Por ejemplo, si intenta crear un clúster con el nombre invalid%%%name , la prueba previa al vuelo para un nombre de clúster 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 del clúster también puede fallar después de que se hayan superado las pruebas previas al vuelo. Esto puede ocurrir varios minutos después de que haya comenzado la creación del clúster, después de que GKE en Azure haya creado recursos en Google Cloud y Azure. En este caso, existirá un recurso de Azure en su Google Cloud proyecto con su estado establecido en ERROR .

Para obtener detalles sobre la falla, ejecute el siguiente comando:

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

Reemplace lo siguiente:

  • CLUSTER_NAME con el nombre del clúster cuyo estado estás consultando
  • GOOGLE_CLOUD_LOCATION con el nombre de la Google Cloud región que administra este clúster de Azure

Como alternativa, puede obtener detalles sobre la falla de creación al describir el recurso Operation asociado con la llamada API de creación de clúster.

gcloud container azure operations describe OPERATION_ID

Reemplace OPERATION_ID con el ID de la operación que creó el clúster. Si no tiene el ID de la operación de su solicitud de creación del clúster, puede obtenerlo con el siguiente comando:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

Utilice la marca de tiempo o la información relacionada para identificar la operación de creación de clúster de interés.

Errores de actualización del clúster

Al actualizar un clúster, al igual que al crear uno nuevo, GKE en Azure ejecuta primero un conjunto de pruebas previas al lanzamiento para verificar la solicitud. Si la actualización del clúster falla, puede deberse a que una de estas pruebas previas falló o a que un paso del proceso de actualización no se completó.

Si una prueba previa al vuelo falla, el clúster no actualiza ningún recurso y le devuelve directamente la información del error. Por ejemplo, si intenta actualizar un clúster para usar un par de claves SSH llamado test_ec2_keypair , la prueba previa al vuelo intenta obtener el par de claves EC2, pero falla y la solicitud devuelve 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 del clúster también pueden fallar después de que se hayan superado las pruebas previas al vuelo. Esto puede ocurrir varios minutos después de que haya comenzado la actualización del clúster y el recurso de Azure en su Google Cloud El proyecto tiene su estado establecido en DEGRADED .

Para obtener detalles sobre la falla y la operación relacionada, siga los pasos descritos en Fallas de creación de clúster .

¿Qué sigue?