Migra a cgroup v2

Google Distributed Cloud solo software en VMware versión 1.35 requiere cgroup v2. A partir de la versión 1.35, Kubernetes ya no admite cgroup v1. En este documento, se explica cómo migrar tus clústeres a cgroup v2.

Antes de comenzar

Para instalar o actualizar Google Distributed Cloud solo software en VMware con Kubernetes 1.35, verifica lo siguiente:

  • Verifica la versión del software: Debes usar Google Distributed Cloud solo software en VMware versión 1.35.00 o posterior.
  • Compatibilidad con cgroup v2 del SO: Debes usar un sistema operativo que admita cgroup v2.
  • Configura cgroup v2 (si es necesario): Si tu SO no usa cgroup v2 de forma predeterminada (por ejemplo, Ubuntu 18.04/20.04), debes configurarlo de forma manual. Para obtener más información, consulta Cómo migrar a cgroup v2 en la documentación de Kubernetes.
  • Actualiza la configuración del clúster: Cambia el campo osImageType de ubuntu, ubuntu_containerd o cos a ubuntu_cgv2 o cos_cgv2 antes de actualizar a la versión 1.35.
  • Prepara imágenes de vSphere: Ejecuta gkectl prepare si faltan imágenes en vSphere.
  • Actualiza las secuencias de comandos de automatización: Revisa y actualiza cualquier secuencia de comandos de automatización para usar los nuevos tipos de imágenes ubuntu_cgv2 o cos_cgv2.

Actualiza el tipo de imagen de SO

Antes de ejecutar gkectl upgrade, cambia osImageType a una imagen compatible con cgroup v2 en el archivo YAML del clúster.

Clúster de administrador

  1. Abre el archivo de configuración del clúster de administrador.
  2. Ubica el campo osImageType.
  3. Cambia el valor a ubuntu_cgv2 (si usas Ubuntu) o cos_cgv2 (si usas COS).

Para obtener más información sobre este campo, consulta la documentación de osImageType.

Clúster de usuario

  1. Abre el archivo de configuración del clúster de usuario.
  2. Ubica el campo osImageType en la sección nodePools.
  3. Cambia el valor a ubuntu_cgv2 (si usas Ubuntu) o cos_cgv2 (si usas COS).

Para obtener más información sobre este campo, consulta la documentación de nodePools[i].osImageType.

Actualiza tu clúster

Después de actualizar osImageType en el archivo de configuración, actualiza tu clúster.

  1. Ejecuta el siguiente comando para actualizar tu clúster:

    gkectl upgrade cluster --config USER_CLUSTER_CONFIG --admin-config ADMIN_CLUSTER_CONFIG

    Reemplaza USER_CLUSTER_CONFIG por la ruta de acceso al archivo de configuración del clúster de usuario. Reemplaza ADMIN_CLUSTER_CONFIG por la ruta de acceso al archivo de configuración del clúster de administrador.

Verificaciones previas

GKE en VMware 1.35 no admite los tipos de imagen de SO ubuntu, ubuntu_containerd y cos. Si intentas crear o actualizar un clúster o un grupo de nodos con estos tipos de imágenes, el sistema bloquea la solicitud durante las verificaciones previas.

Nuevo tipo de imagen de SO predeterminado

El osImageType predeterminado para GKE en VMware 1.35 es ubuntu_cgv2. Si creas una configuración de clúster nueva y dejas en blanco el campo osImageType, el sistema implementa nodos con cgroup v2 habilitado de forma predeterminada.

Si prefieres Container-Optimized OS (COS) en lugar de Ubuntu, configura de forma explícita el campo osImageType en cos_cgv2 en el archivo de configuración.

¿Qué sigue?