Condividi tramite

Creare pool di nodi per un cluster nel servizio Azure Kubernetes

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 dal 30 novembre 2025, AKS non supporterà più né fornirà aggiornamenti della sicurezza per Azure Linux 2.0. A partire dal 31 marzo 2026, le immagini dei nodi verranno rimosse e non sarà possibile ridimensionare i pool di nodi. Eseguire la migrazione a una versione di Linux di Azure supportata aggiornando i pool di nodi a una versione di Kubernetes supportata o eseguendo la migrazione a osSku AzureLinux3. Per ulteriori informazioni, vedere Ritiro del supporto: pool di nodi Azure Linux 2.0 su AKS.

Prerequisiti

  • È necessaria l'interfaccia della riga di comando di Azure versione 2.2.0 o successiva installata e configurata. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

  • 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 le autorizzazioni Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/*. Per un elenco dei ruoli e delle autorizzazioni, vedere Ruoli predefiniti di Azure.

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

  • Una volta che hai distribuito il cluster usando un modello ARM, è possibile usare Azure CLI 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 un nodo. 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, Ubuntu ad esempio o AzureLinux. Non è possibile creare un cluster con un singolo pool di nodi Windows. Se si desidera eseguire contenitori Windows, è 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 del servizio Azure Kubernetes deve usare i 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 i pool di nodi Windows, la lunghezza deve essere compresa tra 1 e 6 caratteri.

  • Tutti i pool di nodi devono trovarsi nella stessa rete virtuale.

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

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 di Azure con il comando az group create.

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

Creare un cluster AKS con un pool di nodi singolo utilizzando Azure CLI

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 l'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 Linux con uno SKU di Ubuntu o AzureLinux, oppure un tipo di sistema operativo 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 di Windows Server

Installare l'estensione aks-preview

  1. Installare l'estensione CLI di Azure utilizzando il comando aks-preview.

    Importante

    Le funzionalità di anteprima di AKS sono disponibili su base self-service, su scelta. Le anteprime vengono fornite "così come sono" e "come disponibili" e sono escluse dai contratti di servizio e dalla garanzia limitata. Le anteprime del servizio Azure Kubernetes sono parzialmente coperte dal supporto clienti con la massima diligenza possibile. Di conseguenza, queste funzionalità non sono destinate all'uso in produzione. Per altre informazioni, vedere gli articoli di supporto seguenti:

    az extension add --name aks-preview

  2. Eseguire l'aggiornamento alla versione più recente dell'estensione usando il comando az extension update. Windows Server 2025 richiede almeno 18.0.0b5.

    az extension update --name aks-preview
Registrare il flag di funzionalità AksWindows2025Preview

  1. Registrare il flag della funzionalità AksWindows2025Preview usando il comando az feature register.

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

  2. Verificare lo stato della registrazione usando il comando az feature show. Sono necessari alcuni minuti per visualizzare lo stato Registered.

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

  3. Quando lo stato riflette Registrato, aggiornare la registrazione del provider di risorse Microsoft.ContainerService usando il comando az provider register.

    az provider register --namespace Microsoft.ContainerService
Creare il pool di nodi di 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 Procedure consigliate di 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

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

  • Creare una Microsoft.ContainerService/managedClusters risorsa aggiungendo questo codice 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 Linux con uno SKU di Ubuntu o AzureLinux, oppure un tipo di sistema operativo 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 di Windows Server

Installare l'estensione aks-preview

  1. Installare l'estensione CLI di Azure utilizzando il comando aks-preview.

    Importante

    Le funzionalità di anteprima di AKS sono disponibili su base self-service, su scelta. Le anteprime vengono fornite "così come sono" e "come disponibili" e sono escluse dai contratti di servizio e dalla garanzia limitata. Le anteprime del servizio Azure Kubernetes sono parzialmente coperte dal supporto clienti con la massima diligenza possibile. Di conseguenza, queste funzionalità non sono destinate all'uso in produzione. Per altre informazioni, vedere gli articoli di supporto seguenti:

    az extension add --name aks-preview

  2. Eseguire l'aggiornamento alla versione più recente dell'estensione usando il comando az extension update. Windows Server 2025 richiede almeno 18.0.0b5.

    az extension update --name aks-preview
Registrare il flag di funzionalità AksWindows2025Preview

  1. Registrare il flag della funzionalità AksWindows2025Preview usando il comando az feature register.

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

  2. Verificare lo stato della registrazione usando il comando az feature show. Sono necessari alcuni minuti per visualizzare lo stato Registered.

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

  3. Quando lo stato riflette Registrato, aggiornare la registrazione del provider di risorse Microsoft.ContainerService usando il comando az provider register.

    az provider register --namespace Microsoft.ContainerService
Creare i pool di nodi di Windows Server 2025

  • Creare più pool di nodi Windows nel cluster AKS apportando le modifiche seguenti al template 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