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 gcloud components update para obtener la versión más reciente.
  • Si deseas inscribir un clúster en el canal extendido, asegúrate de haber revisado los precios para la asistencia extendida. Puedes inscribir un clúster en el canal extendido sin costo adicional si el proyecto habilitó GKE Enterprise. O bien, en el caso de los clústeres de la edición GKE Standard, los costos de pago por uso se aplican cuando tu clúster está inscrito en el canal extendido y la versión secundaria de tu clúster entra en el período de asistencia de la versión 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. Para el 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 mediante la consola de Google 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.

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 de Google Cloud o gcloud CLI, 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 inscribir tu clúster en el canal extendido.

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

Cambia tu clúster del canal extendido

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

  1. Completa estos dos pasos, que pueden realizarse 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 exceda la fecha de finalización de la asistencia estándar para esa versión secundaria más nueva y compatible.
  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 cuándo no inscribir tu clúster 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 consola de Google Cloud, gcloud CLI o la API de Kubernetes Engine. 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 estática 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.

¿Qué sigue?