Actualiza el Sincronizador de configuración

En esta página, se explica cómo actualizar la versión del Sincronizador de configuración instalada en tus clústeres.

Actualiza automáticamente el Sincronizador de configuración

Puedes configurar el Sincronizador de configuración para que realice actualizaciones automáticas a versiones más recientes en tus clústeres de GKE en Google Cloud.

Habilitar las actualizaciones automáticas del Sincronizador de configuración ayuda a optimizar tu experiencia de administración. Google asume la responsabilidad de actualizar automáticamente las versiones del Sincronizador de configuración y supervisar el ciclo de vida de sus componentes. Si habilitas las actualizaciones automáticas, obtendrás los siguientes beneficios:

Menor sobrecarga de mantenimiento: Evita supervisar versiones más recientes del Sincronizador de configuración y actualizarlo de forma manual en todos tus clústeres.
Mantente en las versiones compatibles: Google mantiene la versión compatible más reciente en tus clústeres, lo que garantiza que no uses una versión no compatible del Sincronizador de configuración.
Mayor confiabilidad: Google administra los componentes del Sincronizador de configuración y los concilia en caso de que haya alteraciones.

Versiones del Sincronizador de configuración y canales de versiones de GKE

El Sincronizador de configuración elige la versión que se actualizará según el canal de versiones del clúster de Google Kubernetes Engine. Un clúster que no usa un canal de versiones de GKE se considera un clúster que usa el canal de versiones estable de GKE.

Puedes usar las actualizaciones automáticas para asegurarte de que el Sincronizador de configuración se actualice en tus clústeres de forma automática. Cuando hay una versión nueva del Sincronizador de configuración disponible en un canal de versiones, el Sincronizador de configuración actualiza la versión que coincide con el canal de versiones del clúster. El canal rápido ofrece la versión más reciente del Sincronizador de configuración en cuanto esté disponible. El canal regular ofrece la versión más reciente del Sincronizador de configuración con bastante rapidez. El canal estable ofrece la versión más reciente del Sincronizador de configuración solo después de validarse en los canales rápido y regular.

Para obtener más información sobre los canales de versiones, consulta Acerca de los canales de versiones.

En la siguiente tabla, se muestra la versión actual del Sincronizador de configuración disponible en cada canal de versiones:

Canal de versiones	Versión del Sincronizador de configuración
Rápido y regular	1.19
Estable (o sin canal)	1.18.3

Habilita las actualizaciones automáticas

Habilita las actualizaciones automáticas para garantizar que el Sincronizador de configuración se actualice en tus clústeres automáticamente en toda tu flota.

Puedes habilitar las actualizaciones automáticas solo en GKE en los clústeres de Google Cloud con GKE Enterprise habilitado.

Para instalar el Sincronizador de configuración y habilitar las actualizaciones automáticas, sigue las instrucciones que se indican en Instala el Sincronizador de configuración.

Para habilitar las actualizaciones automáticas en un clúster que ya tiene instalado el Sincronizador de configuración, completa los siguientes pasos:

Confirma que tu clúster de GKE esté inscrito en un canal de versiones. Si el clúster de GKE no está inscrito en un canal de versiones, el Sincronizador de configuración se actualiza automáticamente como si el clúster usara el canal de versiones estable de GKE.
Si no configuraste el Sincronizador de configuración para enviar métricas a Cloud Monitoring, otorga permisos de escritura de métricas. Esto es necesario para las actualizaciones automáticas.
Asegúrate de que el Sincronizador de configuración tenga una versión compatible:
Console
1. En la consola de Google Cloud, ve a la página Configuración en la sección Funciones.
  
  Ir a Configuración
2. En la pestaña Configuración, junto al clúster cuya versión deseas actualizar, haz clic en Editar configuración del clúster.
3. En la lista desplegable Versión, selecciona la versión a la que deseas actualizar.
4. Haz clic en Actualizar el Sincronizador de configuración.
gcloud
1. (Opcional) Si deseas verificar qué versión del Sincronizador de configuración está instalada en tus clústeres antes de la actualización, ejecuta el siguiente comando:
  gcloud beta container fleet config-management
2. Para actualizar el Sincronizador de configuración, ejecuta el siguiente comando:
  gcloud beta container fleet config-management upgrade \ --version=VERSION \ --membership=MEMBERSHIP_NAME
  Reemplaza lo siguiente:
  - VERSION: Es la versión a la que deseas actualizar.
  - MEMBERSHIP_NAME: Es el nombre de la membresía de flota que elegiste cuando registraste el clúster. Para encontrar el nombre de la membresía, ejecuta gcloud container fleet memberships list.
