Tutoriel : mettre à niveau un cluster Azure Kubernetes Service (AKS)

Au cours du cycle de vie des applications et des clusters, vous pouvez vouloir effectuer une mise à niveau vers la dernière version disponible de Kubernetes. Vous pouvez mettre à niveau votre cluster Azure Kubernetes Service (AKS) à l'aide de l’interface de ligne de commande Azure (Azure CLI), d'Azure PowerShell ou du portail Azure.

Dans ce tutoriel, la partie sept sur sept, vous mettez à niveau un cluster AKS. Vous allez apprendre à effectuer les actions suivantes :

• Identifier les versions Kubernetes actuelles et disponibles.
• Mettre à niveau vos nœuds Kubernetes.
• Valider une mise à niveau réussie.

Avant de commencer

Dans les didacticiels précédents, vous avez empaqueté une application dans une image conteneur, puis chargé l’image conteneur dans Azure Container Registry (ACR). Vous avez également créé un cluster AKS et déployé une application dans celui-ci. Si vous n’avez pas effectué ces étapes et voulez suivre cette procédure, commencez par Tutoriel 1 : préparer une application pour AKS.

Si vous utilisez Azure CLI, ce tutoriel nécessite Azure CLI version 2.34.1 ou ultérieure. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

Si vous utilisez Azure PowerShell, ce tutoriel nécessite Azure PowerShell version 5.9.0 ou ultérieure. Exécutez Get-InstalledModule -Name Az pour trouver la version. Si vous avez besoin de procéder à une installation ou à une mise à niveau, consultez Installer Azure PowerShell.

Obtenir les versions de cluster disponibles

Azure CLI

• Avant d’effectuer la mise à niveau, recherchez les publications de Kubernetes disponibles pour votre cluster au moyen de la commande az aks get-upgrades.

  az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster
  

  L’exemple de sortie suivant montre que la version actuelle est 1.26.6 et répertorie les versions disponibles sous upgrades :

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.26.6",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.27.1"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.27.3"
        }
      ]
    },
    ...
  }
  

Azure PowerShell

1. Avant d’effectuer la mise à niveau, recherchez les publications de Kubernetes disponibles pour votre cluster et la région où réside votre cluster à l’aide de l’applet du cmdlet Get-AzAksCluster.

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -Property Name, KubernetesVersion, Location
   

   L’exemple de sortie suivant montre la version actuelle comme 1.26.6 et l’emplacement comme eastus :

   Name            KubernetesVersion       Location
   ----            -----------------       --------
   myAKSCluster    1.26.6                  eastus
   

2. Vérifiez quelles mises à niveau Kubernetes sont disponibles dans la région où réside votre cluster à l’aide de l’applet du cmdlet Get-AzAksVersion.

   Get-AzAksVersion -Location eastus | Where-Object OrchestratorVersion
   

   L’exemple de sortie suivant montre les versions disponibles sous OrchestratorVersion :

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes           1.27.1
                             Kubernetes           1.27.3
   

Azure portal

1. Connectez-vous au portail Azure.

2. Accédez à votre cluster AKS.

3. Sous Paramètres, sélectionnez Configuration de cluster.

4. Dans Version de Kubernetes, sélectionnez Mettre à niveau la version. Vous êtes alors redirigé vers une nouvelle page.

5. Dans Version de Kubernetes, sélectionnez la version pour vérifier les mises à niveau disponibles.

   

Si aucune mise à niveau n’est disponible, créez un cluster avec une version prise en charge de Kubernetes et migrez vos charges de travail du cluster existant vers le nouveau cluster. La mise à niveau d’un cluster vers une version plus récente de Kubernetes quand aucune mise à niveau disponible n’est pas prise en charge.

Mettre à niveau un cluster AKS

Les nœuds AKS sont soigneusement coordonnés et purgés afin de limiter les perturbations potentielles pour les applications en cours d’exécution. Au cours de ce processus, AKS effectue les étapes suivantes :

• Il ajoute un nouveau nœud de tampon (ou autant de nœuds que ceux configurés dans max-surge) au cluster qui exécute la version de Kubernetes spécifiée.
• Il effectue l’isolation et le drainage de l’un des anciens nœuds afin de limiter la perturbation des applications en cours d’exécution. Si vous utilisez max surge, il isole et draine autant de nœuds que le nombre de nœuds de tampon spécifiés.
• Lorsque l’ancien nœud est entièrement drainé, il est réinitialisé pour recevoir la nouvelle version et devient le nœud de mémoire tampon pour le nœud suivant à mettre à niveau.
• Ce processus se répète jusqu’à ce que tous les nœuds du cluster soient mis à niveau.
• À la fin du processus, le dernier nœud tampon est supprimé, ce qui a pour effet de maintenir le nombre de nœuds d’agent existants et l’équilibre de la zone.

