Séquencer le déploiement des mises à niveau des clusters

Autopilot Standard

Rollout sequencing

• Séquençage du déploiement avec des étapes personnalisées (bêta)
• Séquençage du déploiement (disponibilité générale)

Ce document explique comment gérer les mises à niveau des clusters GKE à l'aide du séquençage du déploiement. Pour en savoir plus sur cette fonctionnalité, consultez À propos des mises à niveau des clusters avec le séquençage du déploiement.

Avant de commencer

• Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

  gcloud init

  Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
• Assurez-vous de disposer de clusters Autopilot ou Standard existants. Pour créer un cluster, consultez la page Créer un cluster Autopilot.
• Assurez-vous d'avoir activé les API requises pour les parcs. Ces API doivent être activées dans vos projets hôtes de parc pour permettre la création de n'importe quel type de séquence de déploiement.
• Pour les instructions Terraform, assurez-vous d'utiliser la version 5.13.0 ou ultérieure du fournisseur google.

Rôles requis

Pour créer ou modifier une séquence de déploiement, vous devez disposer du rôle IAM roles/gkehub.editor sur chaque projet de la séquence de déploiement. Le rôle Éditeur de parc (anciennement Éditeur GKE Hub) fournit les autorisations gkehub.features.create et gkehub.fleet.update, qui sont nécessaires pour accéder aux ressources liées au parc et les modifier entre les projets. Ce rôle fournit les autorisations nécessaires pour définir la stratégie de mise à niveau, accéder aux ressources concernées et les modifier, et lancer et gérer le processus de déploiement.

Si vous devez enregistrer ou annuler l'enregistrement de clusters dans un parc, vous devez disposer de toutes les autorisations suivantes :

• Des autorisations d'enregistrement de cluster, dans vos projets hôtes de parc.
• Autorisations d'administrateur de cluster pour tous les clusters GKE à enregistrer.
• Autorisations d'enregistrement de cluster multiprojets pour tous les clusters GKE à enregistrer dans un parc d'un autre projet.

Pour en savoir plus sur les rôles IAM avec le moins de privilèges requis pour différentes tâches, consultez Obtenir des suggestions de rôles prédéfinis avec l'aide de Gemini.

Configurer une séquence de déploiement

Ce document explique comment créer une séquence de déploiement à l'aide de groupes de clusters organisés par parcs.

Vous pouvez créer une séquence de cinq groupes de clusters au maximum, et choisir le temps de stabilisation des tests souhaité une fois les mises à niveau des clusters terminées dans un groupe (30 jours maximum). Vous pouvez inclure à la fois des clusters Autopilot et Standard.

Pour créer une séquence de déploiement, vos clusters doivent être organisés en groupes de parcs. Pour savoir comment organiser vos clusters, consultez l'exemple de banque communautaire. Une fois que vous avez organisé les clusters en groupes, vous pouvez créer une séquence de déploiement en définissant les relations de groupe en amont et le temps de stabilisation de chaque groupe. Dans une séquence de déploiement, en amont fait référence au groupe précédent et en aval au groupe suivant.

Organiser vos clusters en groupes

Dans une séquence de déploiement, tous les clusters de tous les groupes doivent être enregistrés dans le même canal de publication et dans la même version mineure. Si ces exigences ne sont pas remplies et si les versions présentent des écarts entre les clusters, cela peut entraîner des problèmes lors du déploiement de la version. Pour en savoir plus, consultez Éligibilité au déploiement basé sur le parc.

Si vous avez déjà organisé vos clusters en parcs, vous pouvez ignorer les étapes suivantes et passer à la section Créer une séquence de déploiement.

1. Regroupez vos clusters dans des parcs. Vous pouvez organiser vos clusters par environnement de déploiement, comme les tests, la préproduction et la production, comme indiqué dans l'exemple de séquence de déploiement basée sur un parc.

2. Enregistrez chaque cluster dans un parc en fonction du regroupement choisi.

Créer une séquence de déploiement

