Ridimensionare manualmente il numero di nodi in un cluster del servizio Azure Kubernetes (AKS)

Eventuali cambiamenti delle esigenze delle risorse delle applicazioni potrebbero influire sulle prestazioni del cluster a causa della bassa capacità a livello di CPU, memoria, spazio PID o dimensioni del disco. Per gestire queste modifiche, è possibile ridimensionare manualmente il cluster del servizio Azure Kubernetes in modo che esegua un numero diverso di nodi. Quando si esegue il ridimensionamento, i nodi vengono accuratamente delimitati e svuotati per ridurre al minimo le interruzioni per l'esecuzione delle applicazioni. Quando sceglie la scalabilità orizzontale, il servizio Azure Kubernetes attende che tutti i nodi vengano contrassegnati come Pronti dal cluster Kubernetes prima che i pod vengano pianificati su di essi.

Questo articolo descrive come aumentare o ridurre manualmente il numero di nodi in un cluster del servizio Azure Kubernetes.

Note

Questo articolo si applica ai cluster Standard di AKS. I cluster automatici di AKS usano node autoprovisioning per gestire il ridimensionamento dei nodi.

Operazioni preliminari

  • Esaminare le quote e i limiti del servizio AKS per verificare che il cluster possa essere scalato al numero di nodi desiderato.

  • Se il ridimensionamento automatico del cluster è abilitato nel pool di nodi, non è possibile modificare manualmente il numero di nodi. È possibile aggiornare i valori minimi e massimi del ridimensionamento automatico del cluster o disabilitare il ridimensionamento automatico del cluster nel pool di nodi prima di ridimensionarlo manualmente.

  • Il supporto per Azure Linux 2.0 è terminato il 30 novembre 2025. A partire dal 31 marzo 2026, le immagini dei nodi di Azure Linux 2.0 sono state rimosse e i pool di nodi interessati non possono più essere ridimensionati. Eseguire la migrazione a Azure Linux 3 prima di ridimensionare un pool di nodi linux 2.0 Azure.

  • I nomi dei pool di nodi devono soddisfare i requisiti seguenti:

    Tipo di pool di nodi Requisiti per i nomi
    Linux Tra 1 e 12 caratteri alfanumerici minuscoli. Deve iniziare con una lettera minuscola.
    Windows Tra 1 e 6 caratteri alfanumerici minuscoli. Deve iniziare con una lettera minuscola.

Ridimensionare i nodi del cluster in AKS

Importante

La rimozione di nodi da un pool di nodi tramite il kubectl comando non è supportata. Questa azione può causare problemi di scalabilità con il cluster AKS.

  1. Ottieni il nome, la modalità e il numero di nodi dei set di nodi usando il comando az aks show. L'esempio seguente ottiene i dettagli del pool di nodi per il cluster denominato myAKSCluster nel gruppo di risorse myResourceGroup :

    az aks show --resource-group myResourceGroup --name myAKSCluster --query "agentPoolProfiles[].{Name:name,Mode:mode,Count:count}" --output table

    L'output di esempio seguente mostra che nodepool1 è un pool di nodi di sistema con tre nodi:

    Name       Mode    Count
---------  ------  -------
nodepool1  System  3

  2. Ridimensionare i nodi del cluster usando il az aks scale comando . L'esempio seguente ridimensiona nodepool1 nel cluster denominato myAKSCluster a due nodi:

    az aks scale --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-name nodepool1 --query "agentPoolProfiles[?name=='nodepool1'].{Name:name,Mode:mode,Count:count}" --output table

    L'output di esempio seguente mostra che il pool di nodi di sistema è stato ridimensionato correttamente in due nodi:

    Name       Mode    Count
---------  ------  -------
nodepool1  System  2

    I pool di nodi di sistema devono avere almeno due nodi. Per i cluster di produzione, usare almeno tre nodi in un pool di nodi di sistema. Per altre informazioni, vedere pool di nodi di sistema e utente .

Ridimensionare i pool di nodi utente a 0

A differenza dei pool di nodi di sistema che richiedono sempre nodi in esecuzione, i pool di nodi utente possono essere ridimensionati a 0. Per altre informazioni sulle differenze tra pool di nodi di sistema e utente, vedere Pool di nodi di sistema e utente.

Importante

Per ridimensionare un pool di nodi utente a 0 nodi, disabilitare il ridimensionamento automatico del cluster. Per altre informazioni, vedere Disabilitare il ridimensionamento automatico del cluster in un pool di nodi.

Per ridimensionare un pool di nodi utente su 0, usare az aks nodepool scale anziché il comando usato per il az aks scale ridimensionamento generale dei nodi e impostare su --node-count0.

az aks nodepool scale --name <your node pool name> --cluster-name myAKSCluster --resource-group myResourceGroup  --node-count 0

È possibile consentire, ma non forzare, la scalabilità automatica su zero nodi nei pool di nodi utente con scalabilità automatica impostando il --min-count parametro di Scalabilità automatica del cluster su 0.

Passaggi successivi

In questo articolo è stato ridimensionato manualmente un cluster del servizio Azure Kubernetes per aumentare o ridurre il numero di nodi. È anche possibile usare il ridimensionamento automatico del cluster per ridimensionare automaticamente il cluster.

  • Last updated on