Remarque

Si aucun patch n’est spécifié, le cluster est automatiquement mis à niveau vers le dernier patch GA de la version mineure spécifiée. Par exemple, la définition de --kubernetes-version sur 1.21 entraîne la mise à niveau du cluster vers 1.21.9.

Pour plus d’informations, consultez Mises à niveau des versions mineures de Kubernetes prises en charge dans AKS.

Vous pouvez mettre à niveau manuellement votre cluster ou configurer des mises à niveau automatiques de cluster. Nous vous recommandons de configurer des mises à niveau automatiques de cluster pour vous assurer que votre cluster exécute toujours la dernière version de Kubernetes.

Mettre à niveau manuellement le cluster

Azure CLI

• Mettez à niveau votre cluster à l’aide de la commande az aks upgrade.

  az aks upgrade \
      --resource-group myResourceGroup \
      --name myAKSCluster \
      --kubernetes-version KUBERNETES_VERSION
  

  Notes

  Vous ne pouvez mettre à niveau qu’une version mineure à la fois. Par exemple, vous pouvez effectuer une mise à niveau de la version 1.14.x vers la version 1.15.x, mais pas de la version 1.14.x directement vers la version 1.16.x. Pour effectuer une mise à niveau de 1.14.x vers 1.16.x, vous devez commencer par mettre à niveau la version 1.14.x vers la version 1.15.x, puis mettez à niveau la version 1.15.x vers la version 1.16.x.

  L’exemple de sortie suivant montre le résultat de la mise à niveau vers la version 1.27.3. Notez que le kubernetesVersion affiche à présent 1.27.3 :

  {
    "agentPoolProfiles": [
      {
        "count": 3,
        "maxPods": 110,
        "name": "nodepool1",
        "osType": "Linux",
        "vmSize": "Standard_DS1_v2",
      }
    ],
    "dnsPrefix": "myAKSClust-myResourceGroup-19da35",
    "enableRbac": false,
    "fqdn": "myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io",
    "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
    "kubernetesVersion": "1.27.3",
    "location": "eastus",
    "name": "myAKSCluster",
    "type": "Microsoft.ContainerService/ManagedClusters"
  }
  

Azure PowerShell

• Mettez à niveau votre cluster à l’aide du cmdlet Set-AzAksCluster.

  Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion <KUBERNETES_VERSION>
  

  Notes

  Vous ne pouvez mettre à niveau qu’une version mineure à la fois. Par exemple, vous pouvez effectuer une mise à niveau de la version 1.14.x vers la version 1.15.x, mais pas de la version 1.14.x directement vers la version 1.16.x. Pour effectuer une mise à niveau de 1.14.x vers 1.16.x, commencez par mettre à niveau la version 1.14.x vers la version 1.15.x, puis mettez à niveau la version 1.15.x vers la version 1.16.x.

  L’exemple de sortie suivant montre le résultat de la mise à niveau vers la version 1.27.3. Notez que le KubernetesVersion affiche à présent 1.27.3 :

  ProvisioningState       : Succeeded
  MaxAgentPools           : 100
  KubernetesVersion       : 1.27.3
  PrivateFQDN             :
  AgentPoolProfiles       : {default}
  Name                    : myAKSCluster
  Type                    : Microsoft.ContainerService/ManagedClusters
  Location                : eastus
  Tags                    : {}
  

Azure portal

1. Dans le portail Azure, accédez à votre cluster AKS.

2. Sous Paramètres, sélectionnez Configuration de cluster.

3. Dans Version de Kubernetes, sélectionnez Mettre à niveau la version. Vous êtes alors redirigé vers une nouvelle page.

4. Dans la version de Kubernetes, sélectionnez la version souhaitée, puis sélectionnez Enregistrer.

   

Quelques minutes suffisent pour mettre à niveau le cluster. Le temps nécessaire varie en fonction du nombre de nœuds.

Configurer des mises à niveau automatiques de cluster

Azure CLI

• Définissez un canal de mise à niveau automatique sur votre cluster en utilisant la commande az aks update avec le paramètre --auto-upgrade-channel défini sur patch.

  az aks update --resource-group myResourceGroup --name myAKSCluster --auto-upgrade-channel patch
  

Azure PowerShell

• Définissez un canal de mise à niveau automatique sur votre cluster à l’aide du cmdlet Set-AzAksCluster avec le paramètre -AutoUpgradeChannel défini sur Patch.

  Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AutoUpgradeChannel Patch
  

Azure portal

1. Dans le portail Azure, accédez à votre cluster AKS.

2. Sous Paramètres, sélectionnez Configuration de cluster.

3. Dans Version de Kubernetes, sélectionnez Mettre à niveau la version.

4. Pour Mise à niveau automatique, sélectionnez Activé avec le correctif (recommandé)>Enregistrer.

   

