Créer des pools de nœuds pour un cluster dans Azure Kubernetes Service (AKS)

Cet article vous montre comment créer un ou plusieurs pools de nœuds dans un cluster AKS.

Remarque

Cette fonctionnalité donne plus de contrôle sur la création et la gestion de plusieurs pools de nœuds, et nécessite des commandes distinctes pour les opérations de création/mise à jour/suppression (CRUD). Auparavant, les opérations de cluster effectuées via az aks create ou az aks update utilisaient l’API managedCluster. Il s’agissait des seules options possibles pour modifier le plan de contrôle et un pool de nœuds unique. Cette fonctionnalité expose une opération distincte définie pour les pools d’agents via l’API agentPool. Elle requiert l’utilisation du jeu de commandes az aks nodepool pour exécuter des opérations sur un pool de nœuds individuel.

Important

À compter de November 30, 2025, Azure Kubernetes Service (AKS) ne prend plus en charge ni ne fournit plus de mises à jour de sécurité pour Azure Linux 2.0. L’image de nœud Azure Linux 2.0 est verrouillée sur la version 202512.06.0. À compter du 31 mars 2026, les images de nœud seront supprimées et vous ne pourrez pas mettre à l’échelle vos pools de nœuds. Migrez vers une version Azure Linux prise en charge en mettant à niveau vos pools de nœuds vers une version de Kubernetes prise en charge ou en migrant vers osSku AzureLinux3. Pour plus d'informations, consultez le problème de retrait sur GitHub et l'annonce de la mise hors service des mises à jour Azure. Pour rester informé des annonces et des mises à jour, suivez les notes de publication AKS.

