Ridimensionare i pool di nodi nel servizio Azure Kubernetes (AKS)

È possibile modificare le dimensioni delle macchine virtuali per supportare un numero crescente di distribuzioni o per eseguire un carico di lavoro più grande. Ridimensionare sempre i pool di nodi tramite l'API di AKS. Non ridimensionare direttamente il set di scalabilità di macchine virtuali sottostante, come descritto nei criteri di supporto per il servizio Azure Kubernetes:

I nodi dell'agente del servizio Azure Kubernetes vengono visualizzati nel portale di Azure come normali risorse IaaS di Azure. Tuttavia, queste macchine virtuali vengono distribuite in un gruppo di risorse di Azure personalizzato (in genere preceduto da MC_*). Non è possibile eseguire personalizzazioni dirette a questi nodi usando le API O le risorse IaaS. Le modifiche personalizzate non eseguite tramite l'API di AKS non verranno mantenute durante un aggiornamento, una scalatura, un aggiornamento o un riavvio.

Importante

Questo articolo si applica ai pool di nodi basati su set di scalabilità di macchine virtuali. Quando si usano pool di nodi basati su Macchine virtuali, è possibile aggiornare le dimensioni delle macchine virtuali in un pool di nodi esistente usando un singolo comando interfaccia della riga di comando di Azure e avere più dimensioni di vm nello stesso pool di nodi. Per altre informazioni, vedere la documentazione relativa ai pool di nodi delle macchine virtuali.

Scegliere un metodo di ridimensionamento

È consigliabile ridimensionare il pool di nodi sul posto con un singolo comando. Se il ridimensionamento sul posto non supporta lo scenario, creare un nuovo pool di nodi con le dimensioni della macchina virtuale di destinazione e spostarvi i carichi di lavoro.

Opzione 1: Ridimensionare un pool di nodi sul posto

Quando si modificano le dimensioni della macchina virtuale (SKU) di un pool di nodi esistente usando az aks nodepool update --node-vm-size <new-size>, il servizio Azure Kubernetes esegue un aggiornamento in sequenza tramite:

  1. Aumento del numero di nodi con la dimensione della VM di destinazione.
  2. Blocco e svuotamento dei nodi precedenti.
  3. Eliminazione dei nodi precedenti.

Come funziona l'implementazione del ridimensionamento

La distribuzione del ridimensionamento usa lo stesso motore di aggiornamento progressivo di quello usato per un aggiornamento dell'immagine del nodo e per un aggiornamento della versione di Kubernetes, quindi rispetta le seguenti impostazioni relative agli aggiornamenti già configurate nel pool di nodi. In particolare, il ridimensionamento rispetta:

  • Max surge (--max-surge): controlla il numero di nodi aggiuntivi con le dimensioni della macchina virtuale di destinazione aggiunte durante l'implementazione. Un valore più alto ridimensiona il pool più velocemente, ma utilizza una maggiore quota di calcolo e IP; un valore inferiore è più lento ma meno dirompente. Il valore predefinito di AKS è 1, e 33% è consigliato per i pool di nodi di produzione.
  • Timeout di svuotamento dei nodi (--drain-timeout): tempo di attesa di AKS per la rimozione dei pod in ogni nodo vecchio prima di eliminarlo forzatamente. Il valore predefinito è 30 minuti. Combinarlo con PodDisruptionBudgets appropriati in modo che i carichi di lavoro possano essere svuotati in modo sicuro.
  • Durata di soak del nodo (--node-soak-duration): tempo di attesa di AKS dopo che un nuovo nodo diventa Pronto prima di passare al batch successivo. Utile per consentire la stabilizzazione dei carichi di lavoro sulle nuove dimensioni della macchina virtuale prima di continuare l'implementazione.

Prerequisiti

  • interfaccia della riga di comando di Azure versione 2.93.0 o successiva installata e configurata. Eseguire az --version per trovare la versione. Se è necessario installare o aggiornare, vedere Installare interfaccia della riga di comando di Azure.
  • Versione dell'API di AKS 2026-02-01 o successiva.
  • Poiché il ridimensionamento riutilizza la pipeline di aggiornamento max surge , si applicano gli stessi prerequisiti:
    • Verificare che la sottoscrizione disponga di una capacità di sostituzione di dimensioni sufficienti per le macchine virtuali di destinazione e gli INDIRIZZI IP della subnet disponibili per i nodi di picco.
    • I PodDisruptionBudgets consentono di rimuovere almeno una replica alla volta. In caso contrario, il ridimensionamento può essere bloccato durante lo svuotamento.
    • Per consigli completi, vedi Procedure consigliate per gli aggiornamenti del pool di nodi di AKS.

