Mettre à l’échelle manuellement le nombre de nœuds dans un cluster Azure Kubernetes Service (AKS)

Si les besoins en ressources de vos applications changent, les performances de votre cluster peuvent être affectées en raison d’une faible capacité sur le processeur, la mémoire, l’espace PID ou les tailles de disque. Pour résoudre ces modifications, vous pouvez mettre à l’échelle manuellement votre cluster AKS pour exécuter un nombre différent de nœuds. Si vous réduisez l’échelle, les nœuds sont soigneusement coordonnés et purgés afin de limiter les perturbations pour les applications en cours d’exécution. Si vous effectuez une montée en puissance, AKS attend que les nœuds soient marqués Prêt par le cluster Kubernetes avant que des pods soient planifiés dans ces nœuds.

Cet article décrit comment augmenter ou baisser manuellement le nombre de nœuds dans un cluster AKS.

Note

Cet article s’applique aux clusters AKS Standard. Les clusters automatiques AKS utilisent le provisionnement automatique des nœuds pour gérer la mise à l’échelle des nœuds.

Avant de commencer

  • Passez en revue les quotas et limites du service AKS pour vérifier que votre cluster peut être mis à l’échelle avec le nombre souhaité de nœuds.

  • Si l’autoscaler de cluster est activé sur le pool de nœuds, vous ne pouvez pas modifier manuellement le nombre de nœuds. Vous pouvez soit mettre à jour les valeurs minimale et maximale de l’autoscaler de cluster, soit désactiver l’autoscaler de cluster pour le pool de nœuds avant d’effectuer une mise à l’échelle manuelle.

  • La prise en charge d’Azure Linux 2.0 a pris fin le 30 novembre 2025. À compter du 31 mars 2026, les images de nœud Azure Linux 2.0 ont été retirées, et les pools de nœuds concernés ne peuvent plus être mis à l’échelle. Migrez vers Azure Linux 3 avant de mettre à l’échelle un pool de nœuds Azure Linux 2.0.

  • Les noms de pool de nœuds doivent répondre aux exigences suivantes :

    Type de pool de nœuds Exigences relatives au nom
    Linux Entre 1 et 12 caractères alphanumériques minuscules. Doit commencer par une lettre minuscule.
    Windows Entre 1 et 6 caractères alphanumériques minuscules. Doit commencer par une lettre minuscule.

Mettre à l’échelle les nœuds d’un cluster dans AKS

Important

La suppression de nœuds d’un pool de nœuds à l’aide de la kubectl commande n’est pas prise en charge. Cette action peut créer des problèmes de mise à l’échelle avec votre cluster AKS.

  1. Obtenez le nom, le mode et le nombre de nœuds de vos pools de nœuds à l’aide de la az aks show commande. L’exemple suivant obtient les détails du pool de nœuds pour le cluster nommé myAKSCluster dans le groupe de ressources myResourceGroup :

    az aks show --resource-group myResourceGroup --name myAKSCluster --query "agentPoolProfiles[].{Name:name,Mode:mode,Count:count}" --output table

    L’exemple de sortie suivant montre que nodepool1 est un pool de nœuds système avec trois nœuds :

    Name       Mode    Count
---------  ------  -------
nodepool1  System  3

  2. Redimensionnez les nœuds du cluster à l’aide de la commande az aks scale. L’exemple suivant met à l’échelle le pool de nœuds nodepool1 dans le cluster nommé myAKSCluster à deux nœuds :

    az aks scale --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-name nodepool1 --query "agentPoolProfiles[?name=='nodepool1'].{Name:name,Mode:mode,Count:count}" --output table

    L’exemple de sortie suivant montre que le pool de nœuds système a été redimensionné avec succès à deux nœuds :

    Name       Mode    Count
---------  ------  -------
nodepool1  System  2

    Les pools de nœuds système doivent avoir au moins deux nœuds. Pour les clusters de production, utilisez au moins trois nœuds dans un pool de nœuds système. Pour plus d'informations, voir Pools de nœuds système et utilisateur.

Ramener les groupes de nœuds utilisateur à 0

Contrairement aux pools de nœuds système qui nécessitent toujours des nœuds en cours d’exécution, les pools de nœuds utilisateur peuvent être mis à l’échelle à 0. Pour en savoir plus sur les différences entre les pools de nœuds système et utilisateur, consultez Pools de nœuds système et utilisateur.

Important

Pour ramener un pool de nœuds utilisateur à 0 nœud, désactivez l’outil de mise à l’échelle automatique du cluster. Pour plus d’informations, consultez Désactiver l’autoscaler de cluster sur un pool de nœuds.

Pour mettre à l’échelle un pool de nœuds utilisateur sur 0, utilisez az aks nodepool scale au lieu de la commande utilisée pour la mise à l’échelle az aks scale générale des nœuds et définissez --node-count sur 0.

az aks nodepool scale --name <your node pool name> --cluster-name myAKSCluster --resource-group myResourceGroup  --node-count 0

Vous pouvez autoriser, sans toutefois forcer, la mise à l’échelle automatique jusqu’à zéro nœud sur les pools de nœuds utilisateur avec mise à l’échelle automatique en définissant le paramètre --min-count du Cluster Autoscaler sur 0.

Étapes suivantes

Dans cet article, vous avez mis à l’échelle un cluster AKS manuellement pour augmenter ou réduire le nombre de nœuds. Vous pouvez également utiliser l’autoscaler de cluster pour mettre à l’échelle votre cluster automatiquement.

  • Dernière mise à jour :