Une séquence de déploiement est organisée sous la forme d'une liste associée comportant jusqu'à cinq éléments.

Lorsque vous créez une séquence de déploiement, vous définissez les propriétés suivantes pour chaque parc de clusters :

• Groupe en amont : parc en amont, qui qualifie de nouvelles versions pour le groupe en aval. Vous ne configurez pas de groupe en amont pour le premier groupe d'une séquence.

• Temps de stabilisation : le temps de stabilisation d'un groupe correspond au délai entre la fin des mises à niveau (ou le déploiement a pris 30 jours) et le début des mises à niveau sur le groupe en aval. Pour en savoir plus, consultez la section Fonctionnement de la qualification des versions dans une séquence de déploiement.

Console

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

1. Accédez à la page Séquençage du déploiement dans la console Google Cloud .

   Accéder à la page "Séquençage du déploiement"

2. Cliquez sur Créer une séquence de déploiement.

3. Dans le volet Créer une séquence de déploiement, sélectionnez les deux premiers parcs de la séquence :

   1. Dans la section Parc 1, sélectionnez le premier parc de la séquence.
   2. Dans la section Temps de stabilisation pour le parc en amont, définissez le temps de stabilisation pour le premier parc à l'aide des champs Jours, Heures et Minutes.
   3. Dans la section Flotte 2, sélectionnez la deuxième flotte de la séquence.
   4. Cliquez sur Créer.

4. Facultatif : Si vous souhaitez disposer de trois parcs ou plus dans cette séquence de déploiement, procédez comme suit :

   1. Dans le graphique de déploiement, cliquez sur l'élément correspondant à la deuxième flotte.
   2. Cliquez sur Ajouter un parc en aval.
   3. Dans la section Temps de stabilisation pour le parc en amont, définissez le temps de stabilisation pour le deuxième parc à l'aide des champs Jours, Heures et Minutes.
   4. Dans la section Parc suivant dans la séquence, sélectionnez le troisième parc de la séquence.
   5. Cliquez sur Enregistrer.
   6. Répétez les étapes précédentes si vous souhaitez ajouter une quatrième ou une cinquième flotte.

gcloud

Les instructions suivantes utilisent la commande gcloud container fleet clusterupgrade update, mais vous pouvez définir les mêmes propriétés avec la commande gcloud container fleet clusterupgrade create.

Pour chacune des commandes suivantes, remplacez SOAK_TIME par le temps de stabilisation du parc que vous mettez à jour.

Créez une séquence de déploiement :

1. Définissez le temps de stabilisation pour le premier parc de la séquence :

   gcloud container fleet clusterupgrade update \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_FLEET_PROJECT_ID
   

   Remplacez FIRST_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

2. Définissez le parc en amont et le temps de stabilisation pour le deuxième parc dans la séquence :

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=FIRST_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_FLEET_PROJECT_ID
   

   Remplacez FIRST_FLEET_PROJECT_ID par l'ID du projet hôte du premier parc et SECOND_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

3. Facultatif : Si vous souhaitez disposer de plus de deux parcs dans une séquence de déploiement, définissez le parc en amont pour les prochains parcs de la séquence.

   La commande suivante définit le parc en amont pour le troisième parc de la séquence. Si vous souhaitez ajouter un quatrième ou un cinquième parc, répétez cette étape en suivant le même schéma pour remplacer les variables par les ID de projet des projets hôtes de parc respectifs (parc précédent et parc suivant).

   Remarque : Vous devez définir un temps de stabilisation pour chaque parc, y compris le dernier parc d'une séquence de déploiement.

   Définissez le parc en amont pour le parc suivant de la séquence :

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=SECOND_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_FLEET_PROJECT_ID
   

   Remplacez SECOND_FLEET_PROJECT_ID par l'ID du projet hôte du deuxième parc et THIRD_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

Terraform

Cette section explique comment créer une séquence basée sur un parc à l'aide de Terraform. Vous pouvez également utiliser cette ressource pour mettre à jour la séquence. Pour en savoir plus, consultez la documentation de référence sur google_gke_hub_feature.

