Mettre à jour les images Kubernetes et de nœuds sur plusieurs clusters à l’aide d’Azure Kubernetes Fleet Manager

Les administrateurs de plateforme qui gèrent un grand nombre de clusters rencontrent souvent des problèmes lors de la préproduction des mises à jour de plusieurs clusters (par exemple, mettre à niveau les versions des images de système d’exploitation de nœud ou de Kubernetes) de façon sûre et prévisible. Pour résoudre ce problème, Azure Kubernetes Fleet Manager (Fleet) vous permet d’orchestrer les mises à jour sur plusieurs clusters à l’aide d’exécutions de mises à jour.

Les exécutions de mises à jour se composent d’étapes, de groupes et de stratégies, et peuvent être appliquées manuellement pour les mises à jour ponctuelles, ou automatiquement pour les mises à jour régulières en cours à l’aide de profils de mise à niveau automatique. Toutes les exécutions de mises à jour (manuelles ou automatisées) respectent les fenêtres de maintenance des clusters membres.

Ce guide explique comment configurer et exécuter manuellement des exécutions de mises à jour.

Prérequis

• Lisez la vue d’ensemble des concepts de cette fonctionnalité, qui fournit une explication des stratégies, des exécutions, des phases et des groupes de mises à jour référencés dans ce guide.

• Vous devez disposer d’une ressource Fleet avec un ou plusieurs clusters membres. Si ce n’est pas le cas, suivez le guide de démarrage rapide pour créer une ressource Fleet et rejoindre des clusters Azure Kubernetes Service (AKS) en tant que membres.

• Définissez les variables d’environnement suivantes :

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export AKS_CLUSTER_ID=<aks-cluster-resource-id>
  

• Si vous suivez les instructions Azure CLI de cet article, vous devez avoir Azure CLI version 2.58.0 ou ultérieure installé. Pour installer ou mettre à niveau Azure CLI, consultez Installer l’interface de ligne de commande Microsoft Azure.

• Vous avez également besoin de l’extension Azure CLI fleet , que vous pouvez installer en exécutant la commande suivante :

  az extension add --name fleet
  

  Exécutez la commande az extension update pour effectuer une mise à jour vers la dernière version de l’extension publiée :

  az extension update --name fleet
  

Création d’exécutions de mises à jour

Les exécutions de mises à jour prennent en charge deux options pour la séquence de mise à niveau des clusters :

• Un par un : si cela ne vous intéresse pas de contrôler la séquence de mise à niveau des clusters, one-by-one offre une approche simple pour mettre à niveau tous les clusters membres de la flotte en séquence l’un après l’autre.
• Contrôler la séquence des clusters à l’aide de groupes et de phases de mises à jour : si vous souhaitez contrôler la séquence de mise à niveau des clusters, vous pouvez structurer les clusters membres dans des groupes de mises à jour et des phases de mise à jour. Vous pouvez stocker cette séquence comme modèle sous la forme d’une stratégie de mise à jour. Vous pouvez créer des exécutions de mises à jour ultérieurement avec les stratégies de mise à jour au lieu de définir la séquence chaque fois que vous avez besoin de créer une exécution de mises à jour.

Remarque

Les exécutions de mises à jour respectent les fenêtres de maintenance planifiée que vous définissez au niveau du cluster AKS. Pour plus d’informations, consultez Maintenance planifiée sur plusieurs clusters membres, qui explique comment les exécutions de mises à jour gèrent les clusters membres configurés avec des fenêtres de maintenance planifiée.

Mettez à jour tous les clusters un par un

Azure portal

1. Dans le portail Azure, accédez à votre ressource Azure Kubernetes Fleet Manager.

2. Dans le menu du service, sous Paramètres, sélectionnez Mise à jour multi-cluster>Créer une exécution.

3. Entrez un nom pour l’exécution de mises à jour, puis sélectionnez Un par un comme type de mise à niveau.

   

4. Sélectionnez l’une des options suivantes pour l’Étendue de mise à niveau :

   • Version de Kubernetes pour les pools de nœuds et de plan de contrôle
   • Version de Kubernetes pour uniquement le plan de contrôle du cluster
   • Version de l’image de nœud uniquement

