Usa canales de versiones

Como administrador de la plataforma, puedes elegir un canal de versiones específico para el clúster a fin de asegurarte de que GKE actualice de manera automática el clúster a las versiones con el saldo que elijas entre la disponibilidad y estabilidad de las funciones. Para obtener más información sobre los canales de versiones, consulta Acerca de los canales de versiones.

GKE inscribe todos los clústeres de Autopilot en un canal de versiones y, luego, inscribe los clústeres de Standard, de forma predeterminada, en un canal de versiones. Para todos los modos de clúster, puedes elegir un canal de versiones específico. Con los clústeres estándar, puedes elegir no inscribir tu clúster en un canal de versiones.

En esta página, se explica cómo realizar las siguientes acciones relacionadas con los canales de versiones:

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 el comando gcloud components update para obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos que se describen en este documento.
  • Si deseas inscribir un clúster en el canal extendido, asegúrate de haber revisado los precios de la asistencia extendida. En el caso de los clústeres de GKE, se aplican costos de pago por uso cuando el clúster está inscrito en el canal extendido y la versión secundaria del clúster ingresa al período de asistencia extendida.

Inscribe un clúster en un canal de versiones

En esta sección, se muestra cómo seleccionar un canal de versiones específico para clústeres nuevos o clústeres existentes que no usaron un canal de versiones antes. También puedes cambiar el canal de versiones de un clúster existente que ya está inscrito en un canal de versiones.

Inscribe un clúster nuevo en un canal de versiones específico

Todos los clústeres se inscriben en el canal de versiones regular de forma predeterminada. Puedes elegir un canal de versiones específico para un clúster cuando lo creas o cambiar el canal de versiones después de crearlo. Los clústeres de Autopilot deben estar inscritos en un canal de versiones. Los clústeres estándar se pueden inscribir o dar de baja en un canal de versiones. En el caso del canal extendido, revisa Obtén asistencia a largo plazo con el canal extendido antes de seleccionar este canal.

Puedes crear y, luego, inscribir un clúster nuevo en un canal de versiones específico con la consola deGoogle Cloud o gcloud CLI.

Console

Crea un clúster con los siguientes pasos, según el modo del clúster:

  • Para clústeres de Autopilot:

    1. En la página de creación de clústeres de Autopilot, en el panel de navegación, haz clic en Configuración avanzada:

      Crea un clúster de Autopilot

    2. En la lista desplegable Canal de versiones, selecciona un canal de versiones en el cual inscribir el clúster o deja el valor predeterminado de Canal regular.

  • Para clústeres de Standard:

    1. En la página de creación de clústeres estándar, en la sección Conceptos básicos del clúster, navega a la subsección Canal de versiones:

      Crea un clúster de Kubernetes

    2. En la lista desplegable Canal de versiones, selecciona un canal de versiones en el cual inscribir el clúster o deja el valor predeterminado de Canal regular.

gcloud

Para crear e inscribir un clúster de Autopilot en un canal de versiones específico, ejecuta el siguiente comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=COMPUTE_LOCATION
    --release-channel=CHANNEL

Para crear e inscribir un clúster estándar en un canal de versiones específico, ejecuta el siguiente comando:

gcloud container clusters create CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --release-channel=CHANNEL

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre del clúster nuevo.
  • CLUSTER_LOCATION: la ubicación de Compute Engine para el clúster nuevo.
  • CHANNEL: es el tipo de canal de versiones: uno de rapid, regular, stable o, solo para Standard, extended.

Para obtener una lista de otras opciones que puedes especificar, consulta la documentación de referencia de gcloud container clusters create-auto y gcloud container clusters create.

También puedes crear un clúster con una versión específica mediante la marca --cluster-version. Si no especificas un canal de versiones, GKE inscribe tu clúster en el canal de versiones más desarrollado donde está disponible esa versión.

O bien, si no especificas el canal de versiones o la versión de clúster, el clúster se configura de manera predeterminada en el canal de versiones Regular en la versión predeterminada.

Inscribe un clúster existente

