Tutoriel : mettre à niveau un cluster Azure Kubernetes Service (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 à l’aide de la Azure CLI

Avant de procéder à la mise à niveau, vérifiez quelles versions Kubernetes sont disponibles pour votre cluster à l’aide de la az aks get-upgrades commande.

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

L’exemple de sortie suivant montre la version actuelle d’un cluster et répertorie les versions plus récentes sous upgrades:

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.33.7",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.10"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.9"
        }
      ]
    },
    ...
  }

Obtenir les versions de cluster disponibles à l’aide de Azure PowerShell

1. Avant de procéder à la mise à niveau, vérifiez la version et la région actuelles de Kubernetes de votre cluster à l’aide de l’applet de Get-AzAksCluster commande.

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

   L’exemple de sortie suivant montre la version et l’emplacement actuels du cluster :

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.33.7                        westus2
   

2. Répertoriez les versions kubernetes disponibles dans la région où réside votre cluster à l’aide de l’applet Get-AzAksVersion de commande.

   Get-AzAksVersion -Location westus2 | Where-Object OrchestratorVersion
   

   L’exemple de sortie suivant montre les versions régionales sous OrchestratorVersion:

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.34.10
                             Kubernetes               1.34.9
   True                      Kubernetes               1.33.7
   ...
   

   Pour identifier les cibles de mise à niveau potentielles, comparez les versions plus récentes que la version actuelle de votre cluster avec les règles de mise à niveau de version Kubernetes. Cette applet de commande répertorie la disponibilité régionale et ne valide pas le chemin de mise à niveau d’un cluster spécifique.

Obtenir les versions de cluster disponibles à l’aide du portail Azure

1. Connectez-vous au portail Azure.

2. Accédez à votre ressource de cluster AKS.

3. Dans le menu du service, sous Paramètres, sélectionnez Mises à niveau.

4. Par version de Kubernetes, sélectionnez Mettre à niveau la version.

   

5. Dans la page Mettre à niveau la version de Kubernetes , sélectionnez la liste déroulante Version de Kubernetes pour afficher les versions de Kubernetes disponibles pour la mise à niveau.

   

Si aucune mise à niveau n’est disponible, votre cluster peut déjà se trouver sur la dernière version disponible ou la version du cluster peut se trouver en dehors de la fenêtre de support. Si la version n’est pas prise en charge et qu’AKS n’offre pas de mise à niveau de récupération, créez un cluster avec une version Kubernetes prise en charge et migrez vos charges de travail. Pour plus d’informations, consultez les stratégies de prise en charge AKS pour les versions de Kubernetes.

Mettre à niveau manuellement le cluster à l’aide du Azure CLI

Mettez à niveau votre cluster à l’aide de la az aks upgrade commande. Cet exemple met à niveau le cluster vers la version 1.34.10 :

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

L’exemple de sortie suivant montre le résultat de la mise à niveau. La kubernetesVersion valeur correspond maintenant à la version spécifiée dans l’exemple de commande :

{
  ...
  "agentPoolProfiles": [
    {
      ...
      "count": 3,
      "currentOrchestratorVersion": "1.34.10",
      "maxPods": 110,
      "name": "nodepool1",
      "nodeImageVersion": "AKSUbuntu-2204gen2containerd-202608.26.0",
      "orchestratorVersion": "1.34.10",
      "osType": "Linux",
      "upgradeSettings": {
        "drainTimeoutInMinutes": null,
        "maxSurge": "10%",
        "nodeSoakDurationInMinutes": null,
        "undrainableNodeBehavior": null
      },
      "vmSize": "Standard_DS2_v2",
      ...
    }
  ],
  ...
  "currentKubernetesVersion": "1.34.10",
  "dnsPrefix": "myAKSClust-myResourceGroup-12ab34",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.34.10",
  "location": "westus2",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
  ...
}

Mettre à niveau manuellement un cluster à l’aide de Azure PowerShell

Mettez à niveau votre cluster à l’aide de l’applet de commande Set-AzAksCluster. Cet exemple met à niveau le cluster vers la version 1.34.10 :

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion 1.34.10