Pour chacune des commandes suivantes, remplacez SOAK_TIME par le temps de stabilisation du parc que vous mettez à jour.

Créez une séquence de déploiement :

1. Ajoutez le bloc suivant à votre configuration Terraform pour définir le temps de stabilisation du premier parc dans la séquence :

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = []
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "FIRST_FLEET_PROJECT_ID"
   }
   

   Remplacez FIRST_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

2. Ajoutez le bloc suivant à votre configuration Terraform pour définir le parc en amont et le temps de stabilisation du deuxième parc de la séquence :

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["FIRST_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "SECOND_FLEET_PROJECT_ID"
   }
   

   Remplacez FIRST_FLEET_PROJECT_ID par l'ID du projet hôte du premier parc et SECOND_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

3. Facultatif : Si vous souhaitez disposer de trois parcs dans une séquence de déploiement, ajoutez le bloc suivant à votre configuration Terraform pour configurer le parc en amont du parc dans la séquence :

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["SECOND_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "THIRD_FLEET_PROJECT_ID"
   }
   

   Remplacez SECOND_FLEET_PROJECT_ID par l'ID du projet hôte du deuxième parc et THIRD_FLEET_PROJECT_ID par l'ID du projet hôte du parc.

   Répétez cette étape si vous souhaitez ajouter une quatrième ou une cinquième flotte.

Vérifier l'état d'une séquence de déploiement

Vous pouvez vérifier l'état d'une séquence de déploiement à l'aide de l'une des méthodes suivantes :

• Surveiller une représentation visuelle d'une séquence de déploiement dans la console Google Cloud (preview).
• Utiliser gcloud CLI ou l'API GKE Hub pour vérifier l'état d'une séquence de déploiement.

Pour afficher une séquence de déploiement avec l'une des méthodes précédentes, assurez-vous de disposer du rôle IAM roles/gkehub.viewer pour chaque projet hôte de parc, en particulier si la séquence inclut des parcs dans différents projets. Si vous ne disposez pas des autorisations requises pour un projet, une erreur s'affiche lorsque vous vérifiez l'état de la séquence.

Surveiller une séquence de déploiement dans la console Google Cloud

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

1. Accédez à la page Séquençage du déploiement dans la console Google Cloud .

   Accéder à la page "Séquençage du déploiement"

2. Affichez la séquence dans la section Surveiller votre séquence de déploiement. Si aucune séquence de déploiement ne s'affiche, passez à une autre séquence de déploiement ou créez une séquence de déploiement si vous ne l'avez pas déjà fait.

Surveiller une séquence de déploiement à l'aide de la console

Sur cette page, vous pouvez afficher la séquence de déploiement associée au parc de votre projet. Vous pouvez afficher la progression d'une séquence de déploiement selon deux méthodes :

• Afficher l'intégralité de la séquence de déploiement, ou consulter les états des parcs et des clusters individuels dans ces parcs, ainsi que le temps de stabilisation entre les parcs. Vous pouvez également visualiser la séquence où il n'y a pas de mise à niveau active si vous souhaitez vérifier la configuration de la séquence.
• Filtrer les résultats par type de mise à niveau (plan de contrôle ou nœud) et par version spécifique (par exemple, 1.31.6-gke.500).

Vous pouvez surveiller visuellement l'ensemble de votre séquence de déploiement pendant que GKE met à niveau tous les clusters de la séquence, en qualifiant une nouvelle version dans tous les environnements avant de mettre à niveau les clusters de votre environnement de production. Vous pouvez gérer une séquence de déploiement à l'aide de gcloud CLI et apporter les modifications nécessaires pendant cette surveillance.

Passer à une autre séquence de déploiement

Cette page affiche la séquence de déploiement si le projet actif dans la consoleGoogle Cloud est un projet hôte de parc pour un parc inscrit dans une séquence de déploiement.

