Actualice la versión de su clúster de Azure

Esta página explica cómo actualizar la versión de Kubernetes de su GKE en clústeres de Azure.

Prerrequisitos

Actualizar la versión de Kubernetes de su clúster es un caso específico de la operación de actualización de clúster más general. Puede obtener información sobre las operaciones de actualización de clúster en general en la página "Actualizar su clúster" . Para actualizar la versión de su clúster:

  • Debe actualizar todas las versiones secundarias entre la versión actual y la de destino. Por ejemplo, para actualizar de la 1.20 a la 1.22, primero debe actualizar de la 1.20 a la 1.21 y, luego, de la 1.21 a la 1.22.
  • Debe tener el permiso de administración de identidad y acceso gkemulticloud.googleapis.com/azureClusters.update .

Cómo GKE en Azure realiza actualizaciones

Dado que actualizar un clúster requiere reiniciar los nodos del plano de control, GKE en Azure realiza una "actualización continua" con los siguientes pasos:

  1. Seleccione una instancia del plano de control para actualizar. GKE en Azure actualiza las instancias incorrectas (si las hay) antes que las correctas.
  2. Eliminar la instancia. GKE en Azure recrea la instancia y esta se inicia con la nueva configuración.
  3. Realizar comprobaciones del estado de la nueva instancia.
  4. Si las comprobaciones de estado son correctas, seleccione otra instancia y realice los mismos pasos. Repita este ciclo hasta que todas las instancias se reinicien o vuelvan a crear. Si la comprobación de estado falla, GKE en Azure coloca el clúster en estado DEGRADED y detiene la actualización. Para obtener más información, consulte la siguiente sección.

Cuando falla una actualización

Tras una actualización, GKE en Azure realiza una comprobación de estado del clúster. Si la comprobación falla, el clúster se marca como DEGRADED . Puede ver el estado de su clúster con el siguiente comando de la CLI de Google Cloud:

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

Reemplace lo siguiente:

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

Realizar la actualización

Comprueba la versión de tu clúster

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

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

Reemplace GOOGLE_CLOUD_LOCATION con el Google CloudUbicación desde la que administra sus clústeres.

Elija un método de actualización

Puede actualizar la versión de su clúster a través de Google Cloud Consola, la CLI de Google Cloud o la API Multi-Cloud de GKE. Si desea usar la consola para actualizar un clúster, primero debe elegir y configurar un método de autenticación para iniciar sesión en él. Para obtener más información, consulte Conectarse y autenticarse en el clúster .

Consola

  1. En el Google Cloud consola, vaya a la página de descripción general de clústeres de Google Kubernetes Engine .

    Ir a los clústeres de GKE

  2. Seleccione el Google Cloud proyecto en el que se encuentra el cluster.

  3. En la lista de clústeres, seleccione el nombre del clúster y luego seleccione Ver detalles en el panel lateral.

  4. En la pestaña Detalles , seleccione Actualización .

  5. En el cuadro de diálogo "Actualizar la versión de Kubernetes del clúster" , seleccione la versión a la que desea actualizar y haga clic en "Listo" . Tenga en cuenta que debe actualizar todas las versiones secundarias al actualizar el clúster.

nube g

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

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

Reemplace lo siguiente:

API

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

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

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

    Reemplace lo siguiente:

  2. Actualice estas configuraciones a través de la API Multi-Cloud de GKE 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

Reemplace lo siguiente:

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

Actualice sus grupos de nodos

Después de actualizar la versión del clúster, actualice los grupos de nodos para completar el proceso. Para saber cómo, consulte Actualizar un grupo de nodos .

¿Qué sigue?