Prerequisites

  • Vous devez Azure CLI version 2.87.0 ou ultérieure installée et configurée. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, consultez Installer Azure CLI.
  • Pour déployer un modèle ARM, vous avez besoin d'avoir un accès en écriture sur les ressources que vous déployez et d'avoir accès à toutes les opérations sur le type de ressource Microsoft.Resources/deployments. Par exemple, pour déployer une machine virtuelle, vous avez besoin d’autorisations Microsoft.Compute/virtualMachines/write et Microsoft.Resources/deployments/*. Pour obtenir la liste des rôles et des autorisations, consultez Azure rôles intégrés.
  • Passez en revue les exigences suivantes pour chaque paramètre :
    • osType: type de système d’exploitation. La valeur par défaut est Linux.
    • osSKU: spécifie la référence SKU du système d’exploitation utilisée par le pool d’agents.
    • count: nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 1 000 (inclus) pour les pools d’utilisateurs et dans la plage figurant entre 1 et 1 000 (inclus) pour les pools système. La valeur par défaut est 1.
  • Après avoir déployé le cluster à l’aide d’un modèle ARM, vous pouvez utiliser Azure CLI ou Azure PowerShell pour vous connecter au cluster et déployer l’exemple d’application.

Limites

Les limitations suivantes s’appliquent lorsque vous créez des clusters AKS prenant en charge plusieurs pools de nœuds :

  • Vous pouvez supprimer le pool de nœuds système si vous disposez d’un autre pool de nœuds système pour le remplacer dans le cluster AKS. Sinon, vous ne pouvez pas supprimer le pool de nœuds système.

  • Les pools de nœuds système doivent contenir au moins deux nœuds, et les pools de nœuds utilisateur peuvent contenir zéro, un ou plusieurs nœuds.

  • Si vous créez un cluster avec un pool de nœuds unique, le type de système d’exploitation doit être Linux. La référence SKU du système d’exploitation peut être n’importe quelle variante Linux telle que Ubuntu, AzureContainerLinuxou AzureLinux. Vous ne pouvez pas créer de cluster avec un seul pool de nœuds Windows. Si vous souhaitez exécuter Windows conteneurs, vous devez ajouter un pool de nœuds Windows au cluster après l’avoir créé avec un pool de nœuds système Linux.

  • Vous ne pouvez pas activer la prise en charge de Windows sur un cluster qui a été créé sans cette option. L’ajout d’un pool de nœuds Windows à un cluster nécessite la windowsProfile configuration pendant la création initiale du cluster (par exemple, en spécifiant --windows-admin-username et --windows-admin-password avec le Azure CLI). Si un cluster a été créé sans ces paramètres, les tentatives d'ajout d'un pool de nœuds Windows échouent, car le cluster n'a pas de définition de profil Windows. Pour exécuter des conteneurs Windows sur un cluster existant uniquement Linux, vous devez recréer le cluster avec la prise en charge de Windows activée. Pour plus d’informations, consultez la demande de fonctionnalité associée sur GitHub.

  • Le cluster AKS doit utiliser l’équilibreur de charge de référence SKU Standard pour utiliser plusieurs pools de nœuds. La fonctionnalité n’est pas prise en charge pour les équilibreurs de charge de référence SKU De base.

  • Le cluster AKS doit utiliser Virtual Machine Scale Sets pour les nœuds.

  • Le nom d’un pool de nœuds ne peut contenir que des caractères alphanumériques minuscules et doit commencer par une lettre minuscule.

    • Pour les pools de nœuds Linux, la longueur doit être comprise entre 1 et 12 caractères.
    • Pour les pools de nœuds Windows, la longueur doit être comprise entre 1 et 6 caractères.

  • Tous les pools de nœuds doivent résider dans le même réseau virtuel.

  • Vous ne pouvez pas modifier la taille de la machine virtuelle d’un pool de nœuds après sa création.

  • Vous ne pouvez pas modifier le paramètre max pods d’un pool de nœuds après sa création. Pour utiliser une valeur de pods maximale différente, créez un pool de nœuds avec le paramètre max pods souhaité, migrez les charges de travail, puis supprimez l’ancien pool de nœuds.

  • Quand vous créez plusieurs pools de nœuds au moment de la création du cluster, les versions de Kubernetes des pools de nœuds doivent correspondre à la version définie pour le plan de contrôle. Vous pouvez effectuer des mises à jour après le provisionnement du cluster en utilisant des opérations par pool de nœuds.

Important

Si vous utilisez Azure Container Linux (ACL) sur AKS, vérifiez les considérations et limitations suivantes :

Créer des pools de nœuds spécialisés

Pour savoir comment créer des pools de nœuds spécialisés, consultez les articles suivants :

Définir des variables d’environnement

Définissez les variables d’environnement suivantes dans votre interpréteur de commandes pour simplifier les commandes de cet article. Vous pouvez modifier les valeurs selon vos préférences.

export RESOURCE_GROUP_NAME="my-aks-rg"
export LOCATION="eastus"
export CLUSTER_NAME="my-aks-cluster"
export NODE_POOL_NAME="mynodepool"

Créer un groupe de ressources

Créez un groupe de ressources Azure à l’aide de la commande az group create.

az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

Créer un cluster AKS avec un pool de nœuds unique à l’aide de la Azure CLI

Si vous ne souhaitez qu’un seul pool de nœuds dans votre cluster AKS, vous pouvez planifier des pods d’application sur des pools de nœuds système. Si vous exécutez un pool de nœuds système unique pour votre cluster AKS dans un environnement de production, nous vous recommandons d’utiliser au moins trois nœuds pour le pool de nœuds. Si un nœud tombe en panne, la redondance est compromise. Vous pouvez atténuer ce risque en ayant un plus grand nombre de nœuds de pools de nœuds système.

  1. Créez un cluster avec un seul pool de nœuds Ubuntu à l’aide de la az aks create commande. Cette étape spécifie deux nœuds dans le pool de nœuds unique.

    az aks create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $CLUSTER_NAME \
    --vm-set-type VirtualMachineScaleSets \
    --node-count 2 \
    --os-sku Ubuntu \
    --location $LOCATION \
    --load-balancer-sku standard \
    --generate-ssh-keys

    La création du cluster ne prend que quelques minutes.

  2. Lorsque le cluster est prêt, obtenez les informations d’identification du cluster à l’aide de la commande az aks get-credentials.

    az aks get-credentials --resource-group $RESOURCE_GROUP_NAME --name $CLUSTER_NAME

Ajouter un deuxième pool de nœuds à l’aide du Azure CLI

Le cluster créé dans la section précédente a un pool de nœuds unique. Dans cette section, nous ajoutons un deuxième pool de nœuds au cluster. Ce deuxième pool de nœuds peut avoir un type de système d’exploitation Linux avec une référence SKU de système d’exploitation de Ubuntu ou AzureLinux, ou un type de système d’exploitation de Windows.

Remarque

Si vous souhaitez ajouter un pool de nœuds qui utilise des disques de système d’exploitation éphémères à votre cluster AKS, vous pouvez définir l’indicateur --node-osdisk-typeEphemeral lors de l’exécution de la commande az aks nodepool add.

Grâce au système d’exploitation éphémère, vous pouvez déployer des machine virtuelle et des images d’instance jusqu’au maximum de la capacité du cache de la machine virtuelle. La configuration de disque de système d’exploitation du nœud par défaut dans AKS utilise 128 Go, ce qui signifie que vous avez besoin d’une taille de machine virtuelle dont le cache est supérieur à 128 Go. La taille par défaut Standard_DS2_v2 du cache est de 86 Go, ce qui n’est pas suffisant. La Standard_DS3_v2 référence SKU de machine virtuelle a une taille de cache de 172 Go, qui est suffisamment grande. Vous pouvez également réduire la taille par défaut du disque du système d’exploitation à l’aide --node-osdisk-size, mais gardez à l’esprit que la taille minimale des images AKS est de 30 Go.

Si vous souhaitez créer des pools de nœuds avec des disques de système d’exploitation attachés au réseau, vous pouvez définir l’indicateur --node-osdisk-type sur Managed lors de l’exécution de la commande az aks nodepool add.

Ajouter un pool de nœuds Linux

Créez un nouveau pool de nœuds à l’aide de la commande az aks nodepool add. L’exemple suivant crée un Linux pool de nœuds avec le SKU du Ubuntu système d’exploitation, qui exécute trois nœuds. Si vous ne spécifiez pas de SKU du système d'exploitation, AKS utilise Ubuntu par défaut.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Linux \
    --os-sku Ubuntu \
    --node-count 3

La création du pool de nœuds prend quelques minutes.

Ajouter un pool de nœuds Windows Server

Créer le pool de nœuds Windows Server 2025

Créez un nouveau pool de nœuds à l’aide de la commande az aks nodepool add. L’exemple suivant crée un Windows pool de nœuds avec le SKU du Windows2025 système d’exploitation, qui exécute trois nœuds. Les pools de nœuds Windows Server 2025 nécessitent une image prenant en charge FIPS ; la commande inclut donc --enable-fips-image.

Pour plus d’informations sur Windows système d’exploitation, consultez Windows meilleures pratiques.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Windows \
    --os-sku Windows2025 \
    --enable-fips-image \
    --node-count 3

Vérifier l’état de vos pools de nœuds

Vérifiez l’état de vos pools de nœuds avec la commande az aks nodepool list, puis spécifiez votre groupe de ressources et le nom du cluster.

az aks nodepool list --resource-group $RESOURCE_GROUP_NAME --cluster-name $CLUSTER_NAME

Créer un cluster AKS avec un pool de nœuds unique à l’aide d’un modèle ARM

Si vous ne souhaitez qu’un seul pool de nœuds dans votre cluster AKS, vous pouvez planifier des pods d’application sur des pools de nœuds système. Si vous exécutez un pool de nœuds système unique pour votre cluster AKS dans un environnement de production, nous vous recommandons d’utiliser au moins trois nœuds pour le pool de nœuds. Si un nœud tombe en panne, la redondance est compromise. Vous pouvez atténuer ce risque en ayant un plus grand nombre de nœuds de pools de nœuds système.

Créer une ressource Microsoft.ContainerService/managedClusters

Créez une ressource Microsoft.ContainerService/managedClusters en ajoutant this JSON à votre modèle.

  • Créez un pool de nœuds Ubuntu unique dans votre cluster AKS en apportant les modifications suivantes à votre modèle ARM :

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "1",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Ajouter un deuxième pool de nœuds à l’aide d’un modèle ARM

Le cluster créé dans la section précédente a un pool de nœuds unique. Dans cette section, nous ajoutons un deuxième pool de nœuds au cluster. Ce deuxième pool de nœuds peut avoir un type de système d’exploitation Linux avec une référence SKU de système d’exploitation de Ubuntu ou AzureLinux, ou un type de système d’exploitation de Windows.

Ajouter des pools de nœuds Linux

  • Créez plusieurs pools de nœuds Ubuntu dans votre cluster AKS en apportant les modifications suivantes à votre modèle ARM :

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Ajouter des pools de nœuds Windows Server

Créer les pools de nœuds Windows Server 2025

  • Créez plusieurs pools de nœuds Windows dans votre cluster AKS en apportant les modifications suivantes à votre modèle ARM :

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "windows2025",
        "osType": "windows"
     } 
     ],
}

Déployer votre modèle ARM

Définir des taints, des étiquettes ou des balises pour un pool de nœuds

Lors de la création d’un pool de nœuds, vous pouvez lui ajouter des taints, des labels ou des tags. Lorsque vous ajoutez une teinte, un intitulé ou une étiquette, tous les nœuds du pool reçoivent cette teinte, cet intitulé ou cette étiquette. Nous vous recommandons d’appliquer ces propriétés à un pool de nœuds entier au lieu de nœuds individuels. De cette façon, vous pouvez facilement gérer les propriétés de tous les nœuds du pool de nœuds en mettant à jour les propriétés du pool de nœuds au lieu de mettre à jour chaque nœud individuellement.

Pour obtenir des instructions spécifiques sur la façon de définir des taints, des étiquettes ou des tags pour un pool de nœuds, utilisez les ressources suivantes :

Étapes suivantes

Dans cet article, vous avez appris à créer un cluster AKS avec un pool de nœuds unique et à ajouter des pools de nœuds supplémentaires à votre cluster. Pour en savoir plus sur la gestion de vos pools de nœuds, consultez les articles suivants :

  • Last updated on