Ridimensionare il pool di nodi

Usare il az aks nodepool update comando con il --node-vm-size parametro per modificare le dimensioni della macchina virtuale di un pool di nodi basato su VMSS esistente:

az aks nodepool update \
    --resource-group MyResourceGroup \
    --cluster-name MyManagedCluster \
    --name nodepool1 \
    --node-vm-size Standard_D4s_v3

Note

Il ridimensionamento sul posto richiede capacità aggiuntiva temporanea per effettuare il provisioning di nuovi nodi con la dimensione della macchina virtuale di destinazione prima di svuotare i nodi precedenti. Se il pool di nodi è configurato con --max-surge 0 (vale a dire, --max-unavailable è attivo), la richiesta di ridimensionamento viene rifiutata con un oggetto 400 Bad Request. Per continuare, imposta --max-surge su almeno 1 durante il ridimensionamento con

az aks nodepool update \
    --resource-group MyResourceGroup \
    --cluster-name MyManagedCluster \
    --name nodepool1 \
    --node-vm-size Standard_D4s_v3 \
    --max-surge 33%

e, facoltativamente, ripristinare i valori originali --max-surge e --max-unavailable al termine del ridimensionamento.

Comprendere se il ridimensionamento del pool di nodi sul posto è supportato

Il ridimensionamento sul posto supporta solo scenari specifici. Dipende dalla configurazione del pool di nodi, dal sistema operativo e dal fatto che le dimensioni correnti e di destinazione della macchina virtuale usino lo stesso tipo di controller del disco (SCSI o NVMe). AKS convalida le richieste e rifiuta quelle non valide prima di modificare i nodi, quindi il pool di nodi rimane sulle dimensioni correnti della VM.

