Mettre à niveau un cluster non avancé de version 1.32 et le conserver comme non avancé

Par défaut, un cluster non avancé sera automatiquement mis à niveau vers un cluster avancé lorsque vous passerez à la version 1.33. Bien que nous vous recommandions de mettre à niveau un cluster non avancé vers un cluster avancé, si vous devez passer de la version 1.32 à la version 1.33 et conserver le cluster comme non avancé, suivez les étapes décrites dans ce document.

Il n'est possible de conserver un cluster en mode non avancé que pour une mise à niveau de la version 1.32 vers la version 1.33. Lorsque vous mettez à niveau un cluster non avancé de la version 1.33 vers la version 1.34, il est toujours converti en cluster avancé.

Pour en savoir plus, lisez les informations ci-après.

• Pour en savoir plus sur la mise à niveau vers la version 1.32 ou antérieure, consultez Mettre à niveau un cluster.

• Pour savoir comment mettre à niveau un cluster non avancé vers un cluster avancé, consultez Mettre à jour ou migrer un cluster vers un cluster avancé.

Prérequis

• La version de gkectl doit être identique à celle du cluster cible.

  • Si nécessaire, consultez Télécharger gkectl pour obtenir une version compatible de gkectl.

• Diagnostiquez toujours votre cluster avant de le mettre à jour ou à niveau.

• Assurez-vous que vos clusters n'utilisent que les fonctionnalités recommandées.

• Vous devez mettre à niveau le cluster d'administrateur avant de mettre à niveau les clusters d'utilisateur.

Mettre à niveau le cluster d'administrateur

1. Mettez à niveau votre poste de travail administrateur si nécessaire.

2. Importez des images d'OS dans vSphere :

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Remplacez les éléments suivants :

   • BUNDLE_PATH : chemin d'accès au fichier de bundle. Ce fichier se trouve sur votre poste de travail administrateur, dans /var/lib/gke/bundles/. Exemple :

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur

3. Définissez enableAdvancedCluster sur false dans votre fichier de configuration de cluster d'administrateur.

4. Assurez-vous que le champ bundlepath du fichier de configuration du cluster d'administrateur correspond au chemin du bundle vers lequel vous souhaitez effectuer la mise à niveau.

5. Mettez à niveau le cluster d'administrateur et conservez-le en tant que cluster non avancé :

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Remplacez les éléments suivants :

   • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur
   • ADMIN_CLUSTER_CONFIG : chemin d'accès au fichier de configuration du cluster d'administrateur

   La commande recréera tous les nœuds du cluster d'administrateur. Avec la stratégie de déploiement de recréation progressive, les nœuds sont mis à niveau un par un. Lors de la mise à niveau du nœud, la VM est supprimée, puis recréée avec la nouvelle version.

Mettre à niveau le cluster d'utilisateur

Important : Assurez-vous que le cluster d'administrateur a déjà été mis à niveau.

1. Importez des images d'OS dans vSphere :

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Remplacez les éléments suivants :

   • BUNDLE_PATH : chemin d'accès au fichier de bundle. Ce fichier se trouve sur votre poste de travail administrateur, dans /var/lib/gke/bundles/. Exemple :

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur

2. Définissez enableAdvancedCluster sur false dans votre fichier de configuration de cluster d'utilisateur.

3. Assurez-vous que le champ gkeOnPremVersion du fichier de configuration du cluster d'utilisateur correspond à la version cible de votre mise à niveau.

4. Mettez à niveau le cluster d'utilisateur et conservez-le en tant que cluster non avancé :

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Remplacez les éléments suivants :

   • ADMIN_CLUSTER_KUBECONFIG : chemin d'accès au fichier kubeconfig du cluster d'administrateur
   • USER_CLUSTER_CONFIG : chemin d'accès au fichier de configuration du cluster d'utilisateur

   La commande recrée tous les nœuds du cluster d'utilisateur.