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

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

Si necesitas asistencia adicional, comunícate con Atención al cliente de Cloud.

Errores de creación de clústeres

Cuando realizas una solicitud para crear un clúster, GKE en Azure primero ejecuta un conjunto de pruebas previas 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 preliminar falla, tu clúster no crea ningún recurso y te muestra información sobre el error directamente. Por ejemplo, si intentas crear un clúster con el nombre invalid%%%name, la prueba preliminar para un nombre de clúster válido fallará y la solicitud mostrará 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 aprueben las pruebas preliminares. Esto puede ocurrir varios minutos después de que comenzara la creación del clúster, después de que los clústeres de GKE en Azure hayan creado recursos en Google Cloud y en Azure. En este caso, existirá un recurso de Azure en tu proyecto de Google Cloud con su estado configurado como ERROR.

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

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

Reemplaza lo siguiente:

  • CLUSTER_NAME por el nombre del clúster cuyo estado consultas
  • GOOGLE_CLOUD_LOCATION por el nombre de la región de Google Cloud que administra este clúster de Azure

De manera alternativa, puedes obtener detalles sobre el error de creación mediante la descripción del recurso Operation asociado con la llamada a la API de creación de clústeres.

gcloud container azure operations describe OPERATION_ID

Reemplaza OPERATION_ID por el ID de la operación que creó el clúster. Si no tienes el ID de operación de la solicitud de creación de clústeres, puedes recuperarlo mediante 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 de clústeres de interés.

Errores de actualización del clúster

Cuando actualizas un clúster, al igual que cuando creas un clúster nuevo, GKE en Azure primero ejecuta un conjunto de pruebas preliminares para verificar la solicitud. Si la actualización del clúster falla, puede deberse a que una de estas pruebas preliminares falló o a que un paso del proceso de actualización del clúster no se completó.

Si una prueba preliminar falla, tu clúster no actualiza ningún recurso y te muestra información sobre el error directamente. Por ejemplo, si intentas actualizar un clúster para usar un par de llaves SSH con el nombre test_ec2_keypair, la prueba preliminar intenta recuperar el par de claves EC2 y falla, y la solicitud muestra 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

La creación del clúster también puede fallar después de que se aprueben las pruebas preliminares. Esto puede suceder varios minutos después de que comenzara la actualización del clúster y tu recurso de Azure en tu proyecto de Google Cloud tenga el estado establecido como DEGRADED.

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

¿Qué sigue?