Habilita las actualizaciones automáticas del Sincronizador de configuración:
Console
Habilita las actualizaciones automáticas en clústeres individuales

Para habilitar las actualizaciones automáticas en clústeres individuales, completa los siguientes pasos:
1. En la consola de Google Cloud, ve a la página Configuración en la sección Funciones.
  
  Ir a Configuración
2. Haz clic en Configuración del Sincronizador de configuración.
3. Selecciona Editar configuración del clúster para el clúster que deseas actualizar.
4. En el panel de configuración que aparece, selecciona Actualizaciones automáticas.
5. Haz clic en Cambiar la configuración de Sincronizador de configuración. En la pestaña Configuración, después de unos minutos, deberías ver Sí en la columna Actualizaciones automáticas del clúster que seleccionaste.
Habilita las actualizaciones automáticas como configuración predeterminada de la flota

Para habilitar las actualizaciones automáticas en tu flota de clústeres, completa los siguientes pasos:
1. En la consola de Google Cloud, ve a la página Administrador de funciones.
  
  Ir a Administrador de funciones
2. En el panel Sincronizador de configuración, haz clic en Configurar.
3. Para cambiar la configuración predeterminada, haz clic en Personalizar la configuración de la flota.
4. En el cuadro de diálogo que aparece, selecciona Actualizaciones automáticas.
5. Haz clic en Guardar cambios.
6. Opcional: Sincroniza los clústeres existentes con la configuración predeterminada:
  1. Ve a la página Administrador de funciones.
    
    Ir a Administrador de funciones
  2. En el panel Sincronizador de configuración, haz clic en Ver detalles.
  3. En la lista Clústeres de la flota, selecciona los clústeres que deseas sincronizar.
  4. Haz clic en Sincronizar con la configuración de la flota y, luego, en Confirmar en el cuadro de diálogo de confirmación que aparece. Esta operación puede tardar unos minutos en completarse.
gcloud
Para habilitar las actualizaciones automáticas en un clúster individual, completa los siguientes pasos:
1. Actualiza la Google Cloud CLI a la versión más reciente.
  gcloud components update
2. Actualiza tu archivo apply spec existente del sincronizador de configuración para que incluya el campo upgrades: auto, por ejemplo:
  applySpecVersion: 1 spec: upgrades: auto configSync: enabled: true # other fields intentionally omitted
3. Aplica el archivo apply-spec.yaml actualizado:
  gcloud beta container fleet config-management apply \ --membership=MEMBERSHIP_NAME \ --config=CONFIG_YAML_PATH \ --project=PROJECT_ID
  Reemplaza lo siguiente:
  - MEMBERSHIP_NAME: El nombre de la membresía de la flota que elegiste cuando registraste tu clúster, puedes encontrar el nombre con gcloud container fleet memberships list.
  - CONFIG_YAML_PATH: La ruta de acceso a tu archivo apply-spec.yaml.
  - PROJECT_ID: el ID de tu proyecto
4. Confirma que la actualización automática esté habilitada:
  gcloud beta container fleet config-management status \ --project=PROJECT_ID
  Reemplaza PROJECT_ID por el ID del proyecto.
  
  La columna Upgrades muestra "auto" para los clústeres con actualizaciones automáticas habilitadas. Si se produce un error cuando se habilitan las actualizaciones automáticas, la columna Status muestra ERROR con un mensaje de error detallado.

Cambia el canal de versiones

Para obtener información sobre cómo cambiar el canal de versiones de tu clúster, consulta Cambia el canal de versiones de tu clúster en la documentación de GKE. Si tienes habilitadas las actualizaciones automáticas del Sincronizador de configuración, debes tener en cuenta lo siguiente cuando cambies tu canal de versiones:

Si cambias tu canal de versiones a uno menos estable (por ejemplo, de estable a rápido), el Sincronizador de configuración se actualizará automáticamente de la versión más reciente compatible con el canal de versiones original a la versión más reciente compatible con el canal de versiones nuevo.
Si cambias tu canal de versiones a uno más estable (por ejemplo, de rápido a estable), el Sincronizador de configuración no cambiará a versiones anteriores. Con el tiempo, la versión más reciente compatible con el canal de versiones original se promocionará al nuevo canal de versiones. A medida que las versiones más recientes estén disponibles en el nuevo canal de versiones, el Sincronizador de configuración se actualizará automáticamente de forma normal.
Si anulas la suscripción a un canal de versiones, no se verán afectadas las actualizaciones automáticas del Sincronizador de configuración. La versión del Sincronizador de configuración se actualizará como si tu clúster estuviera inscrito en el canal de versiones estable.