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. Il ridimensionamento delle istanze del servizio Azure Kubernetes direttamente non è supportato quando si usano set di scalabilità di macchine virtuali nel servizio Azure Kubernetes, 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.

In questo articolo viene illustrato il metodo consigliato per ridimensionare un pool di nodi creando un nuovo pool di nodi con le dimensioni dello SKU desiderate, il blocco e lo svuotamento dei nodi esistenti e quindi la rimozione del pool di nodi esistente.

Ridimensionare direttamente un pool di nodi del set di scalabilità di macchine virtuali (anteprima)

È ora possibile ridimensionare le dimensioni della macchina virtuale (SKU) di un pool di nodi basato su VMSS esistente in un singolo comando usando az aks nodepool update --node-vm-size <new-size>. Quando si avvia questo aggiornamento, il provider di risorse AKS esegue un aggiornamento progressivo come segue:

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.

In questo modo si evita il flusso di lavoro manuale di creazione/blocco/svuotamento/eliminazione descritto nel resto di questo articolo.

Come funziona il rilascio 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 drenaggio del nodo (--drain-timeout): tempo per cui AKS attende l'evizione dei pod su ciascun nodo precedente prima di eliminarlo forzatamente. Il valore predefinito è 30 minuti. Combinarla con podDisruptionBudgets appropriati in modo che i carichi di lavoro possano essere svuotati in modo sicuro.
• Durata di stabilizzazione del nodo (--node-soak-duration): Per quanto tempo AKS attende dopo che un nuovo nodo diventa pronto prima di passare al gruppo successivo. Utile per consentire la stabilizzazione dei carichi di lavoro sulle nuove dimensioni della macchina virtuale prima di continuare l'implementazione.

Poiché il ridimensionamento riutilizza la pipeline di aggiornamento, si applicano gli stessi prerequisiti: assicurarsi che la sottoscrizione disponga di capacità di sostituzione delle dimensioni della macchina virtuale di destinazione sufficiente e degli indirizzi IP di subnet disponibili per i nodi di picco e che i PodDisruptionBudget consentano la rimozione di almeno una replica alla volta, altrimenti il ridimensionamento può essere bloccato durante lo svuotamento. Per consigli completi, vedi Procedure consigliate per gli aggiornamenti del pool di nodi di AKS.

Prerequisiti

• Versione dell'API di AKS 2026-01-02-preview o successiva.
• La versione più recente dell'estensione interfaccia della riga di comando di Azure aks-preview.

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

Convalida e combinazioni non supportate

Il provider di risorse del servizio Azure Kubernetes convalida la richiesta di ridimensionamento e blocca le modifiche alle dimensioni delle macchine virtuali incompatibili. Le modifiche seguenti non sono supportate come parte di un ridimensionamento del set di scalabilità di macchine virtuali sul posto:

• Modifica del tipo di controller del disco, ad esempio da SCSI a NVMe.
• 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 della generazione dell'hypervisor ( ad esempio da V1 a V2).
• Combinazione del ridimensionamento con un aggiornamento della versione di Kubernetes o una modifica del numero di nodi nella stessa operazione.

Se le dimensioni della macchina virtuale di destinazione richiedono una delle modifiche precedenti, usare invece il flusso di lavoro manuale di cordon-and-drain descritto nelle sezioni seguenti.

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

Creare un nuovo pool di nodi con lo SKU desiderato

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

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.

Rimuovere il pool di nodi esistente

Passaggi successivi

Dopo il ridimensionamento di un pool di nodi tramite il blocco e lo svuotamento, vedere altre informazioni sull’uso di più pool di nodi.