5. Sélectionnez l’une des options suivantes pour l’Image de nœud :

   • Dernière image : met à jour chaque cluster AKS dans l’exécution de mises à jour avec la dernière image disponible pour ce cluster dans sa région.
   • Image cohérente : car il est possible pour une exécution de mises à jour d’avoir des clusters AKS dans plusieurs régions où les dernières images de nœud disponibles peuvent être différentes (consultez le suivi de publications pour plus d’informations). L’exécution de la mise à jour sélectionne l’image courante la plus récente dans toutes ces régions pour obtenir une cohérence.

   

6. Sélectionnez Créer pour créer l’exécution de mises à jour.

Azure CLI

1. Créez une exécution de mises à jour à l’aide de la commande az fleet updaterun create avec les valeurs de votre choix pour les indicateurs --upgrade-type et --node-image-selection. La commande suivante crée une exécution de mises à jour qui met à niveau la version Kubernetes pour le plan de contrôle et les pools de nœuds et utilise l’image de nœud la plus récente disponible pour chaque cluster dans sa région.

   L’indicateur --upgrade-type prend en charge les valeurs suivantes :

   • Full met à niveau la version de Kubernetes pour les pools de nœuds et de plan de contrôle, ainsi que les images de nœud.
   • ControlPlaneOnly met uniquement à niveau la version Kubernetes pour le plan de contrôle du cluster.
   • NodeImageOnly met uniquement à niveau les images de nœud.

   L’indicateur --node-image-selection prend en charge les valeurs suivantes :

   • Latest : met à jour chaque cluster AKS dans l’exécution de mises à jour avec la dernière image disponible pour chaque cluster dans sa région.
   • Consistent : car il est possible pour une exécution de mises à jour d’avoir des clusters AKS dans plusieurs régions où les dernières images de nœud disponibles peuvent être différentes (consultez le suivi des publications pour plus d’informations). L’exécution de la mise à jour sélectionne l’image courante la plus récente dans toutes ces régions pour obtenir une cohérence.

   az fleet updaterun create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1 \
    --upgrade-type Full \
    --kubernetes-version 1.26.0 \
    --node-image-selection Latest
   

2. Démarrez l’exécution de mises à jour à l’aide de la commande az fleet updaterun start.

   az fleet updaterun start \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1
   

Lors de la création d’une exécution de mise à jour, vous avez la possibilité de contrôler l’étendue de l’exécution de la mise à jour. L’indicateur --upgrade-type prend en charge les valeurs suivantes :

• ControlPlaneOnly met uniquement à niveau la version Kubernetes pour le plan de contrôle du cluster.
• Full met à niveau la version de Kubernetes pour les pools de nœuds et de plan de contrôle, ainsi que les images de nœud.
• NodeImageOnly met uniquement à niveau les images de nœud.

De plus, l’indicateur --node-image-selection prend en charge les valeurs suivantes :

• Dernière : met à jour chaque cluster AKS dans l’exécution de mise à jour vers la dernière image disponible pour ce cluster dans sa région.
• Cohérent : comme il est possible pour une exécution de mise à jour d’avoir des clusters AKS dans plusieurs régions où les dernières images de nœud disponibles peuvent être différentes (vérifiez suivi de mise en production pour plus d’informations). L’exécution de la mise à jour sélectionne l’image courante la plus récente dans toutes ces régions pour obtenir une cohérence.

Commencer une exécution de mises à jour :

Pour démarrer les exécutions de mise à jour, exécutez la commande suivante :

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>

Mettre à jour les clusters en utilisant des groupes et des phases

Vous pouvez définir une exécution de mises à jour à l’aide de phases de mise à jour pour déterminer l’ordre séquentiel de la mise en application des mises à jour sur différents groupes de mises à jour. Par exemple, une première phase de mises à jour peut mettre à jour les clusters membres de l’environnement de test, et une deuxième phase de mises à jour met à jour les clusters membres de l’environnement de production. Vous pouvez également spécifier un temps d’attente entre les étapes de mise à jour. Vous pouvez stocker cette séquence comme modèle sous la forme d’une stratégie de mise à jour.

