Actualizar la versión del clúster de AWS

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

Requisitos previos

Actualizar la versión de Kubernetes de un clúster es un caso específico de la operación de actualización de clústeres más general. Puedes leer información general sobre las operaciones de actualización de clústeres en la página Actualizar un clúster. Para actualizar la versión de tu clúster, sigue estos pasos:

  • Debes actualizar a todas las versiones secundarias 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, después, de la 1.21 a la 1.22.
  • Debes tener el permiso gkemulticloud.googleapis.com/awsClusters.update Gestión de Identidades y Accesos

Cómo realiza las actualizaciones GKE on AWS

Como para actualizar un clúster es necesario reiniciar los nodos del plano de control, GKE on AWS realiza una "actualización continua" siguiendo estos pasos:

  1. Elige una instancia del plano de control que quieras actualizar. GKE on AWS actualiza las instancias incorrectas, si las hay, antes que las correctas.
  2. Crea una plantilla de lanzamiento para la instancia.
  3. Actualice la plantilla de lanzamiento del grupo de escalado automático.
  4. Elimina la instancia. AWS vuelve a crear la instancia y esta se inicia con la nueva configuración.
  5. Realiza comprobaciones del estado en la nueva instancia.
  6. Si las comprobaciones de estado se realizan correctamente, selecciona otra instancia y sigue los mismos pasos. Repite este ciclo hasta que se hayan reiniciado o recreado todas las instancias. Si la comprobación del estado falla, GKE en AWS coloca el clúster en el estado DEGRADED y detiene la actualización. Para obtener más información, consulta la siguiente sección.
  7. Elimina la plantilla de lanzamiento original.

Cuando falla una actualización

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

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

Haz los cambios siguientes:

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

Realizar la actualización

Comprobar la versión del clúster

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

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

Sustituye GOOGLE_CLOUD_LOCATION por la Google Cloud ubicación desde la que gestionas tus clústeres.

Elegir un método de actualización

Puedes actualizar la versión de tu clúster a través de la Google Cloud consola, la CLI de Google Cloud 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 para iniciar sesión en el clúster. Para obtener más información, consulta Conectarse y autenticarse en tu clúster.

Consola

  1. En la Google Cloud consola, ve a la página Resumen de clústeres de Google Kubernetes Engine.

    Ir a clústeres de GKE

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

  3. En la lista de clústeres, selecciona el nombre del clúster y, a continuación, Ver detalles en el panel lateral.

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

  5. En el cuadro de diálogo Actualizar la versión de Kubernetes del clúster, selecciona la versión a la que quieras actualizar y haz clic en Hecho. Ten en cuenta que debes actualizar todas las versiones secundarias al actualizar tu clúster.

gcloud

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

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

Haz los cambios siguientes:

API

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

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

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

    Haz los cambios siguientes:

    • CLUSTER_VERSION: la nueva versión del clúster admitida. Ten en cuenta que debes actualizar todas las versiones secundarias al actualizar tu clúster

  2. Actualiza estos ajustes 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/awsClusters/CLUSTER_ID?update_mask=controlPlane.Version

Haz los cambios siguientes:

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

Actualizar grupos de nodos

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

Siguientes pasos