L’exemple de sortie suivant montre le résultat de la mise à niveau. La KubernetesVersion valeur correspond maintenant à la version spécifiée dans l’exemple d’applet de commande :

...
ProvisioningState        : Succeeded
MaxAgentPools            : 100
KubernetesVersion        : 1.34.10
CurrentKubernetesVersion : 1.34.10
...
ResourceGroupName        : myResourceGroup
Name                     : myAKSCluster
Type                     : Microsoft.ContainerService/ManagedClusters
Location                 : westus2
Tags                     :

Mettre à niveau manuellement le cluster à l’aide du portail Azure

1. Dans le portail Azure, naviguez vers la ressource de votre cluster AKS.

2. Dans le menu du service, sous Paramètres, sélectionnez Mises à niveau.

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

   

4. Dans la page Mettre à niveau la version de Kubernetes , sélectionnez la liste déroulante Version de Kubernetes pour afficher les versions de Kubernetes disponibles pour la mise à niveau.

   

5. Sélectionnez la version de Kubernetes vers laquelle vous souhaitez effectuer la mise à niveau, puis sélectionnez Enregistrer.

La durée de la mise à niveau dépend de facteurs tels que le nombre de nœuds, les paramètres de surge, les contraintes de perturbation des charges de travail, le délai d’expiration du drain et la durée de stabilisation des nœuds. Le délai d’expiration du drainage par défaut est de 30 minutes par nœud et peut être configuré de cinq minutes à 24 heures. La durée de trempage du nœud peut ajouter de 0 à 30 minutes par nœud. Pour plus d’informations, consultez Personnaliser l’augmentation du pool de nœuds et les paramètres non disponibles.

Configurer des mises à niveau automatiques de cluster à l’aide de l’Azure CLI

Configurer des mises à niveau automatiques de cluster à l’aide de Azure PowerShell

Configurer des mises à niveau automatiques de cluster à l’aide du portail Azure

Sur un cluster AKS Standard, définissez le canal de mise à niveau automatique à l’aide de la az aks update commande. L’exemple suivant utilise le stable canal :

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

Sur un cluster AKS Standard, définissez le canal de mise à niveau automatique à l’aide du cmdlet Set-AzAksCluster. L’exemple suivant utilise le Stable canal :

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

1. Dans le portail Azure, naviguez vers la ressource de votre cluster AKS.

2. Dans le menu du service, sous Paramètres, sélectionnez Mises à niveau.

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

   

4. Pour un cluster AKS Standard, sur la page Mettre à niveau la version de Kubernetes, sélectionnez la liste déroulante Mise à niveau automatique, sélectionnez Activée avec la version stable, puis sélectionnez Enregistrer.

   

Valider une mise à niveau à l’aide de la Azure CLI

Vérifiez que la mise à niveau a réussi à l’aide de la az aks show commande.

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

L’exemple de sortie suivant montre que le cluster AKS exécute la version de Kubernetes cible :

Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  westus2      myResourceGroup  1.34.10              1.34.10                   Succeeded            myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io

Valider une mise à niveau à l’aide de Azure PowerShell

Vérifiez que la mise à niveau a réussi à l’aide de l’applet de commande Get-AzAksCluster.

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

L’exemple de sortie suivant montre que le cluster AKS exécute la version de Kubernetes cible :

Name             Location     KubernetesVersion     ProvisioningState
----             --------     -----------------     -----------------
myAKSCluster     westus2       1.34.10               Succeeded

Valider une mise à niveau à l’aide du portail Azure

1. Dans le portail Azure, naviguez vers la ressource de votre cluster AKS.
2. Dans la page Vue d’ensemble , sous Essentials, vérifiez la version de Kubernetes pour confirmer que la mise à niveau a réussi.

Supprimer le cluster à l’aide du Azure CLI

Supprimer le cluster à l’aide de Azure PowerShell

Supprimer le cluster à l’aide du portail Azure

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

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

Supprimez le groupe de ressources, le service de conteneur ainsi que toutes les ressources associées à l’aide de l’applet de commande Remove-AzResourceGroup.

Remove-AzResourceGroup -Name myResourceGroup

1. Dans le portail Azure, naviguez vers la ressource de 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.