Si vous souhaitez afficher une séquence de déploiement différente, sélectionnez un projet hôte de parc associé à une séquence de déploiement différente dans le sélecteur de projets en haut de la page.

Utiliser la CLI gcloud

Vous pouvez vérifier l'état d'une séquence de déploiement, d'un parc dans la séquence ou de clusters individuels dans un parc.

• Pour vérifier l'état d'une séquence de déploiement basée sur un parc, exécutez la commande suivante :

  gcloud container fleet clusterupgrade describe \
      --show-linked-cluster-upgrade --project=FLEET_PROJECT_ID
  

  Remplacez FLEET_PROJECT_ID par l'ID du projet hôte pour n'importe quel parc de la séquence. Consultez la documentation de référence sur gcloud container fleet clusterupgrade describe pour obtenir la liste complète des options.

• Pour vérifier l'état d'un seul parc de la séquence, dans la commande précédente, remplacez l'option --show-linked-cluster-upgrade par l'option --show-cluster-upgrade.

• Pour vérifier l'état des clusters individuels d'un parc, exécutez la commande suivante dans le projet hôte du parc et consultez la section membershipStates :

  gcloud container fleet features describe clusterupgrade
  

La section suivante décrit les informations sur l'état dans le résultat obtenu.

Informations sur l'état d'une séquence de déploiement

Lorsque vous vérifiez l'état d'un déploiement de version, vous pouvez voir la progression de chaque groupe et de chaque cluster au sein de ce groupe.

Consultez le tableau suivant pour connaître les états potentiels d'un cluster ou d'un groupe :

État	Pour un seul cluster	Pour un parc
INÉLIGIBLE	Ce cluster n'est pas éligible pour cette mise à niveau.	Un ou plusieurs clusters de ce groupe ne sont pas éligibles pour cette mise à niveau.
EN ATTENTE	La mise à niveau est en attente sur le cluster ou sur certains de ses pools de nœuds standards, ou sur des groupes de nœuds dans un cluster Autopilot.	La mise à niveau n'a démarré sur aucun des clusters du groupe.
IN_PROGRESS (EN_COURS)	La mise à niveau est en cours sur le cluster.	La mise à niveau a commencé sur au moins un cluster, mais n'est pas terminée sur tous les clusters.
STABILISATION	La mise à niveau a été terminée sur le cluster et n'est pas encore stabilisée.	La mise à niveau a été terminée sur tous les clusters et n'est pas encore stabilisée.
FORCED_SOAKING	La mise à niveau a pris plus de temps (30 jours). Nous l'avons donc forcée à entrer dans la phase de stabilisation. La mise à niveau peut continuer dans le cluster.	La mise à niveau a pris plus de temps (30 jours). Nous l'avons donc forcée à entrer dans la phase de stabilisation. La mise à niveau peut continuer dans les clusters.
TERMINÉ	La mise à niveau est traitée comme "terminée", ce qui signifie que la mise à niveau a terminé de se stabiliser sur ce cluster.	La mise à niveau est considérée comme "terminée" et prête à être utilisée par le groupe en aval, ce qui signifie que la mise à niveau a terminé de se stabiliser.

Dans le résultat de ces commandes, les attributs clusterUpgrade(s).spec et clusterUpgrade(s).state contiennent des informations supplémentaires sur la mise à niveau du cluster, telles que le temps de stabilisation, les remplacements de mise à niveau du cluster et l'état de la mise à niveau.

Gérer une séquence de déploiement

Vous pouvez contrôler les mises à niveau automatiques des clusters avec le séquençage du déploiement de plusieurs manières, comme expliqué dans les sections suivantes.

Modifier le temps de stabilisation d'un groupe

Vous pouvez modifier le temps de stabilisation par défaut d'un groupe ou le temps de stabilisation lorsque ce groupe passe à une version spécifique. La valeur maximale est de 30 jours.

Modifier le temps de stabilisation par défaut

Vous pouvez modifier la durée d'imprégnation par défaut dans la console Google Cloud (version preview) ou avec la gcloud CLI.

