Obtén visibilidad de las actualizaciones de clústeres

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se explica cómo puedes 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 trabajadores en operaciones separadas.

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 para un clúster:

• Destinos de actualización automática: Descubre a qué versiones nuevas se orienta GKE para tu clúster, que pueden ser parches o versiones secundarias nuevas, según la versión y las restricciones existentes de tu clúster. Si no hay un objetivo de actualización automática, significa que el clúster ya está en el objetivo de actualización más reciente o que GKE no asignó un objetivo de actualización automática por motivos técnicos o comerciales. También puedes recuperar destinos de actualización automática generales según la versión secundaria de un clúster en las notas de la versión de GKE Actualizaciones de versión, 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 GKE considera cuando elige 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 actualización automática del clúster.

• Historial de actualizaciones: GKE proporciona un resumen 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 los nodos, puedes ver detalles como los siguientes:

  • Versiones: La versión inicial y la de destino.
  • Estado: Indica si la actualización aún se está ejecutando, si se realizó correctamente, si falló o si se canceló.
  • Hora: Es la hora de inicio y finalización.
  • Tipo de inicio: Indica si la actualización se activó de forma automática o manual.

• Fechas de finalización de la asistencia: GKE admite versiones secundarias durante hasta 24 meses. Para obtener más información, consulta el ciclo de vida de la versión secundaria de GKE. Para conocer las fechas del final de la compatibilidad de todas las versiones secundarias actuales, consulta el Programa estimado para los canales de lanzamiento.

• Eventos de clúster: GKE envía notificaciones de clúster a Cloud Logging para ciertos eventos, como cuando comienzan o se completan las actualizaciones, cuando hay versiones nuevas disponibles, boletines de seguridad y fechas de finalización de la compatibilidad. 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 del clúster.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

• Habilita la API de Google Kubernetes Engine.
Habilitar la API de Google Kubernetes Engine
• Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para obtener la versión más reciente.

Obtén información sobre las actualizaciones de un clúster

Puedes obtener información sobre las actualizaciones de un clúster con la consola de Google Cloud o la CLI de gcloud.

Obtén información sobre las actualizaciones a nivel del proyecto

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

En la consola de Google Cloud, ve al panel Actualizaciones:

Ve a Actualizaciones.

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

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

Obtén información sobre las actualizaciones a nivel del clúster

gcloud container clusters get-upgrade-info CLUSTER_NAME

Obtén información sobre las actualizaciones de los grupos de nodos de clústeres estándar

Puedes obtener visibilidad de 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 administra los nodos, por lo que no hay grupos de nodos que administres.

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

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

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

• ACTIVE: Un estado de actualización activo.
• UNKNOWN: Se desconoce el estado de la actualización.
• MINOR_UPGRADE_PAUSED: Se pausaron las actualizaciones de versiones secundarias.
• UPGRADE_PAUSED: Todas las actualizaciones automáticas están pausadas.

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

• MAINTENANCE_WINDOW: Un período de mantenimiento impide que se actualicen los clústeres.
• MAINTENANCE_EXCLUSION_: Un motivo de pausa con este prefijo indica que una exclusión de mantenimiento impide las actualizaciones del clúster. El sufijo indica el alcance de la exclusión de mantenimiento, como MAINTENANCE_EXCLUSION_NO_UPGRADES.
• CLUSTER_DISRUPTION_BUDGET: Después de ciertas operaciones, como la creación o la actualización de clústeres, estos requieren un período de inactividad 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 están detenidas temporalmente por motivos técnicos o comerciales. 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.

Encuentra información sobre situaciones comunes para las actualizaciones de clústeres

Obtén información sobre situaciones comunes que puedes encontrar cuando administras las actualizaciones de clústeres.

Cómo saber 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 planificarla y calificarla para la nueva versión, usa los siguientes recursos:

