Mettre à niveau un cluster non avancé et le conserver comme tel

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.

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.

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.