Actualiza la versión del clúster de Azure

En esta página, se explica cómo actualizar la versión de Kubernetes de tus clústeres de GKE en Azure.

Requisitos previos

La actualización de la versión de Kubernetes de tu clúster es un caso específico de la operación de actualización del clúster más general. Puedes leer sobre las operaciones de actualización del clúster en general en la página de actualización del clúster. Para actualizar la versión del clúster, haz lo siguiente:

  • Debes actualizar cada versión secundaria entre la versión actual y la de destino. Por ejemplo, para actualizar de la versión 1.20 a la 1.22, primero debes actualizar de la 1.20 a la 1.21 y, luego, de la 1.21 a la 1.22.
  • Debes tener el permiso gkemulticloud.googleapis.com/azureClusters.update de Identity and Access Management.

Cómo GKE en Azure realiza actualizaciones

Debido a que la actualización de un clúster requiere reiniciar los nodos del plano de control, GKE en Azure realiza una “actualización progresiva” con los siguientes pasos:

  1. Eligen una instancia del plano de control para actualizar. GKE en Azure actualiza las instancias en mal estado antes de que estén en buen estado.
  2. Borra la instancia. GKE en Azure vuelve a crear la instancia y esta se inicia con la configuración nueva.
  3. Realizan verificaciones de estado en la instancia nueva.
  4. Si las verificaciones de estado se ejecutan correctamente, selecciona otra instancia y realiza los mismos pasos en ella. Repiten este ciclo hasta que todas las instancias se reinicien o se vuelvan a crear. Si la verificación de estado falla, GKE en Azure coloca el clúster en un estado DEGRADED y detiene la actualización. Para obtener más información, consulta la siguiente sección:

Cuando falla una actualización

Después de una actualización, GKE en Azure realiza una verificación de estado en el clúster. Si la verificación de estado falla, el clúster se marca como DEGRADED. Puedes mostrar el estado del clúster con el siguiente comando de Google Cloud CLI:

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre de tu clúster.
  • GOOGLE_CLOUD_LOCATION: Es la región de Google Cloud que administra tu clúster.

Realiza la actualización

Verifica tu versión del clúster

Antes de actualizar la versión del clúster, usa el siguiente comando para verificar qué versiones están disponibles en tu región:

gcloud container azure get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

Reemplaza GOOGLE_CLOUD_LOCATION por la ubicación de Google Cloud desde la que administras tus clústeres.

Elige un método de actualización

Puedes actualizar la versión del clúster a través de la consola de Google Cloud, Google Cloud CLI o la API de GKE Multi-Cloud. Si quieres usar la consola para actualizar un clúster, primero debes elegir y configurar un método de autenticación a fin de acceder al clúster. Para obtener más información, consulta Conéctate y autentícate en el clúster.

Console

  1. En la consola de Google Cloud, ve a la página Descripción general de los clústeres de Google Kubernetes Engine.

    Ir a los clústeres de GKE

  2. Selecciona el proyecto de Google Cloud en el que se encuentra el clúster.

  3. En la lista de clústeres, selecciona su nombre y, luego, Ver detalles en el panel lateral.

  4. En la pestaña Detalles, selecciona Actualizar.

  5. En el cuadro de diálogo Actualiza la versión de Kubernetes para el clúster, selecciona la versión a la que deseas actualizar y haz clic en Listo. Ten en cuenta que debes actualizar todas las versiones secundarias cuando actualizas el clúster.

gcloud

Para actualizar la versión de Kubernetes de tu clúster, ejecuta el siguiente comando:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

Reemplaza lo siguiente:

API

Para actualizar tu clúster a través de la API, usa una operación PATCH en la API de GKE Multi-Cloud.

  1. Crea un archivo JSON llamado cluster_update.json con el siguiente contenido:

    {
    "controlPlane": {
       "version": "CLUSTER_VERSION",
    },
}

    Reemplaza lo siguiente:

    • CLUSTER_VERSION: la nueva versión de clúster compatible. Ten en cuenta que debes actualizar todas las versiones secundarias cuando actualizas el clúster.

  2. Actualiza esta configuración a través de la API de GKE Multi-Cloud con el siguiente comando.

    curl -d @cluster_update.json -X PATCH \
   ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version

Reemplaza lo siguiente:

Para obtener más información, consulta la documentación del método projects.locations.azureClusters.patch.

Actualiza los grupos de nodos

Después de actualizar la versión del clúster, actualiza los grupos de nodos para completar el proceso. Para aprender a hacerlo, consulta Actualiza un grupo de nodos.

¿Qué sigue?