Azure portal

1. Dans le portail Azure, accédez à votre ressource Azure Kubernetes Fleet Manager.

2. Dans le menu du service, sous Paramètres, sélectionnez Mise à jour multi-cluster>Créer une exécution.

3. Entrez un nom pour l’exécution de mises à jour, puis sélectionnez Phases pour le type de séquence de mise à jour.

   

4. Sélectionnez Créer une phase, puis entrez un nom pour la phase et le temps d’attente entre les phases.

   

5. Sélectionnez les groupes de mises à jour que vous souhaitez inclure dans cette phase. Vous pouvez également spécifier l’ordre des groupes de mises à jour si vous souhaitez les mettre à jour dans une séquence spécifique. Sélectionnez Créer lorsque vous avez terminé.

   

6. Sélectionnez l’une des options suivantes pour l’Étendue de mise à niveau :

   • Version de Kubernetes pour les pools de nœuds et de plan de contrôle
   • Version de Kubernetes pour uniquement le plan de contrôle du cluster
   • Version de l’image de nœud uniquement

7. Sélectionnez l’une des options suivantes pour l’Image de nœud :

   • Dernière image : met à jour chaque cluster AKS dans l’exécution de mises à jour avec la dernière image disponible pour ce cluster dans sa région.
   • Image cohérente : car il est possible pour une exécution de mises à jour d’avoir des clusters AKS dans plusieurs régions où les dernières images de nœud disponibles peuvent être différentes (consultez le suivi de publications pour plus d’informations). L’exécution de la mise à jour sélectionne l’image courante la plus récente dans toutes ces régions pour obtenir une cohérence.

   

8. Sélectionnez Créer pour créer l’exécution de mises à jour.

   Spécifier et organiser les phases à chaque création d’exécution de mise à jour peut être répétitif et laborieux. Les stratégies de mise à jour simplifient ce processus en vous permettant de stocker des modèles pour les exécutions de mises à jour. Pour plus d’informations, consultez Mise à jour de la création et de l’utilisation de stratégie.

9. Dans le menu Mise à jour multi-cluster, sélectionnez l’exécution de mises à jour, puis Démarrer.

Azure CLI

1. Créez un fichier JSON pour définir les phases et les groupes pour l’exécution de mises à jour. Voici un exemple d’entrée à partir du fichier d’étapes (example-stages.json) :

   {
       "stages": [
           {
               "name": "stage1",
               "groups": [
                   {
                       "name": "group-1a"
                   },
                   {
                       "name": "group-1b"
                   },
                   {
                       "name": "group-1c"
                   }
               ],
               "afterStageWaitInSeconds": 3600
           },
           {
               "name": "stage2",
               "groups": [
                   {
                       "name": "group-2a"
                   },
                   {
                       "name": "group-2b"
                   },
                   {
                       "name": "group-2c"
                   }
               ]
           }
       ]
   }
   

2. Créez une exécution de mises à jour à l’aide de la commande az fleet updaterun create avec l’indicateur --stages défini sur le nom de votre fichier JSON et les valeurs de votre choix pour les indicateurs --upgrade-type et --node-image-selection. La commande suivante crée une exécution de mises à jour qui met à niveau la version Kubernetes pour le plan de contrôle et les pools de nœuds et utilise l’image de nœud la plus récente disponible pour chaque cluster dans sa région.

   L’indicateur --upgrade-type prend en charge les valeurs suivantes :

   • Full met à niveau la version de Kubernetes pour les pools de nœuds et de plan de contrôle, ainsi que les images de nœud.
   • ControlPlaneOnly met uniquement à niveau la version Kubernetes pour le plan de contrôle du cluster.
   • NodeImageOnly met uniquement à niveau les images de nœud.

   L’indicateur --node-image-selection prend en charge les valeurs suivantes :

   • Latest : met à jour chaque cluster AKS dans l’exécution de mises à jour avec la dernière image disponible pour chaque cluster dans sa région.
   • Consistent : car il est possible pour une exécution de mises à jour d’avoir des clusters AKS dans plusieurs régions où les dernières images de nœud disponibles peuvent être différentes (consultez le suivi des publications pour plus d’informations). L’exécution de la mise à jour sélectionne l’image courante la plus récente dans toutes ces régions pour obtenir une cohérence.

   az fleet updaterun create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1 \
    --upgrade-type Full \
    --kubernetes-version 1.26.0 \
    --node-image-selection Latest \
    --stages example-stages.json
   

