Partager via

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

Depuis le 30 novembre 2025, Azure Kubernetes Service (AKS) ne prend plus en charge ou fournit des mises à jour de sécurité pour Azure Linux 2.0. L’image de nœud Azure Linux 2.0 est figée à 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 Kubernetes prise en charge ou en migrant vers osSku AzureLinux3. Pour plus d’informations, consultez [Retrait] Pools de nœuds Azure Linux 2.0 sur AKS.

Prerequisites

  • Vous avez besoin d’Azure CLI version 2.2.0 ou ultérieure installée et configurée. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

  • Pour déployer un modèle ARM, vous devez disposer d’un accès en écriture aux ressources que vous déployez et d’un 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 Microsoft.Compute/virtualMachines/write et Microsoft.Resources/deployments/* des autorisations. Pour obtenir la liste des rôles et autorisations, consultez Rôles intégrés Azure.

  • 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 système doivent contenir au moins un nœud. Les pools de nœuds utilisateur peuvent contenir zéro 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 ou AzureLinux. Vous ne pouvez pas créer de cluster avec un seul pool de nœuds Windows. Si vous souhaitez exécuter des conteneurs Windows, 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.

  • 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 des 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.

  • 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.

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 d’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 d’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 Linux système d’exploitation 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

Installer l’extension aks-preview

  1. Installez l’extension aks-preview Azure CLI en utilisant la commande az extension add.

    Important

    Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les versions d'essai sont fournies « en l’état » et « selon disponibilité », et elles sont exclues des contrats de niveau de service et de la garantie limitée. Les versions préliminaires AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Par conséquent, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

    az extension add --name aks-preview

  2. Mettez à jour vers la dernière version de l’extension à l’aide de la commande az extension update. Windows Server 2025 nécessite un minimum de 18.0.0b5.

    az extension update --name aks-preview
Inscrire l’indicateur de fonctionnalité AksWindows2025Preview

  1. Inscrivez l’indicateur de fonctionnalité AksWindows2025Preview à l’aide de la commande az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Vérifiez l’état de l’inscription en utilisant la commande az feature show. Quelques minutes sont nécessaires pour que l’état s’affiche Registered (Inscrit).

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Quand l’état reflète Inscrit, actualisez l’inscription du fournisseur de ressources Microsoft.ContainerService à l’aide de la commande az provider register.

    az provider register --namespace Microsoft.ContainerService
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.

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

    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 \
    --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 Microsoft.ContainerService/managedClusters ressource

  • Créez une Microsoft.ContainerService/managedClusters ressource en ajoutant ce 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 Linux système d’exploitation 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

Installer l’extension aks-preview

  1. Installez l’extension aks-preview Azure CLI en utilisant la commande az extension add.

    Important

    Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les versions d'essai sont fournies « en l’état » et « selon disponibilité », et elles sont exclues des contrats de niveau de service et de la garantie limitée. Les versions préliminaires AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Par conséquent, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

    az extension add --name aks-preview

  2. Mettez à jour vers la dernière version de l’extension à l’aide de la commande az extension update. Windows Server 2025 nécessite un minimum de 18.0.0b5.

    az extension update --name aks-preview
Inscrire l’indicateur de fonctionnalité AksWindows2025Preview

  1. Inscrivez l’indicateur de fonctionnalité AksWindows2025Preview à l’aide de la commande az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Vérifiez l’état de l’inscription en utilisant la commande az feature show. Quelques minutes sont nécessaires pour que l’état s’affiche Registered (Inscrit).

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Quand l’état reflète Inscrit, actualisez l’inscription du fournisseur de ressources Microsoft.ContainerService à l’aide de la commande az provider register.

    az provider register --namespace Microsoft.ContainerService
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