Obtén visibilidad de las actualizaciones de clústeres

En esta página, se explica cómo puedes obtener información sobre las actualizaciones de tus clústeres de Google Kubernetes Engine (GKE). Con el tiempo, GKE actualiza automáticamente todos los clústeres. 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 sobre un clúster:

• Destinos de actualización automática: Descubre a qué versiones nuevas apunta GKE para tu clúster, que podrían 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, el clúster ya está en el objetivo de actualización más reciente o 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 versiones, como la nota de 2024-R33.
• Estado de la actualización automática: Los clústeres de GKE tienen un estado para las actualizaciones del clúster. 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 la actualización automática del clúster.

• Historial de actualizaciones: GKE proporciona una instantánea 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 o si se realizó correctamente, falló o se canceló.
  • Hora: 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 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 conocer las fechas del final de la compatibilidad de todas las versiones secundarias actuales, consulta el Programa estimado para los canales de lanzamiento.

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

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 de Actualizaciones:

Ir 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 actualizaciones
• Recomendaciones relacionadas con las actualizaciones
• Cronogramas de finalización de la asistencia para versiones secundarias específicas
• 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 de Standard

Puedes obtener visibilidad de los grupos de nodos individuales para 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

A continuación, se indican los estados posibles de las actualizaciones automáticas para un clúster:

• ACTIVE: Es 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.

Estos 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 las actualizaciones del clúster.
• 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 las actualizaciones 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: Es un motivo no especificado.

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

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

Cómo saber cuándo se espera la próxima actualización del clúster

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

• Programa de lanzamientos: En el programa estimado para los canales de versiones, busca la fecha estimada de actualización automática que corresponde a la versión secundaria y el canal de versiones de tu clúster.
• Obtén información sobre las actualizaciones a nivel del clúster: Busca el destino de la 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, y el tiempo depende del canal, GKE designa la versión como destino de actualización automática en el canal. Para ver estas notificaciones, filtra por UpgradeAvailableEvent cuando visualices las notificaciones del clúster en Cloud Logging.
• Notas de la versión: Sigue las notas de la versión para saber cuándo GKE establece la nueva versión secundaria como destino 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, consulta el estado de actualización automática de tu clúster. Si las actualizaciones automáticas están en pausa, consulta el motivo. Usa uno de los siguientes métodos:

• Obtén información sobre las actualizaciones a nivel del proyecto (vista previa). Haz clic en la pestaña Actualizaciones, donde puedes ver la tabla Estados de actualización. Busca tu clúster en la tabla y consulta la columna Actualización automática del clúster.
• 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 completará la actualización del clúster

Para saber cuándo se completan las actualizaciones del plano de control y los nodos de tu clúster, y así poder verificar que tus cargas de trabajo funcionen según lo esperado, usa los siguientes recursos:

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

Cómo saber cuánto tiempo tardará 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 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 el plano de control o los nodos, la estrategia de actualización, los presupuestos de interrupción de Pods (PDB), las políticas de mantenimiento activas y otros factores.

Cómo saber cuándo la versión secundaria de tu clúster llega al final de la asistencia

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

Para saber cuándo la versión secundaria de tu clúster dejará de recibir asistencia (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 para los canales de versiones, busca la fecha del final de la compatibilidad que corresponda 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 cerca del final del período de asistencia o en ese momento. Para ver estas notificaciones, filtra por UpgradeInfoEvent cuando visualices las notificaciones de clústeres en Cloud Logging.
• Estadísticas y recomendaciones: GKE te informa cuando tu clúster ejecuta una versión secundaria posterior al final de la asistencia estándar. Para obtener más información, consulta Cómo identificar clústeres que ejecutan una versión secundaria posterior al final de la asistencia estándar.
• Obtén información sobre las actualizaciones a nivel del clúster: Busca la fecha de finalización de la asistencia 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 asistencia de la versión con versiones específicas y los días restantes hasta el fin de la asistencia.

¿Qué sigue?

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