Puedes inscribir un clúster existente en un canal de versiones, siempre que la versión secundaria del plano de control del clúster esté disponible en el canal de versiones de destino. Para verificar si la versión secundaria del plano de control de tu clúster está disponible en el canal de versiones de destino, consulta las versiones predeterminadas y disponibles para los canales de versiones. Si deseas obtener más información sobre cómo alinear la versión del plano de control de tu clúster con las versiones disponibles para tu canal de versiones de destino, consulta Selecciona un canal de versiones nuevo.

GKE no requiere tiempo de inactividad para cambiar la inscripción del canal de versiones de un clúster. Sin embargo, GKE puede tener diferentes actualizaciones automáticas disponibles en un canal de versiones diferente, lo que significa que, después del cambio, GKE podría actualizar el clúster de forma automática. Recomendamos usar períodos de mantenimiento y exclusiones para controlar el tiempo de las actualizaciones.

Para inscribir, actualiza el canal de versiones del clúster al CHANNEL objetivo.

GKE no actualiza de forma inmediata el plano de control y los nodos del clúster al objetivo de actualización automática de la versión secundaria en ese canal de versiones durante la inscripción. En su lugar, se actualizan de forma gradual con el proceso de actualización automática de GKE. Para obtener los destinos de actualización automática de un clúster específico, consulta Obtén información sobre las actualizaciones de un clúster.

Inscribe un clúster existente que no esté inscrito en un canal de versiones y que tenga inhabilitada la actualización automática de nodos

Si tienes un clúster estándar existente que no está inscrito en un canal de versiones y inhabilitaste las actualizaciones automáticas de nodos para uno o más grupos de nodos del clúster, pero quieres acceder a las funciones adicionales de los canales de versiones, puedes usar exclusiones de mantenimiento para evitar las actualizaciones de nodos. Si cambias a un canal de versiones y usas exclusiones de mantenimiento, no podrás evitar las actualizaciones automáticas de nodos a nivel del grupo de nodos, sino solo a nivel del clúster. Sin embargo, siempre puedes actualizar los grupos de nodos de forma manual.

Sigue estos pasos para inscribir un clúster existente en un canal de versiones y, al mismo tiempo, seguir evitando las actualizaciones automáticas de nodos:

  1. Configura una exclusión de mantenimiento con el permiso “Sin actualizaciones”. Este es el único permiso de exclusión de mantenimiento disponible para los clústeres que no están inscritos en un canal de versiones. Esto evita que tu clúster se actualice automáticamente de inmediato si hay un objetivo de actualización automática recién apto en el canal de versiones seleccionado.
  2. Inscribe el clúster existente en el canal de versiones de destino. Con este cambio, GKE modifica la configuración de tus grupos de nodos de la siguiente manera:
    1. GKE habilita el parámetro de configuración de actualización automática de nodos para todos los grupos de nodos en los que la función está inhabilitada, pero no actualizará automáticamente los nodos porque configuraste la exclusión de mantenimiento en el paso 1.
    2. GKE habilita la reparación automática de nodos para cualquier grupo de nodos en el que la función esté inhabilitada, aunque puedes volver a inhabilitar la reparación automática de nodos con gcloud CLI si deseas mantenerla inhabilitada.
  3. Configura una exclusión de mantenimiento con el permiso “Sin actualizaciones secundarias ni de nodos”. Esto evita todas las actualizaciones, excepto las de parches, en el plano de control. Ahora que tu clúster está inscrito en un canal de versiones, puedes usar este alcance de exclusión de mantenimiento, que puede durar hasta la fecha de finalización de la compatibilidad de la versión secundaria en el canal de versiones de tu clúster.
  4. Quita la exclusión de mantenimiento que creaste en el paso 1 ahora que agregaste la nueva exclusión de mantenimiento en el paso anterior.

Después de completar estos pasos, tendrás un clúster en el que GKE no actualizará automáticamente los nodos hasta que quites la exclusión de mantenimiento o la versión secundaria de los nodos llegue al final de la asistencia.

Busca el canal de versiones de tu clúster

Puedes determinar el canal de versiones del clúster con la consola de Google Cloud o gcloud CLI.