Console

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

1. Accédez à la page Séquençage du déploiement dans la console Google Cloud .

   Accéder à la page "Séquençage du déploiement"

2. Affichez la séquence dans la section Surveiller votre séquence de déploiement. Si aucune séquence de déploiement ne s'affiche, passez à une autre séquence de déploiement ou créez une séquence de déploiement si vous ne l'avez pas déjà fait.

3. Dans le graphique de déploiement, cliquez sur l'élément Temps de stabilisation après l'élément de la flotte pour lequel vous souhaitez modifier le temps de stabilisation.

4. Cliquez sur Modifier le temps de trempage.

5. Dans la section Définir un nouveau délai de trempage, saisissez un nouveau délai de trempage dans les champs Jours, Heures et Minutes.

6. Pour enregistrer les paramètres, cliquez sur Enregistrer.

gcloud

Pour modifier la durée de stabilisation par défaut d'un groupe, utilisez les commandes gcloud CLI des instructions Créer une séquence de déploiement en omettant les indicateurs permettant de définir le groupe en amont.

Ignorer le temps de stabilisation par défaut

Vous pouvez modifier le temps de stabilisation pour un déploiement de version spécifique afin qu'il soit différent du temps de stabilisation par défaut pour le groupe. Par exemple, si vous avez déjà qualifié une nouvelle version et que vous souhaitez que les mises à niveau commencent dans le groupe suivant, vous pouvez définir le temps de stabilisation sur zéro. Vous pouvez également l'utiliser si vous souhaitez obtenir plus de temps que le temps de stabilisation par défaut pour qualifier une version spécifique.

Le temps de stabilisation étant défini par groupe, si vous souhaitez remplacer le temps de stabilisation pour d'autres groupes de cette séquence, mettez-les à jour à l'aide de cette même commande avec le nom du parc remplacé.

Pour les instructions de cette section, remplacez les variables suivantes :

• SOAK_TIME : temps de stabilisation à utiliser autre que la valeur par défaut (par exemple, "0d" si vous souhaitez ignorer le temps de stabilisation pour un déploiement de version).
• UPGRADE_NAME : type de mise à niveau, soit k8s_control_plane pour les mises à niveau du plan de contrôle, soit k8s_node pour les mises à niveau des nœuds.

• VERSION : version de GKE pour laquelle vous souhaitez remplacer le temps de stabilisation par défaut après le déploiement de la version (par exemple, 1.25.2-gke.400) dans ce groupe.

gcloud

Exécutez la commande suivante dans le projet hôte du parc dans lequel vous souhaitez remplacer le temps de stabilisation utilisé pour le déploiement d'une version spécifique.

gcloud container fleet clusterupgrade update
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

Terraform

Ajoutez le bloc gke_upgrades_overrides suivant à votre configuration Terraform dans le bloc clusterupgrade pour remplacer le temps de stabilisation utilisé pour le déploiement d'une version spécifique :

gke_upgrade_overrides {
    upgrade {
      name = "UPGRADE_NAME"
      version = "VERSION"
    }
    post_conditions {
      soaking = "SOAK_TIME"
    }
  }

Mettre à jour les groupes d'une séquence de déploiement

Vous pouvez mettre à jour une séquence de déploiement existante pour ajouter ou supprimer des groupes dans la séquence, ou en modifier l'ordre. Pour effectuer ces modifications, mettez à jour les associations entre les groupes.

Vous pouvez effectuer ces étapes dans la console Google Cloud (version preview) ou avec la gcloud CLI.

Console

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

1. Accédez à la page Séquençage du déploiement dans la console Google Cloud .

   Accéder à la page "Séquençage du déploiement"

2. Affichez la séquence dans la section Surveiller votre séquence de déploiement. Si aucune séquence de déploiement ne s'affiche, passez à une autre séquence de déploiement ou créez une séquence de déploiement si vous ne l'avez pas déjà fait.