• Programa de lanzamientos: En el programa estimado de canales de versiones, busca la fecha estimada de actualización automática que corresponde a la versión secundaria y al canal de versiones de tu clúster.
• Obtén información sobre las actualizaciones a nivel del clúster: Encuentra el objetivo de actualización automática de tu clúster.
• Notificaciones de clústeres: GKE envía una notificación cuando hay una versión nueva disponible en un canal. Después de que una versión nueva esté disponible, con el tiempo que depende del canal, GKE designa la versión como un destino de actualización automática en el canal. Para ver estas notificaciones, filtra UpgradeAvailableEvent cuando veas las notificaciones del clúster en Cloud Logging.
• Notas de la versión: Consulta las notas de la versión para saber cuándo GKE establece la nueva versión menor como objetivo de actualización automática en el canal.

Descubre qué bloquea la próxima actualización de tu clúster

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

• Obtén información sobre las actualizaciones a nivel del proyecto (versión preliminar). Haz clic en la pestaña Actualizaciones, en la que puedes ver la tabla Estados de actualización. Busca tu clúster en la tabla y consulta la columna Actualización automática.
• Obtén información sobre las actualizaciones a nivel del clúster para conocer el estado de la actualización automática de tu clúster.

Cómo saber cuándo se completa la actualización de tu clúster

Para saber cuándo se completan las actualizaciones del plano de control y los nodos de tu clúster, de modo que puedas verificar que tus cargas de trabajo funcionen como se espera, usa los siguientes recursos:

• Notificaciones de clúster: GKE envía una notificación cuando termina una operación para actualizar un clúster. Para ver estas notificaciones, filtra UpgradeInfoEvent cuando veas las notificaciones del clúster en Cloud Logging.
• Panel de actualizaciones (versión preliminar): Ve a la tabla Estados de actualización en la consola de Google Cloud. Busca tu clúster. Si en la columna Estado aparece Actualizado, consulta la columna Actualización más reciente para ver cuándo se completó la actualización.
• Obtén información sobre las actualizaciones a nivel del clúster: Usa la CLI de gcloud para encontrar el historial de actualizaciones de tu clúster, que incluye las actualizaciones recientes.

Descubre cuánto tiempo se espera que tarde la actualización

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

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

Cómo saber cuándo finaliza la compatibilidad de la versión secundaria de tu clúster

GKE actualiza automáticamente los clústeres que aún ejecutan versiones secundarias después de la fecha de finalización de la compatibilidad. Para obtener más información, consulta Actualizaciones automáticas al final de la compatibilidad.

Para saber cuándo finaliza la compatibilidad con la versión secundaria de tu clúster (por ejemplo, para establecer una exclusión de mantenimiento o comprender cuándo ya no se podrán usar las APIs obsoletas), usa los siguientes recursos:

• Programa de lanzamientos: En el programa estimado de canales de versiones, busca la fecha del final de la compatibilidad que corresponde a la versión secundaria y al canal de versiones de tu clúster. En el caso de los clústeres que no están en el canal extendido, consulta la fecha de finalización de la asistencia estándar. En el caso de los clústeres que se encuentran en el canal extendido, consulta la fecha de finalización de la asistencia extendida.
• Notificaciones de clúster: GKE envía una notificación cuando un clúster ejecuta una versión secundaria al final de la compatibilidad o cerca de este. Para ver estas notificaciones, filtra por UpgradeInfoEvent cuando veas las notificaciones de clústeres en Cloud Logging.
• Estadísticas y recomendaciones: GKE te informa cuando tu clúster ejecuta una versión secundaria después del final de la asistencia estándar. Para obtener más información, consulta Cómo identificar clústeres que ejecutan una versión inferior después del final de la asistencia estándar.
• Obtén información sobre las actualizaciones a nivel del clúster: Descubre la fecha de finalización de la compatibilidad de la versión secundaria de tu clúster.
• Panel de actualizaciones (versión preliminar): El panel Actualizaciones incluye una sección Fin de la compatibilidad de la versión con versiones específicas y los días que quedan hasta que finalice la compatibilidad.

¿Qué sigue?

• Programa de lanzamientos de GKE
• Notas de la versión de GKE
• Notificaciones de clúster