Pour plus d’informations, consultez Mettre à niveau automatiquement un cluster Azure Kubernetes Service (AKS).

Mettre à niveau des images de nœud AKS

AKS fournit régulièrement de nouvelles images de nœud. Les images de nœud Linux sont mises à jour chaque semaine et les images de nœud Windows le sont chaque mois. Nous vous recommandons de mettre à niveau fréquemment vos images de nœud pour utiliser les dernières fonctionnalités et mises à jour de sécurité AKS. Pour plus d’informations, consultez Mettre à niveau des images de nœud Azure Kubernetes Service (AKS). Pour configurer les mises à niveau automatiques d’images de nœud, consultez Mettre à niveau automatiquement les images de système d’exploitation de nœud de cluster Azure Kubernetes Service (AKS).

Afficher les événements de mise à niveau

Remarque

Lorsque vous mettez votre cluster à niveau, les événements Kubernetes suivants peuvent se produire sur les nœuds :

• Surge (Surtension) : création d’un nœud de surtension.
• Drain(Vidage) : supprime les pods du nœud. Chaque pod dispose d’un délai de cinq minutes pour terminer l’expulsion.
• Update (Mise à jour) : Réussite ou échec de la mise à jour d’un nœud.
• Delete (Suppression) : supprimer un nœud de surtension.

• Affichez les événements de mise à niveau dans les espaces de noms par défaut à l’aide de la commande kubectl get events

  kubectl get events --field-selector source=upgrader
  

  L’exemple de sortie suivant montre certains des événements ci-dessus listés pendant une mise à niveau :

  ...
  default 2m1s Normal Drain node/aks-nodepool1-96663640-vmss000001 Draining node: [aks-nodepool1-96663640-vmss000001]
  ...
  default 9m22s Normal Surge node/aks-nodepool1-96663640-vmss000002 Created a surge node [aks-nodepool1-96663640-vmss000002 nodepool1] for agentpool %!s(MISSING)
  ...
  

Valider une mise à niveau

Azure CLI

• Vérifiez si la mise à niveau a réussi avec la commande az aks show.

  az aks show --resource-group myResourceGroup --name myAKSCluster --output table
  

  L’exemple de sortie suivant indique que le cluster AKS exécute KubernetesVersion 1.27.3 :

  Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
  ------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
  myAKSCluster  eastus      myResourceGroup  1.27.3               1.27.3                    Succeeded            myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io
  

Azure PowerShell

• Vérifiez si la mise à niveau a réussi avec le cmdlet Get-AzAksCluster.

  Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
    Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState
  

  L’exemple de sortie suivant indique que le cluster AKS exécute KubernetesVersion 1.27.3 :

  Name         Location   KubernetesVersion   ProvisioningState
  ----         --------   -----------------   -----------------
  myAKSCluster eastus     1.27.3              Succeeded
  

Azure portal

1. Dans le portail Azure, accédez à votre cluster AKS.

2. Sur la page Vue d'ensemble, sélectionnez la version de Kubernetes et assurez-vous qu'il s'agit de la dernière version installée à l'étape précédente.

   

Supprimer le cluster

Comme ce tutoriel est la dernière partie de la série, vous pouvez supprimer votre cluster AKS pour éviter les frais Azure.

Azure CLI

• Supprimez le groupe de ressources, le service conteneur et toutes les ressources associées à l’aide de la commande az group delete.

  az group delete --name myResourceGroup --yes --no-wait
  

Azure PowerShell

• Supprimez le groupe de ressources, le service de conteneur et toutes les ressources associées à l’aide du cmdlet Remove-AzResourceGroup.

  Remove-AzResourceGroup -Name myResourceGroup
  

Azure portal

1. Dans le portail Azure, accédez à votre cluster AKS.

2. Dans la page Vue d’ensemble, sélectionnez Supprimer.

3. Dans la page de confirmation supprimer le cluster, sélectionnez Supprimer.

   

Remarque

Lorsque vous supprimez le cluster, le principal de service Microsoft Entra utilisé par le cluster AKS n’est pas supprimé. Pour obtenir des instructions sur la façon de supprimer le principal de service, consultez Considérations et suppression du principal de service AKS. Si vous avez utilisé une identité managée, l’identité est managée par la plateforme et ne vous demande pas de provisionner ou de permuter des secrets.

Étapes suivantes

Dans ce tutoriel, vous avez mis à niveau Kubernetes dans un cluster AKS. Vous avez appris à :

• Identifier les versions Kubernetes actuelles et disponibles.
• Mettre à niveau vos nœuds Kubernetes.
• Valider une mise à niveau réussie.

Pour plus d’informations sur AKS, consultez la section Vue d’ensemble d’AKS. Pour obtenir des conseils sur la création de solutions complètes avec AKS, consultez l’article Conseils pour les solutions AKS.