3. Dans le graphique de déploiement, cliquez sur les éléments correspondant aux flottes existantes dans la séquence. Après avoir cliqué sur ces éléments, vous pouvez effectuer les actions suivantes pour apporter les modifications :

   • Cliquez sur Ajouter un parc en aval.
   • Cliquez sur Ajouter un parc en amont.
   • Cliquez sur Supprimer le parc.

Vous pouvez effectuer des actions telles que les suivantes :

• Ajoutez un autre parc à la fin de la séquence de déploiement en ajoutant un parc en aval au dernier parc de la séquence.
• Ajoutez un autre parc au début de la séquence de déploiement en ajoutant un parc en amont au premier parc de la séquence.
• Modifiez l'ordre des parcs dans la séquence de déploiement en supprimant des parcs, puis en les ajoutant à nouveau avec un autre parc en amont ou en aval.
• Supprimez le premier parc de la séquence de déploiement.
• Supprimez la dernière flotte de la séquence de déploiement.
• Supprimez le parc intermédiaire de la séquence de déploiement, après avoir supprimé le premier ou le dernier parc de la séquence.

gcloud

Pour ajouter ou modifier des flottes en amont, utilisez la commande gcloud container fleet clusterupgrade update avec l'option --upstream-fleet. Pour supprimer un parc en amont, utilisez l'option --reset-upstream-fleet .

Vous pouvez effectuer des actions telles que les suivantes :

• Ajoutez un autre parc au début de la séquence de déploiement en ajoutant un parc en amont au premier parc de la séquence.
• Modifiez l'ordre des parcs dans la séquence de déploiement en modifiant les associations de parcs en amont.
• Supprimez le premier parc de la séquence de déploiement en supprimant le parc en amont du deuxième parc.

Retarder l'achèvement du déploiement de la version du groupe

Si vous devez empêcher temporairement un groupe de terminer le déploiement d'une nouvelle version sur ses clusters, vous pouvez ajouter une exclusion de maintenance à tout cluster qui n'est pas mis à niveau vers la version cible. Cela peut suspendre le délai d'évaluation d'un groupe ou le laisser en aval pendant 30 jours maximum. Au bout de 30 jours, le groupe commence à se stabiliser.

Vous pouvez également modifier le temps de stabilisation pour ce groupe sur 30 jours afin de maximiser la durée d'attente de la séquence de déploiement avant de passer au groupe suivant.

Si vous devez retarder davantage les mises à niveau à venir pour le groupe suivant, vous pouvez utiliser des exclusions de maintenance pour les clusters du groupe suivant.

Supprimer une séquence

Pour supprimer une séquence, vous devez supprimer les associations en amont pour chacun des groupes, à l'exception du premier. Le premier groupe n'a pas de groupe en amont.

Vous pouvez effectuer ces étapes dans la console Google Cloud (version preview) ou avec la gcloud CLI.

Console

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

1. Accédez à la page Séquençage du déploiement dans la console Google Cloud .

   Accéder à la page "Séquençage du déploiement"

2. Affichez la séquence dans la section Surveiller votre séquence de déploiement. Si aucune séquence de déploiement ne s'affiche, passez à une autre séquence de déploiement ou créez une séquence de déploiement si vous ne l'avez pas déjà fait.

3. Dans le graphique de déploiement, cliquez sur l'élément correspondant à la dernière flotte.

4. Cliquez sur Supprimer le parc.

5. Pour supprimer le parc, cliquez sur Supprimer.

6. Répétez les trois étapes précédentes jusqu'à ce qu'il ne reste que la première flotte.

   Réussite : une fois la connexion restante entre les parcs supprimée, le graphique de déploiement continue d'afficher un parc sans aucune connexion. Si c'est le cas, vous avez bien supprimé la séquence de déploiement.

gcloud

Exécutez la commande suivante dans le projet hôte de parc de chacun des parcs de la séquence de déploiement, à l'exception du premier parc :

gcloud container fleet clusterupgrade update --reset-upstream-fleet