3. Démarrez l’exécution de mises à jour à l’aide de la commande az fleet updaterun start.

   az fleet updaterun start \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name run-1
   

Créer une exécution de mise à jour à l’aide de stratégies de mise à jour

La création d’une exécution de mises à jour vous oblige à spécifier les phases, les groupes et l’ordre à chaque fois. Les stratégies de mise à jour simplifient ce processus en vous permettant de stocker des modèles pour les exécutions de mises à jour.

Remarque

Il est possible de créer plusieurs exécutions de mises à jour avec des noms uniques de la même stratégie de mise à jour.

Vous pouvez créer une stratégie de mise à jour à l’aide de l’une des méthodes suivantes :

• Créer une stratégie de mise à jour, puis la référencer lors de la création d’une exécution de mises à jour.
• Enregistrer une stratégie de mise à jour lors de la création d’une exécution de mises à jour en utilisant le portail Azure.

Enregistrer une stratégie de mise à jour lors de la création d’une exécution de mises à jour

• Enregistrez une stratégie de mise à jour lors de la création d’une exécution de mises à jour dans le portail Azure :

  

Gérer une exécution de mises à jour

Les sections suivantes expliquent comment gérer une exécution de mises à jour à l’aide du portail Azure et d’Azure CLI.

Azure portal

• Dans la page Mise à jour multi-cluster de la ressource de flotte, vous pouvez Démarrer une exécution de mises à jour dont l’état est Non démarré ou Échec :

  

• Dans la page Mise à jour multi-cluster de la ressource de flotte, vous pouvez Arrêter une exécution de mises à jour En cours :

  

• Dans n’importe quelle exécution de mises à jour dont l’état est Non démarré, Échec ou En cours, vous pouvez sélectionner n’importe quelle phase et ignorer la mise à niveau :

  

  Vous pouvez également ignorer la mise à niveau au niveau du groupe de mise à jour ou du cluster membre.

Azure CLI

• Vous pouvez Démarrer une exécution de mises à jour dont l’état est Non démarré ou Échec à l’aide de la commande az fleet updaterun start :

  az fleet updaterun start \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name>
  

• Vous pouvez Arrêter une exécution de mises à jour En cours à l’aide de la commande az fleet updaterun stop :

  az fleet updaterun stop \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name>
  

• Vous pouvez ignorer les phases ou groupes de mises à jour en les spécifiant dans l’indicateur --targets à l’aide de la commande az fleet updaterun skip :

  az fleet updaterun skip \
   --resource-group $GROUP \
   --fleet-name $FLEET \
   --name <run-name> \
   --targets Group:my-group-name Stage:my-stage-name
  

  Pour plus d’informations sur les exécutions, les phases et les groupes, consultez Vue d’ensemble conceptuelle des états d’exécution des mises à jour et ignorer le comportement.

Automatiser les exécutions de mises à jour à l’aide de profils de mise à niveau automatique

Les profils de mise à niveau automatique sont utilisés pour exécuter automatiquement des exécutions de mises à jour sur des clusters membres lorsque de nouvelles versions d’image de nœud ou de Kubernetes sont mises à disposition.

Pour plus d’informations sur la configuration des profils de mise à niveau automatique, consultez Automatiser les mises à niveau des images de nœud et de Kubernetes à l’aide d’Azure Kubernetes Fleet Manager.

Pour plus d’informations sur les exécutions, les phases et les groupes, consultez Vue d’ensemble conceptuelle des états d’exécution de mises à jour et du comportement pour les ignorer.

Étapes suivantes

• Procédure : mettre à niveau automatiquement plusieurs clusters en utilisant Azure Kubernetes Fleet Manager.