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, pero esta opción de configuración está obsoleta y se quitará el 14 de junio de 2027.
En esta página, se explica cómo realizar las siguientes acciones relacionadas con los canales de versiones:
- Inscribe un clúster en un canal de versiones.
- Busca el canal de versiones de un clúster.
- Visualiza las versiones predeterminadas y disponibles de los canales de versiones.
- Cambia el canal de versiones de tu clúster.
- Da de baja tu clúster de 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
- Para usar Google Cloud CLI en esta tarea,
instala y, luego,
inicializa la
gcloud CLI. Si ya instalaste gcloud CLI, ejecuta el comando
gcloud components updatepara obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos de 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, 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 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:
En la página de creación de clústeres de Autopilot, en el panel de navegación, haz clic en Configuración avanzada:
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:
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:
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 derapid,regular,stableo, 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 en un canal de versiones específico
En las siguientes instrucciones, se explica cómo inscribir un clúster existente que no está inscrito en un canal de versiones en un canal de versiones. Si tu clúster tiene inhabilitada la actualización automática de nodos, consulta Inscribe un clúster existente que no esté inscrito en un canal de versiones que tenga inhabilitada la actualización automática de nodos.
Inscribe tu clúster en un canal de versiones con los siguientes pasos:
- Elige un canal de versiones: elige el canal estable o uno
diferente que se adapte mejor a tus necesidades. El canal estable es el
más consolidado y tiene todas las versiones secundarias disponibles para los clústeres que no
están inscritos en un canal. Si quieres obtener funciones nuevas antes o necesitas asistencia extendida
para una versión secundaria, haz lo siguiente:
- Elige el mejor canal de versiones para tu clúster.
- 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. Puedes inscribir un clúster existente, siempre que la versión secundaria del plano de control del clúster esté disponible en el canal de versiones de destino. Si deseas obtener más información para alinear la versión del plano de control de tu clúster con las versiones disponibles para tu canal de versiones de destino, consulta Cambia el canal de versiones de tu clúster.
- Considera usar períodos de mantenimiento y exclusiones: 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.
- Actualiza el canal de versiones del clúster al
CHANNELobjetivo: selecciona el canal de versiones de destino, que puede ser cualquier opción que no seaNone.
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 objetivos 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 tenga inhabilitada la actualización automática de nodos
Sigue estas instrucciones si tienes un clúster de Standard existente que no está inscrito en un canal de versiones y inhabilitaste las actualizaciones automáticas de nodos para uno o más de los grupos de nodos del clúster. Si deseas acceder a las funciones adicionales de los canales de versiones y migrar desde esta opción de configuración obsoleta, puedes inscribir tu clúster en un canal de versiones sin ningún cambio adicional.
GKE no habilita automáticamente el parámetro de configuración de actualizaciones automáticas de nodos para los grupos de nodos cuando se inscribe el clúster en un canal. De todos modos, este parámetro es una configuración heredada y, cuando inscribes el clúster en un canal, también te recomendamos que uses exclusiones de mantenimiento de grupos de nodos para evitar las actualizaciones de grupos de nodos a nivel de grupo de nodos de la misma manera.
Sigue estos pasos para inscribir un clúster existente en un canal de versiones:
- Inscribe el clúster existente en el canal de versiones de destino actualizando
el
canal
y especificando
stable. El canal estable es el más maduro y tiene todas las versiones secundarias disponibles para los clústeres que no están inscritos en un canal. - Opcional: Sigue estos pasos adicionales para migrar al uso de
exclusiones de mantenimiento en lugar de la configuración heredada de inhabilitar las actualizaciones automáticas de nodos
con el parámetro de configuración. Puedes realizar estos pasos en cualquier momento después
de inscribir tu clúster en un canal de versiones:
- Evita las actualizaciones automáticas de nodos de una de las siguientes maneras:
- Solo para algunos grupos de nodos: Configura una exclusión de mantenimiento del grupo de nodos para todos los grupos de nodos en los que inhabilitaste las actualizaciones automáticas de nodos. Inhabilitar las actualizaciones automáticas de nodos con esta exclusión evita todas las actualizaciones automáticas de los grupos de nodos, excepto las actualizaciones automáticas al final de la asistencia, que se realizan independientemente de la inscripción al canal de versiones y de cómo hayas inhabilitado las actualizaciones automáticas de nodos.
- Para todos los grupos de nodos: Configura una exclusión de mantenimiento con el permiso "Sin actualizaciones secundarias ni de nodos". Esta exclusión impide 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 permiso de exclusión de mantenimiento, que puede durar hasta la fecha de finalización de la asistencia para la versión secundaria en el canal de versiones del clúster.
- Quita el uso del campo heredado para inhabilitar las actualizaciones automáticas de nodos, ya que las exclusiones de mantenimiento que configuraste en el paso anterior ahora realizan esta función. Para cada grupo de nodos, sigue las instrucciones para habilitar las actualizaciones automáticas de nodos para un grupo de nodos existente.
- Evita las actualizaciones automáticas de nodos de una de las siguientes maneras:
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
Accede a la página de Google Kubernetes Engine en la consola de Google Cloud .
Haz clic en el nombre del clúster que deseas inspeccionar.
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:
CLUSTER_NAME: El nombre de tu clúster.COMPUTE_LOCATION: una ubicación de Compute Engine para tu clúster.
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 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:
- Configura una exclusión de mantenimiento con el permiso “Sin actualizaciones secundarias”.
- Espera a que el canal de versiones de destino esté disponible en la versión secundaria de Kubernetes de tu clúster.
- 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, mantén tu clúster en esa versión durante 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 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 se inscribe en el canal extendido durante el período de asistencia extendida, puede seguir ejecutando una versión secundaria que no sea compatible con otros canales. Si deseas cambiar tu clúster del canal extendido, en el que no se admite la versión secundaria, debes seguir estos pasos:
- Completa estos dos pasos, que se pueden realizar en cualquier orden:
- 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.
- 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 y compatible.
- 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
Accede a la página de Google Kubernetes Engine en la consola de Google Cloud .
Haz clic en el nombre del clúster que deseas inspeccionar.
En Aspectos básicos del clúster, en el campo Canal de versiones, haz clic en edit.
En el menú desplegable Canal de versiones, selecciona el canal de versiones de destino.
Para leer y confirmar que comprendes la advertencia, selecciona Entiendo que puede haber tiempo de inactividad durante las actualizaciones de la versión.
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 serrapid,regular,stabley, solo para Standard,extendedoNone.
Anula la suscripción a un canal de versiones
Si bien puedes anular la suscripción de tu clúster de Standard a un canal de versiones hasta el 14 de junio de 2027, esta es una opción de configuración obsoleta y te recomendamos que revises la comparación entre los clústeres inscritos y no inscritos en un canal de versiones. Asegúrate de comprender 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 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
Accede a la página de Google Kubernetes Engine en la consola de Google Cloud .
Haz clic en el nombre del clúster que deseas inspeccionar.
En Aspectos básicos del clúster, en el campo Canal de versiones, haz clic en edit.
Selecciona la versión Sin canal en el menú desplegable.
Para leer y confirmar que comprendes la advertencia, selecciona Entiendo que puede haber tiempo de inactividad durante las actualizaciones de la versión.
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, GKE te recomienda que inscribas el clúster en un canal de versiones, y te proporciona esta orientación con una estadística y una recomendación a través del servicio del 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 maneras:
- Usa la consola de Google Cloud .
- Usa gcloud CLI o la API de Recommender especificando el
subtipo de 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 registrar 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, revisa la comparación entre clústeres inscritos y no 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 parches en cuanto estén disponibles en un canal de versiones, en lugar de cuando GKE establezca las versiones como un 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 creas el
clúster o
actualizas 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 de parches acelerados
Puedes actualizar el clúster para inhabilitar las actualizaciones automáticas de parches aceleradas en tu clúster, de modo que este reciba versiones de parches solo después de que GKE establezca la versión del parche como un destino 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.