Escalar manualmente a contagem de nós em um cluster do AKS (Serviço de Kubernetes do Azure)

Se as necessidades de recursos dos aplicativos alterarem, o desempenho do cluster poderá ser afetado devido à baixa capacidade de CPU, memória, espaço de PID ou tamanhos de disco. Para resolver essas alterações, você poderá dimensionar manualmente o cluster AKS para executar um número diferente de nós. Ao reduzir horizontalmente, os nós são cuidadosamente isolados e drenados para minimizar a interrupção aos aplicativos em execução. Ao reduzir verticalmente, o AKS aguarda até que os nós sejam marcados como Prontos pelo cluster do Kubernetes antes de os pods serem agendados neles.

Este artigo descreve como aumentar ou diminuir manualmente o número de nós em um cluster do AKS.

Note

Este artigo se aplica aos clusters padrão do AKS. Os clusters automáticos do AKS usam o provisionamento automático de nós para gerenciar o dimensionamento de nós.

Antes de começar

• Revise as cotas e os limites de serviço do AKS para verificar se o cluster pode ser escalado para o número desejado de nós.

• Se o dimensionador automático de cluster estiver habilitado no pool de nós, você não poderá alterar manualmente a contagem de nós. Você pode atualizar os valores mínimos e máximos do dimensionador automático do cluster oudesabilitar o dimensionador automático de cluster no pool de nós antes de dimensioná-lo manualmente.

• Azure suporte ao Linux 2.0 terminou em 30 de novembro de 2025. A partir de 31 de março de 2026, as imagens de nó do Azure Linux 2.0 foram removidas, e os pools de nós afetados não podem mais ser escalados. Migre para Azure Linux 3 antes de escalar um pool de nós do Azure Linux 2.0.

• Os nomes do pool de nós devem atender aos seguintes requisitos:

  Tipo de pool de nós	Requisitos de nome
  Linux	Entre 1 a 12 caracteres alfanuméricos minúsculos. Deve começar com uma letra minúscula.
  Windows	Entre 1 a 6 caracteres alfanuméricos minúsculos. Deve começar com uma letra minúscula.

Escalar os nós do cluster em AKS

Importante

Não há suporte para remover nós de um pool de nós usando o comando kubectl. Essa ação pode causar problemas de escalabilidade no seu cluster do AKS.

CLI do Azure

1. Obtenha o nome, o modo e o número de nós dos seus pools de nós usando o comando az aks show. O exemplo a seguir obtém os detalhes do pool de nós do cluster chamado myAKSCluster no grupo de recursos myResourceGroup:

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

   A saída de exemplo a seguir mostra que o nodepool1 é um pool de nós do sistema com três nós:

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

2. Dimensione os nós de cluster usando o az aks scale comando. O exemplo a seguir dimensiona o nodepool1 no cluster chamado myAKSCluster para dois nós:

   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
   

   A saída de exemplo a seguir mostra que o pool de nós do sistema foi escalado com êxito para dois nós:

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

   Os pools de nós do sistema devem ter pelo menos dois nós. Em clusters de produção, use pelo menos três nós em um pool de nós do sistema. Para obter mais informações, confira Pools de nós do sistema e do usuário.

PowerShell do Azure

1. Obtenha o nome, o modo, a contagem de nós e o estado de provisionamento dos pools de nós usando o Get-AzAksCluster comando. O exemplo a seguir obtém os detalhes do pool de nós do cluster chamado myAKSCluster no grupo de recursos myResourceGroup:

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -ExpandProperty AgentPoolProfiles |
     Select-Object Name, Mode, Count, ProvisioningState
   

   A saída de exemplo a seguir mostra que o nodepool1 é um pool de nós do sistema com três nós:

   Name                   : nodepool1
   Mode                   : System
   Count                  : 3
   ProvisioningState      : Succeeded
   

2. Dimensione os nós de cluster usando o comando Set-AzAksCluster . O -NodeName parâmetro aceita o nome do pool de nós. O exemplo a seguir dimensiona o nodepool1 no cluster chamado myAKSCluster para dois nós:

   Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeCount 2 -NodeName nodepool1 |
     Select-Object -ExpandProperty AgentPoolProfiles |
     Where-Object Name -eq nodepool1 |
     Select-Object Name, Mode, Count, ProvisioningState
   

   O exemplo de saída a seguir mostra que o pool de nós do sistema foi escalado com êxito para dois nós:

   Name                   : nodepool1
   Mode                   : System
   Count                  : 2
   ProvisioningState      : Succeeded
   

   Os pools de nós do sistema devem ter pelo menos dois nós. Para clusters de produção, use pelo menos três nós em um pool de nós do sistema. Para obter mais informações, confira Pools de nós do sistema e do usuário.

Redimensionar pools de nós de usuário para 0

Ao contrário dos pools de nós do sistema que sempre exigem nós em execução, os pools de nós de usuário podem ser dimensionados para 0. Para saber mais sobre as diferenças entre os pools de nós do sistema e do usuário, consulte pools de nós do sistema e do usuário.

Importante

Para dimensionar um pool de nós de usuário para 0 nós, desabilite o dimensionador automático de cluster. Para obter mais informações, confira Desabilitar o dimensionador automático de cluster em um pool de nós.

CLI do Azure

Para dimensionar um pool de nós de usuário para 0, use az aks nodepool scale em vez do az aks scale comando usado para dimensionamento geral de nós e defina --node-count como 0.

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

Você pode permitir, mas não forçar, o escalonamento automático para zero nós em pools de nós de usuário com escalonamento automático definindo o parâmetro --min-count do Cluster Autoscaler como 0.

PowerShell do Azure

Para dimensionar um pool de nós de usuário para 0, use Update-AzAksNodePool em vez do Set-AzAksCluster comando usado para dimensionamento geral de nós e defina -NodeCount como 0.

Update-AzAksNodePool -Name <your node pool name> -ClusterName myAKSCluster -ResourceGroupName myResourceGroup -NodeCount 0

Você pode permitir, mas não forçar, o escalonamento automático para zero nós em conjuntos de nós de usuário com escalonamento automático definindo o parâmetro -MinCount como 0:

Update-AzAksNodePool -Name <your node pool name> -ClusterName myAKSCluster -ResourceGroupName myResourceGroup -EnableAutoScaling -MinCount 0 -MaxCount <maximum node count>

Próximas etapas

Neste artigo, você dimensionou manualmente um cluster AKS para aumentar ou diminuir o número de nós. Você também pode usar o dimensionador automático de cluster para dimensionar automaticamente o cluster.