Console

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud .

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas inspeccionar.

  3. En Aspectos básicos del clúster, verifica el valor en el campo Canal de versiones (por ejemplo, Canal regular).

Si el valor es Ninguno, el clúster no está inscrito en un canal de versiones.

gcloud

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"

Reemplaza lo siguiente:

Si el resultado está vacío, el clúster no está inscrito en un canal de versiones.

Visualiza las versiones predeterminadas y disponibles de los canales de versiones

Para verificar qué versiones están disponibles en un canal de versiones específico con la consola deGoogle Cloud o la CLI de gcloud, sigue las instrucciones para verificar las versiones disponibles y predeterminadas.

Cambia el canal de versiones de tu clúster

Puedes cambiar el canal de versiones de tu clúster si la versión secundaria del plano de control está disponible en el canal de versiones de destino. Es posible que debas actualizar el plano de control de tu clúster a una versión anterior o p cambiar a una versión posterior.

Para verificar si la versión del plano de control de tu clúster está disponible en el canal de versiones de destino, consulta las versiones predeterminadas y disponibles para los canales de versiones. La versión debe estar disponible en el canal de destino.

  • Si la versión del plano de control de tu clúster ya está disponible en el canal de versiones de destino, puedes seleccionar el canal de versiones nuevo.
  • Si la versión del plano de control de tu clúster no está disponible en el canal de versiones de destino, puedes actualizar el plano de control del clúster a una versión disponible. Como alternativa, si el canal de destino solo tiene versiones anteriores disponibles, puedes cambiar el clúster a una versión inferior, siempre que la versión de destino sea una versión de parche anterior de la misma versión secundaria.

Para seleccionar un canal de versiones nuevo, actualiza el canal de versiones del clúster al CHANNEL objetivo. Si deseas evitar de forma temporal que el clúster se actualice de forma automática cuando seleccionas el canal nuevo, configura una exclusión de mantenimiento antes de seleccionar el canal nuevo.

Si no puedes seleccionar el canal de versiones de destino porque el clúster ejecuta una versión que no está disponible en ese canal de versiones, puedes hacer lo siguiente:

  1. Configura una exclusión de mantenimiento con el permiso “Sin actualizaciones secundarias”.
  2. Espera a que el canal de versiones de destino esté disponible en la versión secundaria de Kubernetes de tu clúster.
  3. Inscribe el clúster existente en el canal de versiones de destino.

Como alternativa, puedes crear un clúster nuevo en el canal de destino y migrar tus cargas de trabajo.

Cambia tu clúster al canal extendido

Para obtener asistencia a largo plazo y mantener tu clúster en esa versión el mayor tiempo posible, puedes inscribirlo en el canal extendido.

Asegúrate de revisar los precios para inscribir tu clúster en el canal extendido y las limitaciones de las funciones. No puedes inscribir tu clúster en el canal extendido si este usa ciertas funciones.

Cambia tu clúster desde el canal extendido

Si un clúster está inscrito en el canal extendido durante el período de asistencia extendida, puede seguir ejecutando una versión secundaria que no sea compatible en otros canales. Si quieres cambiar tu clúster del canal extendido, en el que no se admite la versión secundaria, debes seguir estos pasos:

  1. Completa estos dos pasos, que se pueden realizar en cualquier orden:
    1. Actualiza tu clúster de forma manual a una versión secundaria en el período de asistencia estándar disponible en el canal de versiones de destino.
    2. Quita o modifica cualquier exclusión de mantenimiento con una fecha de finalización que supere la fecha de finalización de la asistencia estándar para esa versión secundaria más reciente admitida.
  2. Actualiza el canal de versiones del clúster.

Actualiza el canal de versiones del clúster

Puedes cambiar el canal de versiones del clúster con la consola de Google Cloud o gcloud CLI.

Console

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud .

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas inspeccionar.

  3. En Aspectos básicos del clúster, en el campo Canal de versiones, haz clic en .

  4. En el menú desplegable Canal de versiones, selecciona el canal de versiones de destino.

  5. Para leer y confirmar que comprendes la advertencia, selecciona Entiendo que puede haber tiempo de inactividad durante las actualizaciones de la versión.

  6. Haz clic en Save Changes.

