Mettre à jour un cluster ou le convertir en cluster avancé

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

Prérequis

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

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

  • Vérifiez que vos clusters n'utilisent aucune fonctionnalité non compatible avec les clusters avancés avant de lancer la mise à jour ou la mise à niveau. Si des fonctionnalités non compatibles sont actives, commencez par les désactiver à l'aide de update.

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

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

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

Mettre à jour

  1. Préparez 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ée tous les nœuds du cluster d'administrateur.

Mettre à niveau

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

  2. Préparez 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ée tous les nœuds du cluster d'administration.

Une fois le cluster d'administrateur mis à jour ou converti en cluster avancé:

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

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

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

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

Mettre à jour

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

    1. Remplacez la valeur 1 par 3 pour masterNode.replicas.

    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 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 le fichier de configuration du cluster d'utilisateur.

  4. Mettez à jour le cluster d'utilisateur en 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ée tous les nœuds du cluster d'utilisateur.

Mettre à niveau

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

    1. Remplacez la valeur 1 par 3 pour masterNode.replicas.

    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 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 le fichier de configuration du 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.