Migrer vers cgroup v2

Google Distributed Cloud (logiciel uniquement) sur VMware version 1.35 nécessite cgroup v2. À partir de la version 1.35, Kubernetes n'est plus compatible avec cgroup v1. Ce document explique comment migrer vos clusters vers cgroup v2.

Avant de commencer

Pour installer ou mettre à niveau Google Distributed Cloud (logiciel uniquement) sur VMware avec Kubernetes 1.35, vérifiez les points suivants :

  • Vérifiez la version du logiciel : vous devez utiliser Google Distributed Cloud (logiciel uniquement) sur VMware version 1.35.00 ou ultérieure.
  • Compatibilité de l'OS avec cgroup v2 : vous devez utiliser un système d'exploitation compatible avec cgroup v2.
  • Configurez cgroup v2 (si nécessaire) : si votre OS n'utilise pas cgroup v2 par défaut (par exemple, Ubuntu 18.04/20.04), vous devez le configurer manuellement. Pour en savoir plus, consultez la section Migrer vers cgroup v2 de la documentation Kubernetes.
  • Mettez à jour la configuration du cluster : remplacez le champ osImageType par ubuntu_cgv2 ou cos_cgv2 au lieu de ubuntu, ubuntu_containerd ou cos avant de passer à la version 1.35.
  • Préparez les images vSphere : exécutez gkectl prepare si des images sont manquantes dans vSphere.
  • Mettez à jour les scripts d'automatisation : examinez et mettez à jour tous les scripts d'automatisation pour utiliser les nouveaux types d'images ubuntu_cgv2 ou cos_cgv2.

Mettre à jour le type d'image de l'OS

Avant d'exécuter gkectl upgrade, remplacez osImageType par une image compatible avec cgroup v2 dans le fichier YAML de votre cluster.

Cluster d'administrateur

  1. Ouvrez le fichier de configuration de votre cluster d'administrateur.
  2. Recherchez le champ osImageType.
  3. Remplacez la valeur par ubuntu_cgv2 (si vous utilisez Ubuntu) ou cos_cgv2 (si vous utilisez COS).

Pour en savoir plus sur ce champ, consultez la documentation concernant osImageType.

Cluster d'utilisateur

  1. Ouvrez le fichier de configuration de votre cluster d'utilisateur.
  2. Recherchez le champ osImageType dans la section nodePools.
  3. Remplacez la valeur par ubuntu_cgv2 (si vous utilisez Ubuntu) ou cos_cgv2 (si vous utilisez COS).

Pour en savoir plus sur ce champ, consultez la documentation concernant nodePools[i].osImageType.

Mettre à niveau votre cluster

Après avoir mis à jour osImageType dans votre fichier de configuration, mettez à niveau votre cluster.

  1. Exécutez la commande suivante pour mettre à niveau votre cluster :

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

    Remplacez USER_CLUSTER_CONFIG par le chemin d'accès au fichier de configuration de votre cluster d'utilisateur. Remplacez ADMIN_CLUSTER_CONFIG par le chemin d'accès au fichier de configuration de votre cluster d'administrateur.

Vérifications préliminaires

GKE sur VMware 1.35 n'est pas compatible avec les types d'images d'OS ubuntu, ubuntu_containerd et cos. Si vous tentez de créer ou de mettre à niveau un cluster ou un pool de nœuds avec ces types d'images, le système bloque la requête lors des vérifications préliminaires.

Nouveau type d'image d'OS par défaut

osImageType par défaut pour GKE sur VMware 1.35 est ubuntu_cgv2. Si vous créez une configuration de cluster et que vous laissez le champ osImageType vide, le système déploie des nœuds avec cgroup v2 activé par défaut.

Si vous préférez Container-Optimized OS (COS) à Ubuntu, définissez explicitement le champ osImageType sur cos_cgv2 dans votre fichier de configuration.

Étape suivante