Obtener visibilidad de las actualizaciones de clústeres

En esta página se explica cómo obtener información sobre las actualizaciones de tus clústeres de Google Kubernetes Engine (GKE). GKE actualiza automáticamente todos los clústeres con el tiempo. Cuando GKE actualiza un clúster, actualiza la versión del plano de control de Kubernetes y los nodos de trabajo en operaciones independientes.

GKE agrega información sobre las actualizaciones de clústeres para ayudarte a comprender mejor el estado de tu clúster. Puedes obtener la siguiente información de un clúster:

  • Versiones de destino de la actualización automática: descubre qué versiones nuevas de GKE se van a aplicar a tu clúster, que pueden ser parches o versiones secundarias nuevas, en función de la versión y las restricciones actuales del clúster. Si no hay ningún destino de actualización automática, el clúster ya tiene el destino de actualización más reciente o GKE no ha asignado ningún destino de actualización automática por motivos técnicos o empresariales. También puedes consultar los objetivos generales de actualización automática en función de la versión secundaria de un clúster en las notas de la versión de GKE Actualizaciones de versiones, como la nota 2024-R33.
  • Estado de la actualización automática: los clústeres de GKE tienen un estado para las actualizaciones de clústeres. Usa este estado para obtener más información sobre las actualizaciones actuales y las restricciones que tiene en cuenta GKE a la hora de elegir cuándo actualizar automáticamente tu clúster, incluidos factores como las exclusiones de mantenimiento o los motivos que impiden las actualizaciones. Para obtener más información, consulta Estado de la actualización automática del clúster.

  • Historial de actualizaciones: GKE proporciona una vista general de las actualizaciones recientes del plano de control y de los nodos de tu clúster, incluidas las actualizaciones automáticas y manuales. En el caso de las actualizaciones recientes del plano de control y de los nodos, puedes ver detalles como los siguientes:

    • Versiones: la versión inicial y la de destino.
    • Estado: indica si la actualización sigue en curso o si se ha completado correctamente, ha fallado o se ha cancelado.
    • Hora: la hora de inicio y de finalización.
    • Tipo de inicio: si la actualización se ha activado automáticamente o manualmente.

  • Fechas de fin de la asistencia: GKE admite versiones secundarias durante un máximo de 24 meses. Para obtener más información, consulta el ciclo de vida de la versión secundaria de GKE. Para consultar las fechas de fin de la asistencia de todas las versiones secundarias actuales, consulta la programación estimada de los canales de lanzamiento.

  • Eventos de clúster: GKE envía notificaciones de clúster a Cloud Logging para determinados eventos, como cuando se inician o completan actualizaciones, cuando hay nuevas versiones disponibles, boletines de seguridad y fechas de finalización del soporte. Además de que GKE muestra estos eventos automáticamente con Cloud Logging, también puedes enrutar estas notificaciones a Pub/Sub. Para obtener más información, consulta Notificaciones de clústeres.

Antes de empezar

Antes de empezar, asegúrate de que has realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
    • Habilitar la API de Google Kubernetes Engine
  • Si quieres usar Google Cloud CLI para esta tarea, instálala y, a continuación, inicialízala. Si ya has instalado la gcloud CLI, obtén la versión más reciente ejecutando gcloud components update.

Obtener información sobre las actualizaciones de un clúster

Para obtener información sobre las actualizaciones de un clúster, puedes usar la consolaGoogle Cloud o la gcloud CLI.

Obtener información sobre las actualizaciones a nivel de proyecto

Para obtener información agregada sobre las actualizaciones de clústeres de un proyecto, puedes usar el panel de control Actualizaciones.

En la Google Cloud consola, ve al panel de control Mejoras:

Ir a Mejoras

Las pestañas de este panel de control agregan información relevante sobre las actualizaciones, como la siguiente:

  • Estados de las actualizaciones recientes del plano de control y de los nodos
  • Registros de notificaciones de clústeres para actualizaciones
  • Recomendaciones relacionadas con las actualizaciones
  • Plazos de finalización de la asistencia para versiones secundarias específicas
  • Número de clústeres en cada canal de lanzamiento

Obtener información sobre las actualizaciones a nivel de clúster

Consola

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

    Ir a clústeres de Kubernetes

  2. Selecciona el nombre del clúster para ver la página Detalles del clúster.

  3. En la página Detalles del clúster, consulta la sección Actualizaciones del clúster.

gcloud

Ejecuta el siguiente comando:

gcloud container clusters get-upgrade-info CLUSTER_NAME