gcloud

Cambia la propiedad del canal de versiones de un clúster existente:

gcloud container clusters update CLUSTER_NAME \
  --release-channel CHANNEL

Reemplaza lo siguiente:

  • CLUSTER_NAME: El nombre de tu clúster.
  • CHANNEL: el canal de versiones de destino, que puede ser rapid, regular, stable y, solo para Standard, extended o None.

Anula la suscripción a un canal de versiones

Si bien puedes anular la suscripción a tu clúster estándar en un canal de versiones, te recomendamos que revises la comparación entre los clústeres inscritos y no inscritos en un canal de versiones para asegurarte de que comprendes las implicancias de inscribir y de no inscribir el clúster en un canal de versiones.

Puedes realizar esta acción con la Google Cloud consola, gcloud CLI o la API de GKE. También puedes especificar que no quieres inscribir tu clúster de Standard en un canal de versiones durante la creación del clúster. No puedes anular la suscripción a los clústeres de Autopilot desde un canal de versiones.

Console

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud .

    Ir a Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas inspeccionar.

  3. En Aspectos básicos del clúster, en el campo Canal de versiones, haz clic en .

  4. Selecciona la versión Sin canal en el menú desplegable.

  5. Para leer y confirmar que comprendes la advertencia, selecciona Entiendo que puede haber tiempo de inactividad durante las actualizaciones de la versión.

  6. Haz clic en Save Changes.

gcloud

Actualiza el canal de versiones del clúster a un valor de None:

gcloud container clusters update CLUSTER_NAME \
  --release-channel None

API

Especifica "releaseChannel": { "channel": UNSPECIFIED} cuando crees o actualices un clúster.

Identifica los clústeres que no están inscritos en un canal de versiones

Si tienes un clúster de GKE Standard que no está inscrito en un canal de versiones y todos los grupos de nodos tienen habilitada la actualización automática de nodos, te recomendamos que inscribas el clúster en un canal de versiones. GKE proporciona esta orientación con una estadística y una recomendación a través del servicio de Recomendador. Esta guía no se aplica a los clústeres de Autopilot, que siempre están inscritos en un canal de versiones.

Para encontrar clústeres que no estén inscritos en un canal de versiones, puedes usar una de las siguientes opciones:

  • Usa la Google Cloud consola.
  • Usa gcloud CLI o la API de Recommender y especifica el subtipo del recomendador CLUSTER_RELEASE_CHANNEL_UNSPECIFIED.

Para obtener instrucciones, consulta cómo ver estadísticas y recomendaciones.

Para implementar esta recomendación, sigue las instrucciones para inscribir clústeres existentes. Para obtener más información sobre si deseas implementar esta recomendación, consulta Acerca de los canales de versiones. Para comparar las capacidades entre un clúster inscrito o no inscrito en un canal de versiones, consulta la comparación entre los clústeres inscritos y los que no están inscritos en un canal de versiones.

Usa actualizaciones automáticas de parches aceleradas

Puedes usar las actualizaciones automáticas de parches aceleradas para que GKE actualice automáticamente tu clúster a las versiones de parche tan pronto como estén disponibles en un canal de versiones, en lugar de cuando GKE establezca las versiones como destino de actualización automática al menos una semana después.

Para usar las actualizaciones automáticas de parches aceleradas, configura la marca --patch-update=accelerated con gcloud CLI cuando crees el clúster o actualices el clúster.

Este parámetro de configuración solo está disponible para los clústeres inscritos en un canal de versiones y no afecta las actualizaciones de versiones secundarias.

Inhabilita las actualizaciones automáticas aceleradas de parches

Puedes actualizar el clúster para inhabilitar las actualizaciones automáticas de parches aceleradas, de modo que el clúster reciba versiones de parches solo después de que GKE establezca la versión de parche como objetivo de actualización automática. Esta acción revierte el clúster a la configuración predeterminada y no inhabilita las actualizaciones automáticas.

Para actualizar el clúster, establece la marca --patch-update=default.

¿Qué sigue?