Soluciona problemas relacionados con la 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 suceder varios minutos después de que comienza la creación del clúster, después de que GKE en Azure cree recursos en Google Cloud y 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 el error, 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

Como alternativa, puedes obtener detalles sobre la falla de creación si describes el recurso Operation asociado con la llamada a la API para crear el clúster.

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 del clúster de interés.

Errores de actualización del clúster

Cuando actualizas un clúster, al igual que cuando creas uno nuevo, GKE en Azure ejecuta primero un conjunto de pruebas previas 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 comienza la actualización del clúster y el recurso de Azure en tu proyecto de Google Cloud tiene el estado 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?