Dépannage

Résoudre les problèmes d'éligibilité au déploiement

Si tous les clusters d'une séquence de déploiement n'ont pas la même cible de mise à niveau, GKE risque de ne pas pouvoir procéder aux mises à niveau des clusters. Les mises à niveau automatiques ne peuvent pas être effectuées si un groupe en amont ne qualifie pas une cible de mise à niveau à transmettre au groupe en aval. Les mises à niveau automatiques ne peuvent pas non plus être effectuées si les clusters du groupe en amont qualifient une cible de mise à niveau non valide pour les clusters du groupe en aval.

Pour vérifier si votre séquence de déploiement présente des problèmes d'éligibilité, vérifiez l'état de la séquence de déploiement. Si un groupe n'est pas éligible, suivez les instructions pour afficher l'état des clusters individuels dans un groupe.

Pour faire progresser immédiatement les mises à niveau des clusters, supprimez tous les clusters dont l'état est INELIGIBLE en suivant les instructions de la section Faire progresser les déploiements partiellement éligibles.

Corriger l'éligibilité dans un groupe

Si un cluster n'est pas éligible car il utilise une version antérieure (par exemple, la plupart des clusters du groupe sont mis à niveau de la version 1.23 vers la version 1.24 et un cluster se trouve dans la version 1.22), vous pouvez mettre à jour le cluster manuellement vers la version 1.24 pour résoudre l'écart de version.

Dans un groupe, GKE ignore les clusters dont la version est plus récente que la version cible de mise à niveau automatique. Ces clusters n'empêchent pas les mises à niveau de se poursuivre vers le groupe en aval.

Corriger l'éligibilité entre les groupes

Entre les groupes, en cas de non-concordance dans les cibles de mise à niveau où le groupe en aval se trouve sur une version plus récente (par exemple, le groupe en amont est passé de la version 1.23 à la version 1.24, et les clusters du groupe en aval se trouvent dans la version 1.25), vous pouvez mettre à niveau manuellement les clusters du groupe en amont vers la version 1.25 pour vous assurer que les mises à niveau se poursuivent.

Entre les groupes, en cas de non-concordance dans les cibles de mise à niveau où le groupe en aval se trouve dans une version antérieure (par exemple, le groupe en amont est passé de 1.24 à 1.25, et les clusters du groupe en aval se trouvent dans la version 1.23), vous pouvez mettre à niveau manuellement les clusters du groupe en aval vers la version 1.24 ou 1.25 pour vous assurer que les mises à niveau se poursuivent. Si GKE a mis à niveau le groupe en amont vers une version à laquelle le groupe en aval est éligible, GKE met à niveau les clusters du groupe en aval vers cette cible de mise à niveau. Dans ce cas, vous n'avez pas besoin de mettre à niveau manuellement les clusters pour débloquer la séquence. Pour en savoir plus, consultez Le groupe en amont a qualifié plusieurs cibles de mise à niveau pour le groupe en aval.

Faire progresser les déploiements partiellement éligibles

Si les mises à niveau de cluster d'un groupe ne se terminent pas en raison de problèmes d'éligibilité au déploiement (par exemple, des écarts de version au sein d'un groupe), vous pouvez supprimer les clusters qui ne sont pas éligibles à la cible de mise à niveau du groupe pour terminer le déploiement de la version et commencer le temps d'imprégnation ou passer au groupe suivant de la séquence de déploiement. Vous pouvez également supprimer un cluster d'un groupe pour d'autres raisons, par exemple si l'utilisation de ce cluster n'est plus liée aux autres clusters du groupe.

Suivez les instructions pour annuler l'enregistrement d'un cluster d'un parc.

Une fois que vous avez supprimé tous les clusters qui empêchent le déploiement de la version d'un groupe, celui-ci peut se terminer. Pour vérifier cela, suivez les instructions de la section Vérifier l'état d'un déploiement de version.

Étapes suivantes

• À propos des mises à niveau des clusters avec séquençage du déploiement