Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
È 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:
- Aumento del numero di nodi con la dimensione della VM di destinazione.
- Blocco e svuotamento dei nodi precedenti.
- 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, e33%è 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 --versionper trovare la versione. Se è necessario installare o aggiornare, vedere Installare interfaccia della riga di comando di Azure. - Versione dell'API di AKS
2026-02-01o 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
Runninge il pool di nodi non deve:- Usare VM Spot.
- Essere associato a un gruppo di prenotazioni di capacità.
- Usare la strategia di aggiornamento blu-verde.
- Un Static Egress Gateway node pool.
- Essere creato da uno snapshot del pool di nodi.
- Essere distribuito in una Azure Extended Zone.
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,ECoNP).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à.
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_v2Al 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.
- interfaccia della riga di comando di Azure
- Azure PowerShell
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.
Creare un nuovo pool di nodi usando il
az aks nodepool addcomando . In questo esempio, creiamo un nuovo pool di nodi,mynodepool, con tre nodi e lo SKU della macchina virtualeStandard_DS3_v2per sostituire un pool di nodi esistente,nodepool1, che ha lo SKU della macchina virtualeStandard_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-waitLa creazione del nuovo pool di nodi richiede alcuni minuti.
Ottenere lo stato del nuovo pool di nodi usando il
kubectl get nodescomando .kubectl get nodesL'output dovrebbe essere simile all'output di esempio seguente, che mostra sia il nuovo pool
mynodepooldi nodi che il poolnodepool1di 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.
Ottieni i nomi dei nodi che vuoi isolare usando il comando
kubectl get nodes.kubectl get nodesL'output dovrebbe essere simile al seguente esempio, che mostra i nodi nel pool di nodi esistente
nodepool1che 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.9Bloccare 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-vmss000002L'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.
Svuotare i nodi esistenti usando il comando
kubectl draincon le opzioni--ignore-daemonsetse--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 ilcorednscreato dal servizio Azure Kubernetes e i podmetrics-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-dataAl 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.
- interfaccia della riga di comando di Azure
- Azure PowerShell
Eliminare il pool di nodi originale usando il
az aks nodepool deletecomando .az aks nodepool delete \ --resource-group myResourceGroup \ --cluster-name myAKSCluster \ --name nodepool1Verificare 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 nodesL'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
- Altre informazioni sull'uso di più pool di nodi.
- Configurare le impostazioni di aggiornamento per i pool di nodi, ad esempio max surge e drain timeout, che vengono usate anche dal ridimensionamento sul posto.