Creare pool di nodi per un cluster in Servizio Azure Kubernetes (AKS)

Questo articolo illustra come creare uno o più pool di nodi in un cluster del servizio Azure Kubernetes.

Note

Questa funzionalità consente un maggiore controllo sulla creazione e la gestione di più pool di nodi e richiede comandi separati per operazioni CRUD (create/update/delete). In precedenza, le operazioni del cluster tramite az aks create o az aks update usavano l'API managedCluster ed erano le uniche opzioni per modificare il piano di controllo e un singolo pool di nodi. Questa funzionalità espone un set di operazioni separato per i pool di agenti tramite l'API agentPool e richiede l'uso az aks nodepool del set di comandi per eseguire operazioni in un singolo pool di nodi.

Importante

A partire da November 30, 2025, Servizio Azure Kubernetes (AKS) non supporta più o fornisce aggiornamenti della sicurezza per Azure Linux 2.0. L'immagine del nodo Azure Linux 2.0 è congelata alla versione 202512.06.0. A partire dal 31 marzo 2026, le immagini dei nodi verranno rimosse e non sarà possibile ridimensionare i pool di nodi. Effettuare la migrazione a una versione supportata di Linux su Azure aggiornando i pool di nodi a una versione supportata di Kubernetes o effettuando la migrazione a osSku AzureLinux3. Per altre informazioni, vedere Retirement GitHub issue e annuncio di ritiro degli aggiornamenti di Azure. Per rimanere informati sugli annunci e sugli aggiornamenti, segui le note di rilascio di AKS.

