Mettre à jour ou migrer un cluster vers un cluster avancé

Ce document explique comment mettre à jour ou migrer un cluster vers un cluster avancé à partir de la version 1.32.

Important : Les clusters non avancés seront automatiquement mis à niveau vers des clusters avancés dans la version 1.33.

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.

• Avant de commencer la mise à jour ou la mise à niveau, vérifiez que vos clusters n'utilisent aucune fonctionnalité non compatible avec les clusters avancés. Si des fonctionnalités non compatibles sont actives, désactivez-les d'abord à l'aide de update.

  • Bien que les clusters d'utilisateur à haute disponibilité (HA) soient requis sur les clusters avancés, vous pouvez toujours mettre à jour ou migrer un cluster d'utilisateur non HA vers un cluster avancé HA en suivant ce guide.

• Vous devez mettre à jour ou migrer le cluster d'administrateur vers un cluster avancé avant de mettre à jour ou de migrer des clusters d'utilisateur.

Mettre à jour ou à niveau le cluster d'administrateur vers un cluster avancé

Mettre à jour

Important : Assurez-vous que la version de votre cluster est au moins la version 1.32.0.

1. Préparez-vous pour le cluster avancé :

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

   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.32.0-gke.1085-full.tgz
     

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

2. Définissez enableAdvancedCluster sur true dans votre fichier de configuration de cluster d'administrateur.

3. Mettez à jour le cluster d'administrateur vers le cluster avancé :

   gkectl update 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

Attention : Si votre cluster utilise cos ou cos_cgv2 comme type d'image d'OS du plan de contrôle ou type d'image d'OS du pool de nœuds, assurez-vous que la version de votre cluster est au moins 1.32.0 avant de le mettre à niveau. Sinon, assurez-vous que la version de votre cluster est au moins 1.31.100.

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

2. Préparez-vous pour le cluster avancé :

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

   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.32.0-gke.1085-full.tgz
     

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

3. Définissez enableAdvancedCluster sur true 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 vers le cluster 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 "Recréer le déploiement", 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.

Une fois le cluster d'administrateur mis à jour ou migré vers un cluster avancé :

• Vos clusters d'utilisateur non avancés existants continuent de fonctionner normalement.

• Vous ne pouvez créer que des clusters d'utilisateur avancés gérés par le cluster d'administrateur avancé.

Nous vous recommandons de mettre à niveau tous les clusters d'utilisateur vers des clusters avancés peu de temps après pour maintenir un environnement cohérent et complet.

Mettre à jour ou migrer le cluster d'utilisateur vers un cluster avancé

Important : Assurez-vous que le cluster d'administrateur a déjà été mis à jour ou migré vers le cluster avancé.

Mettre à jour

Important : Assurez-vous que la version de votre cluster est au moins la version 1.32.0.

1. Si le plan de contrôle de votre cluster d'utilisateur n'est pas disponibilité élevée :

   Attention : En raison d'un problème connu avec le champ masterNode.replicas, pour mettre à jour un cluster d'utilisateur non HA de version 1.32 ou 1.33 vers un cluster avancé HA, votre cluster doit être de version supérieure à 1.32.600 ou 1.33.100, respectivement.

   1. Remplacer masterNode.replicas par 3.

   2. Ajoutez les adresses IP statiques des nœuds de plan de contrôle du cluster d'utilisateur à la section network.controlPlaneIPBlock.ips.

2. Préparez-vous pour le cluster avancé :

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

   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.32.0-gke.1085-full.tgz
     

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

3. Définissez enableAdvancedCluster sur true dans votre fichier de configuration du cluster d'utilisateur.

4. Mettez à jour le cluster d'utilisateur vers le cluster avancé :

   gkectl update 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éera tous les nœuds du cluster d'utilisateur. Avec la stratégie de déploiement "recreate", les nœuds sont mis à jour un par un. Lors de la mise à jour du nœud, la VM est supprimée, puis recréée avec la nouvelle configuration.

Mettre à niveau

Attention : Si votre cluster utilise cos ou cos_cgv2 comme type d'image d'OS du plan de contrôle ou type d'image d'OS du pool de nœuds, assurez-vous que la version de votre cluster est au moins 1.32.0 avant de le mettre à niveau. Sinon, assurez-vous que la version de votre cluster est au moins 1.31.100.

1. Si le plan de contrôle de votre cluster d'utilisateur n'est pas disponibilité élevée :

   1. Remplacer masterNode.replicas par 3.

   2. Ajoutez les adresses IP statiques des nœuds de plan de contrôle du cluster d'utilisateur à la section network.controlPlaneIPBlock.ips.

2. Préparez-vous pour le cluster avancé :

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

   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.32.0-gke.1085-full.tgz
     

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

3. Définissez enableAdvancedCluster sur true dans votre fichier de configuration de cluster d'utilisateur.

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

5. Mettez à niveau le cluster d'utilisateur vers le cluster 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.

Principales différences après le passage aux clusters avancés

La mise à niveau ou la mise à jour de votre cluster vers un cluster avancé introduit plusieurs différences clés par rapport aux clusters standards. Voici les principaux changements apportés aux clusters avancés :

• Emplacement des ressources : les ressources de cluster et de machine ne se trouvent plus dans les clusters d'utilisateur. Ces ressources se trouvent exclusivement dans le cluster d'administrateur.

• NodeExternalIP : NodeExternalIP n'est pas défini sur les nœuds.

• Installation de cert-manager : cert-manager est automatiquement installé sur les clusters avancés. Si vous avez installé cert-manager dans votre cluster, la mise à jour ou la mise à niveau vers un cluster avancé l'écrasent avec la version avancée du cluster.

Pour obtenir une présentation complète des différences entre les fonctionnalités, consultez le tableau comparatif des fonctionnalités.