Sustituye CLUSTER_NAME por el nombre del clúster.

Obtener información sobre las actualizaciones de grupos de nodos de clústeres estándar

Puedes ver los grupos de nodos individuales de los clústeres estándar. Esta sección no se aplica a los clústeres de Autopilot, en los que GKE gestiona los nodos, por lo que no tienes que gestionar ningún grupo de nodos.

Consola

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

    Ir a clústeres de Kubernetes

  2. Haga clic en el nombre del clúster para ver sus detalles.

  3. Haz clic en la pestaña Nodos.

  4. En la sección Grupos de nodos, haz clic en el nombre del grupo de nodos del que quieras obtener información sobre las actualizaciones.

  5. En la página Detalles del grupo de nodos, consulta la sección Actualizaciones.

gcloud

Ejecuta el siguiente comando:

gcloud container node-pools get-upgrade-info POOL_NAME
    --cluster=CLUSTER_NAME

Sustituye POOL_NAME por el nombre del grupo de nodos.

Estado de la actualización automática del clúster

Estos son los posibles estados de las actualizaciones automáticas de un clúster:

  • ACTIVE: estado de actualización activo.
  • UNKNOWN: se desconoce el estado de la actualización.
  • MINOR_UPGRADE_PAUSED: las actualizaciones de versiones secundarias están en pausa.
  • UPGRADE_PAUSED: todas las actualizaciones automáticas están en pausa.

Estos son los posibles motivos por los que GKE pausa las actualizaciones automáticas de un clúster:

  • MAINTENANCE_WINDOW: Una ventana de mantenimiento impide que se actualicen los clústeres.
  • MAINTENANCE_EXCLUSION_: un motivo de pausa con este prefijo indica que una exclusión por mantenimiento está impidiendo las actualizaciones del clúster. El sufijo indica el ámbito de la exclusión de mantenimiento, como MAINTENANCE_EXCLUSION_NO_UPGRADES.
  • CLUSTER_DISRUPTION_BUDGET: Después de realizar determinadas operaciones, como la creación o la actualización de un clúster, este requiere un periodo de enfriamiento para proteger la estabilidad y la disponibilidad del clúster y sus aplicaciones.
  • CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: el clúster está fuera del presupuesto de interrupción del clúster para las actualizaciones de versiones secundarias.
  • SYSTEM_CONFIG: Las actualizaciones automáticas se han pausado temporalmente por motivos técnicos o empresariales. Con este estado, te recomendamos que no realices una actualización manual a menos que sea necesario.
  • AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: un motivo no especificado.

Consulta información sobre los casos prácticos habituales de las actualizaciones de clústeres

Consulta información sobre las situaciones habituales que pueden surgir al gestionar las actualizaciones de clústeres.

Consultar cuándo se realizará la próxima actualización de tu clúster

Para saber cuándo se realizará la próxima actualización de tu clúster y poder planificar y calificar la actualización a la nueva versión, consulta los siguientes recursos:

Buscar qué está impidiendo que se actualice tu clúster

Para saber qué está impidiendo una actualización y poder desbloquearla, consulta el estado de la actualización automática de tu clúster. Si las actualizaciones automáticas están pausadas, consulta el motivo. Puedes usar uno de los siguientes métodos:

Consultar cuándo se completa la actualización de un clúster

Para saber cuándo se completan las actualizaciones del plano de control y de los nodos de tu clúster y así poder verificar que tus cargas de trabajo funcionan correctamente, consulta los siguientes recursos:

Consultar cuánto tiempo se espera que dure la actualización

Para saber cuánto tiempo se espera que dure la actualización, puedes consultar la duración de las actualizaciones anteriores obteniendo información sobre las actualizaciones a nivel de clúster. Consulta el historial de actualizaciones para ver ejemplos recientes.

La duración de una actualización depende de si se actualizan el plano de control o los nodos, de la estrategia de actualización, de los presupuestos de interrupción de pods (PDBs), de las políticas de mantenimiento activas y de otros factores.

Consultar cuándo finaliza el periodo de asistencia de la versión secundaria de un clúster

GKE actualiza automáticamente los clústeres que siguen ejecutando versiones secundarias una vez que ha pasado la fecha de finalización del soporte. Para obtener más información, consulta Actualizaciones automáticas al final del periodo de asistencia.

Para saber cuándo dejará de ofrecerse asistencia para la versión secundaria de tu clúster (por ejemplo, para definir una exclusión de mantenimiento o saber cuándo dejarán de estar disponibles las APIs obsoletas), consulta los siguientes recursos:

Siguientes pasos