Prerequisiti

  • Per distribuire un modello di Resource Manager, è necessario l'accesso in scrittura alle risorse distribuite e l'accesso a tutte le operazioni sul tipo di risorsa Microsoft.Resources/deployments. Ad esempio, per distribuire una macchina virtuale (VM), sono necessarie autorizzazioni Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/*. Per un elenco di ruoli e autorizzazioni, vedere Azure ruoli predefiniti.
  • Esaminare i requisiti seguenti per ogni parametro:
    • osType: tipo di sistema operativo. Il valore predefinito è Linux.
    • osSKU: specifica lo SKU del sistema operativo usato dal pool di agenti.
    • count: numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1.000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1.000 (inclusi) per i pool di sistema. Il valore predefinito è 1.
  • Dopo aver distribuito il cluster usando un modello di Azure Resource Manager, è possibile utilizzare interfaccia della riga di comando di Azure o Azure PowerShell per connettersi al cluster e distribuire l'applicazione di esempio.

Limitazioni

Quando si creano cluster del servizio Azure Kubernetes che supportano pool di nodi multipli, si applicano le limitazioni seguenti:

  • È possibile eliminare il pool di nodi di sistema se nel cluster del servizio Azure Kubernetes è presente un altro pool di nodi di sistema. In caso contrario, non è possibile eliminare il pool di nodi di sistema.
  • I pool di sistema devono contenere almeno due nodi e i pool di nodi utente possono contenere zero o più nodi.
  • Se si crea un cluster con un pool a nodo singolo, il tipo di sistema operativo deve essere Linux. Lo SKU del sistema operativo può essere qualsiasi variante di Linux, Ubuntuad esempio , AzureContainerLinuxo AzureLinux. Non è possibile creare un cluster con un singolo pool di nodi Windows. Se si vuole eseguire Windows contenitori, è necessario aggiungere un pool di nodi Windows al cluster dopo averlo creato con un pool di nodi di sistema Linux.
  • Il cluster del servizio Azure Kubernetes deve usare il servizio di bilanciamento del carico dello SKU Standard per usare più pool di nodi. Questa funzionalità non è supportata con i servizi di bilanciamento del carico dello SKU Basic.
  • Il cluster AKS deve usare set di scalabilità di macchine virtuali per i nodi.
  • Il nome di un pool di nodi può contenere solo caratteri alfanumerici minuscoli e deve iniziare con una lettera minuscola.
    • Per i pool di nodi Linux, la lunghezza deve essere compresa tra 1 e 12 caratteri.
    • Per Windows pool di nodi, la lunghezza deve essere compresa tra 1 e 6 caratteri.
  • Tutti i pool di nodi devono trovarsi nella stessa rete virtuale.All node pools must reside in the same virtual network (VNet).
  • Non è possibile modificare le dimensioni della macchina virtuale di un pool di nodi dopo averlo creato.
  • Quando si creano più pool di nodi in fase di creazione del cluster, le versioni di Kubernetes per i pool di nodi devono corrispondere al set di versione per il piano di controllo. È possibile eseguire aggiornamenti dopo il provisioning del cluster usando le operazioni per pool di nodi.

Importante

Se si utilizza Azure Container Linux (ACL) in AKS, assicurarsi di consultare le seguenti considerazioni e limitazioni:

Creare pool di nodi specializzati

Per informazioni su come creare pool di nodi specializzati, vedere gli articoli seguenti:

Impostare le variabili di ambiente

Impostare le variabili di ambiente seguenti nella shell per semplificare i comandi in questo articolo. È possibile modificare i valori con i nomi preferiti.

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

Creare un gruppo di risorse

Creare un gruppo di risorse Azure usando il comando az group create.

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

Creare un cluster AKS con un pool di nodi singolo usando l'interfaccia della riga di comando di Azure

Se desideri avere un solo pool di nodi nel tuo cluster AKS, è possibile pianificare i pod dell'applicazione sui pool di nodi di sistema. Se si esegue un singolo pool di nodi di sistema per il cluster del servizio Azure Kubernetes in un ambiente di produzione, è consigliabile usare almeno tre nodi per il pool di nodi. Se un nodo diventa inattivo, la ridondanza è compromessa. È possibile ridurre questo rischio disponendo di più nodi del pool di nodi di sistema.

  1. Creare un cluster con un singolo pool di nodi Ubuntu usando il az aks create comando . Questo passaggio specifica due nodi nel pool a nodo singolo.

    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 creazione del cluster richiede alcuni minuti.

  2. Quando il cluster è pronto, ottenere le credenziali del cluster usando il comando az aks get-credentials.

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

Aggiungere un secondo pool di nodi usando il interfaccia della riga di comando di Azure

Il cluster creato nella sezione precedente ha un singolo pool di nodi. In questa sezione viene aggiunto un secondo pool di nodi al cluster. Questo secondo pool di nodi può avere un tipo di sistema operativo di Linux con uno SKU del sistema operativo di Ubuntu o AzureLinux o un tipo di sistema operativo di Windows.

Note

Se si desidera aggiungere un pool di nodi che utilizza dischi del sistema operativo effimeri al cluster di AKS, è possibile impostare il flag --node-osdisk-type su Ephemeral quando si esegue il comando az aks nodepool add.

Con il sistema operativo temporaneo, è possibile distribuire macchine virtuali e immagini di istanza fino alle dimensioni della cache della macchina virtuale. La configurazione predefinita del disco del sistema operativo del nodo nel servizio Azure Kubernetes usa 128 GB, il che significa che sono necessarie dimensioni di macchina virtuale con una cache superiore a 128 GB. Il valore predefinito Standard_DS2_v2 ha una dimensione della cache di 86 GB, che non è sufficiente. Lo SKU della Standard_DS3_v2 macchina virtuale ha una dimensione della cache di 172 GB, che è sufficientemente grande. È anche possibile ridurre le dimensioni predefinite del disco del sistema operativo usando --node-osdisk-size, ma tenere presente che le dimensioni minime per le immagini del servizio Azure Kubernetes sono di 30 GB.

Se si desidera creare pool di nodi con dischi del sistema operativo collegati alla rete, è possibile impostare il --node-osdisk-type flag su Managed quando si esegue il az aks nodepool add comando .

Aggiungere un pool di nodi Linux

Creare un nuovo pool di nodi usando il comando az aks nodepool add. L'esempio seguente crea un pool di nodi Linux con lo SKU del sistema operativo Ubuntu che esegue tre nodi. Se non si specifica uno SKU del sistema operativo, Azure Kubernetes Service (AKS) utilizza per impostazione predefinita Ubuntu.

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 creazione del pool di nodi richiede alcuni minuti.

Aggiungere un pool di nodi Windows Server

Creare il pool di nodi Windows Server 2025

Creare un nuovo pool di nodi usando il comando az aks nodepool add. L'esempio seguente crea un pool di nodi Windows con lo SKU del sistema operativo Windows2025 che esegue tre nodi.

Per altre informazioni sul sistema operativo Windows, vedere Windows procedure consigliate.

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

Controllare lo stato dei pool di nodi

Controllare lo stato dei pool di nodi usando il comando az aks nodepool list e specificare il gruppo di risorse e il nome del cluster.

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

Creare un cluster AKS con un singolo pool di nodi usando un modello ARM

Se desideri avere un solo pool di nodi nel tuo cluster AKS, è possibile pianificare i pod dell'applicazione sui pool di nodi di sistema. Se si esegue un singolo pool di nodi di sistema per il cluster del servizio Azure Kubernetes in un ambiente di produzione, è consigliabile usare almeno tre nodi per il pool di nodi. Se un nodo diventa inattivo, la ridondanza è compromessa. È possibile ridurre questo rischio disponendo di più nodi del pool di nodi di sistema.

Creare una risorsa Microsoft.ContainerService/managedClusters

Creare una risorsa Microsoft.ContainerService/managedClusters aggiungendo this JSON al modello.

  • Creare un singolo pool di nodi Ubuntu nel cluster AKS apportando le modifiche seguenti al modello ARM:

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

Aggiungere un secondo pool di nodi usando un modello ARM

Il cluster creato nella sezione precedente ha un singolo pool di nodi. In questa sezione viene aggiunto un secondo pool di nodi al cluster. Questo secondo pool di nodi può avere un tipo di sistema operativo di Linux con uno SKU del sistema operativo di Ubuntu o AzureLinux o un tipo di sistema operativo di Windows.

Aggiungere pool di nodi Linux

  • Creare più pool di nodi Ubuntu nel cluster del servizio Azure Kubernetes apportando le modifiche seguenti al modello di Resource Manager:

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

Aggiungere pool di nodi Windows Server

Creare i pool di nodi per Windows Server 2025

  • Crea più pool di nodi Windows nel tuo cluster AKS apportando le seguenti modifiche al modello ARM.

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

Distribuire il modello di Resource Manager

Impostare taints, etichette o tag per un pool di nodi

Quando si crea un pool di nodi, è possibile aggiungere tag, etichette o tag. Quando si aggiunge un taint, un'etichetta o un tag, tutti i nodi all'interno del pool di nodi ottengono anche tale taint, etichetta o tag. È consigliabile applicare queste proprietà a un intero pool di nodi anziché a singoli nodi. In questo modo, è possibile gestire facilmente le proprietà di tutti i nodi nel pool di nodi aggiornando le proprietà del pool di nodi anziché aggiornare singolarmente ogni nodo.

Per le istruzioni specifiche su come impostare taints, etichette o tag di un pool di nodi, utilizzare le risorse seguenti.

Passaggi successivi

In questo articolo hai imparato come creare un AKS cluster con un pool a nodo singolo e aggiungere pool di nodi aggiuntivi al cluster. Per altre informazioni su come gestire i pool di nodi, vedere gli articoli seguenti:

  • Last updated on