Le modifiche seguenti non sono supportate come parte di un ridimensionamento del set di scalabilità di macchine virtuali sul posto. Usare l'opzione 2: Ridimensionare creando un nuovo pool di nodi:

  • Modifica dell'architettura della CPU (ad esempio, da x64 ad ARM64).
  • Modifica del supporto per il calcolo riservato (ad esempio, l'abilitazione o la disabilitazione di SNP).
  • Modifica del tipo di disco del sistema operativo (ad esempio, ridimensionare un pool di nodi che usa un disco del sistema operativo temporaneo a una dimensione di macchina virtuale che non può ospitare il disco del sistema operativo nello stesso posizionamento).
  • Combinazione del ridimensionamento con un aggiornamento della versione di Kubernetes o una modifica del numero di nodi nella stessa operazione.

Ridimensionamento tra tipi di controller disco e generazioni di hypervisor

Quando le dimensioni della macchina virtuale di destinazione richiedono una generazione di controller disco o hypervisor diversa da quella attualmente usata dal pool di nodi, il servizio Azure Kubernetes aggiorna il controller del disco. Se necessario, AKS passa il pool di nodi alla versione Gen2 dell'immagine del nodo come parte dello stesso aggiornamento in sequenza.

Note

La migrazione del tipo di controller del disco è disponibile solo per i pool di nodi descritti in Idoneità del pool di nodi per la migrazione del controller del disco.

La tabella seguente riepiloga il modo in cui il servizio Azure Kubernetes gestisce i ridimensionamenti che passano tra tipi di controller del disco o generazioni di hypervisor:

Pool di nodi attuale Dimensioni della macchina virtuale di destinazione Result
Immagine del nodo Gen2 su una dimensione SCSI (ad esempio, Standard_D4ds_v5) Dimensione solo NVMe Gen2 (ad esempio, Standard_D4s_v6) Supportato per i pool di nodi idonei. I nuovi nodi usano il controller del disco NVMe. L'immagine del nodo non cambia. Gli altri pool di nodi hanno esito negativo con DiskControllerTypeIncompatible.
Immagine del nodo Gen1 in una dimensione che supporta sia Gen1 che Gen2, con SCSI (ad esempio, Standard_D4ds_v5) Dimensioni Gen2 solo NVMe (ad esempio, Standard_D4s_v6) Supportato per i pool di nodi idonei. Il servizio Azure Kubernetes passa alla versione Gen2 della stessa immagine del sistema operativo (ad esempio AKSUbuntu-2404gen2containerd) e al controller del disco NVMe. Gli altri pool di nodi hanno esito negativo con DiskControllerTypeIncompatible.
Immagine del nodo Gen1 con una dimensione supportata solo da Gen1 (ad esempio, Standard_D3_v2) Dimensioni solo NVMe gen2 (ad esempio, Standard_D4s_v6) Non supportato in un singolo passaggio. Usare un ridimensionamento in due passaggi.
Immagine del nodo Gen1 con dimensione solo Gen1 Dimensioni che supportano sia Gen1 che Gen2 Supportato (ridimensionamento standard). Il pool di nodi mantiene l'immagine del nodo Gen1.
Dimensione SCSI Dimensioni che supportano sia SCSI che NVMe (ad esempio, Standard_E4bds_v5) Supportato (ridimensionamento standard). Il pool di nodi mantiene il controller del disco SCSI.
Dimensione NVMe Dimensioni solo per SCSI Non supportato. La richiesta fallisce con DiskControllerTypeIncompatible.
Immagine del nodo Gen2 Dimensioni solo per Gen1 Non supportato. La richiesta ha esito negativo con HypervisorGenerationIncompatible, oppure con DiskControllerTypeIncompatible se la dimensione corrente è NVMe.

Quando il servizio Azure Kubernetes passa da Gen1 a Gen2, il pool di nodi mantiene lo SKU del sistema operativo, la versione del sistema operativo e la versione di Kubernetes. Cambiano solo la generazione dell'immagine del nodo, il firmware (da BIOS a UEFI) e il controller del disco.

Idoneità del gruppo di nodi per la migrazione del controller disco

Importante

I requisiti seguenti si applicano solo ai ridimensionamenti che modificano il tipo di controller del disco. I pool di nodi che non soddisfano tali requisiti possono comunque usare il ridimensionamento standard tra le dimensioni delle macchine virtuali con lo stesso tipo di controller del disco. Per spostare questi pool di nodi in una dimensione solo NVMe, creare invece un nuovo pool di nodi .

Per eseguire il ridimensionamento da una dimensione SCSI a una dimensione solo NVMe, con o senza un commutatore da Gen1 a Gen2, il pool di nodi deve soddisfare tutti i requisiti seguenti:

  • Sistema operativo: il pool di nodi usa l'immagine del nodo Gen1 o Gen2 standard per Ubuntu 22.04, Ubuntu 24.04 o Azure Linux 3.0. Altri SKU del sistema operativo e varianti di immagine non sono supportati, tra cui Windows, Azure Container Linux, Ubuntu 26.04 e FIPS- enabled, Trusted Launch, confidential VM, Arm64 e Kata (pod sandboxing).

  • Configurazione del pool di nodi: il pool di nodi e il cluster devono essere nello stato Running e il pool di nodi non deve:

  • Dimensioni delle macchine virtuali: né le dimensioni correnti né quelle della macchina virtuale di destinazione possono essere dimensioni abilitate per GPU o per il calcolo riservato (ad esempio, le serie DC, EC o NP).

  • Richiesta: oltre alle restrizioni che si applicano a ogni ridimensionamento sul posto, la richiesta non può modificare anche le impostazioni di scalabilità automatica, la versione dell'immagine del nodo, le zone di disponibilità, le etichette dei nodi, i tag delle macchine virtuali, le impostazioni del gruppo di sicurezza di rete (allowedHostPorts, applicationSecurityGroups) o l'attendibilità della CA personalizzata.

Ridimensionare da una dimensione solo Gen1 a una dimensione solo NVMe

Importante

Non è possibile ridimensionare un pool di nodi direttamente da una dimensione di sola generazione (ad esempio, Standard_D3_v2) a una dimensione gen2, solo NVMe (ad esempio, Standard_D4s_v6). Ridimensiona invece in due passaggi. Il secondo passaggio è una migrazione del controller del disco, quindi il pool di nodi deve soddisfare i requisiti di idoneità.

  1. Ridimensionare il pool di nodi a una dimensione SCSI che supporta sia Gen1 che Gen2, ad esempio Standard_DS3_v2. Il pool di nodi mantiene l'immagine del nodo Gen1. Questo passaggio è un ridimensionamento standard.

    az aks nodepool update \
        --resource-group MyResourceGroup \
        --cluster-name MyManagedCluster \
        --name nodepool1 \
        --node-vm-size Standard_DS3_v2
    
  2. Al termine del primo ridimensionamento, ridimensionare il pool di nodi alle dimensioni solo NVMe. AKS passa all'immagine del nodo Gen2 e al controller del disco NVMe.

    az aks nodepool update \
        --resource-group MyResourceGroup \
        --cluster-name MyManagedCluster \
        --name nodepool1 \
        --node-vm-size Standard_D4s_v6
    

Note

Poiché il disco del sistema operativo in macchine virtuali basate su NVMe viene esposto come dispositivo NVMe (ad esempio, /dev/nvme0n1) anziché un dispositivo SCSI (ad esempio, /dev/sda), esaminare eventuali carichi di lavoro, DaemonSet o script che fanno riferimento ai percorsi dei dispositivi direttamente prima del ridimensionamento.

Opzione 2: Ridimensionare creando un nuovo pool di nodi

Usare questo metodo quando il ridimensionamento sul posto non supporta lo scenario. Si crea un nuovo pool di nodi con le dimensioni della macchina virtuale di destinazione, si spostano i carichi di lavoro in esso delimitando e svuotando i nodi esistenti e quindi eliminando il pool di nodi esistente.

Creare un nuovo pool di nodi con lo SKU desiderato

Note

Ogni cluster del servizio Azure Kubernetes deve contenere almeno un pool di nodi di sistema con almeno un nodo. In questo esempio viene usato un --mode di System per aggiungere un pool di nodi di sistema in sostituzione del pool di nodi di sistema da ridimensionare. È possibile aggiornare la modalità di un pool di nodi in qualsiasi momento. È anche possibile aggiungere un pool di nodi utente impostando --mode su User.

Durante il ridimensionamento, assicurarsi di prendere in considerazione tutti i requisiti del carico di lavoro, ad esempio le zone di disponibilità, e di configurare di conseguenza il pool di nodi del set di scalabilità di macchine virtuali. Potrebbe essere necessario modificare il comando seguente in base alle proprie esigenze. Per un elenco completo delle opzioni di configurazione, vedere la pagina di riferimento az aks nodepool add.

  1. Creare un nuovo pool di nodi usando il az aks nodepool add comando . In questo esempio, creiamo un nuovo pool di nodi, mynodepool, con tre nodi e lo SKU della macchina virtuale Standard_DS3_v2 per sostituire un pool di nodi esistente, nodepool1, che ha lo SKU della macchina virtuale Standard_DS2_v2.

    az aks nodepool add \
        --resource-group myResourceGroup \
        --cluster-name myAKSCluster \
        --name mynodepool \
        --node-count 3 \
        --node-vm-size Standard_DS3_v2 \
        --mode System \
        --no-wait
    

    La creazione del nuovo pool di nodi richiede alcuni minuti.

  2. Ottenere lo stato del nuovo pool di nodi usando il kubectl get nodes comando .

    kubectl get nodes
    

    L'output dovrebbe essere simile all'output di esempio seguente, che mostra sia il nuovo pool mynodepool di nodi che il pool nodepool1di nodi esistente:

    NAME                                 STATUS   ROLES   AGE   VERSION
    aks-mynodepool-98765432-vmss000000   Ready    agent   23m   v1.21.9
    aks-mynodepool-98765432-vmss000001   Ready    agent   23m   v1.21.9
    aks-mynodepool-98765432-vmss000002   Ready    agent   23m   v1.21.9
    aks-nodepool1-12345678-vmss000000    Ready    agent   10d   v1.21.9
    aks-nodepool1-12345678-vmss000001    Ready    agent   10d   v1.21.9
    aks-nodepool1-12345678-vmss000002    Ready    agent   10d   v1.21.9
    

Blocco dei nodi esistenti

Il blocco contrassegna i nodi specificati come non pianificabili e impedisce l'aggiunta di altri pod ai nodi.

  1. Ottieni i nomi dei nodi che vuoi isolare usando il comando kubectl get nodes.

    kubectl get nodes
    

    L'output dovrebbe essere simile al seguente esempio, che mostra i nodi nel pool di nodi esistente nodepool1 che desideri isolare.

    NAME                                STATUS   ROLES   AGE     VERSION
    aks-nodepool1-12345678-vmss000000   Ready    agent   7d21h   v1.21.9
    aks-nodepool1-12345678-vmss000001   Ready    agent   7d21h   v1.21.9
    aks-nodepool1-12345678-vmss000002   Ready    agent   7d21h   v1.21.9
    
  2. Bloccare i nodi esistenti usando il comando kubectl cordon, specificando i nodi desiderati in un elenco delimitato da spazi. Per esempio:

    kubectl cordon aks-nodepool1-12345678-vmss000000 aks-nodepool1-12345678-vmss000001 aks-nodepool1-12345678-vmss000002
    

    L'output dovrebbe essere simile all'output di esempio seguente, che mostra che i nodi sono delimitati:

    node/aks-nodepool1-12345678-vmss000000 cordoned
    node/aks-nodepool1-12345678-vmss000001 cordoned
    node/aks-nodepool1-12345678-vmss000002 cordoned
    

Svuotare i nodi esistenti

Importante

Per svuotare correttamente i nodi e rimuovere i pod in esecuzione, assicurarsi che qualsiasi PodDisruptionBudgets (PDB) consenta lo spostamento di almeno una replica pod alla volta. In caso contrario, l'operazione di svuotamento/rimozione ha esito negativo. Per eseguire la verifica, è possibile eseguire kubectl get pdb -A e verificare che ALLOWED DISRUPTIONS sia almeno 1 o superiore.

Lo svuotamento dei nodi causerà la rimozione e la ricreazione dei pod negli altri nodi pianificabili.

  1. Svuotare i nodi esistenti usando il comando kubectl drain con le opzioni --ignore-daemonsets e --delete-emptydir-data, specificando i nodi desiderati in un elenco separato da spazi. Per esempio:

    Importante

    L'uso di --delete-emptydir-data è necessario per rimuovere il coredns creato dal servizio Azure Kubernetes e i pod metrics-server. Se non si usa questo flag, viene visualizzato un errore. Per altre informazioni, vedere la documentazione su emptydir.

    kubectl drain aks-nodepool1-12345678-vmss000000 aks-nodepool1-12345678-vmss000001 aks-nodepool1-12345678-vmss000002 --ignore-daemonsets --delete-emptydir-data
    
  2. Al termine dell'operazione di svuotamento, tutti i pod (esclusi quelli controllati dai set daemon) devono essere operativi nel nuovo pool di nodi. È possibile verificarlo usando il comando kubectl get pods.

    kubectl get pods -o wide -A
    

Risolvere i problemi di rimozione dei pod

Durante lo svuotamento dei nodi potrebbe verificarsi l'errore seguente:

Error when evicting pods/[podname] -n [namespace] (will retry after 5s): Cannot evict pod as it would violate the pod's disruption budget.

Per impostazione predefinita, il cluster prevede budget di interruzione dei pod gestiti dal servizio Azure Kubernetes (ad esempio coredns-pdb o konnectivity-agent) con MinAvailable pari a 1. Ad esempio, se sono in esecuzione due pod coredns, è possibile interromperne uno solo alla volta. Mentre un pod è in corso di creazione e non è disponibile, non è possibile rimuovere l'altro pod coredns a causa del budget di interruzione del pod. Questo problema si risolve dopo la pianificazione e l'esecuzione del pod coredns iniziale, consentendo al secondo pod di essere rimosso e ricreato correttamente.

Suggerimento

Valutare la possibilità di svuotare i nodi uno per uno per un'esperienza di rimozione più fluida ed evitare limitazioni. Per altre informazioni, vedere:

Rimuovere il pool di nodi esistente

Importante

Quando si elimina un pool di nodi, il servizio Azure Kubernetes non esegue il blocco e lo svuotamento. Per ridurre al minimo l'interruzione dei pod di riprogrammazione attualmente in esecuzione nel pool di nodi che si prevede di eliminare, eseguire un blocco e svuotamento di tutti i nodi del pool, prima di eliminarli.

  1. Eliminare il pool di nodi originale usando il az aks nodepool delete comando .

    az aks nodepool delete \
        --resource-group myResourceGroup \
        --cluster-name myAKSCluster \
        --name nodepool1
    
  2. Verificare che il cluster AKS abbia solo il nuovo pool di nodi con le applicazioni e i pod correttamente in esecuzione utilizzando il comando kubectl get nodes.

    kubectl get nodes
    

    L'output dovrebbe essere simile all'output di esempio seguente, che mostra solo il nuovo pool mynodepooldi nodi :

    NAME                                 STATUS   ROLES   AGE   VERSION
    aks-mynodepool-98765432-vmss000000   Ready    agent   63m   v1.21.9
    aks-mynodepool-98765432-vmss000001   Ready    agent   63m   v1.21.9
    aks-mynodepool-98765432-vmss000002   Ready    agent   63m   v1.21.9
    

Passaggi successivi