Dimensionar manualmente o número de nós em um cluster do Serviço do Azure Kubernetes (AKS)

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

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

Observação

Este artigo aplica-se a clusters AKS Standard. Clusters automáticos do AKS utilizam o autoprovisionamento de nós para gerir a escalabilidade dos nós.

Antes de começar

Analise as cotas e limites de serviço do AKS para verificar se o cluster pode ser dimensionado para o número desejado de nós.
Se o autoescalador do cluster estiver ativado no pool de nós, não podes alterar manualmente a contagem de nós. Podes atualizar os valores mínimos e máximos do autoscaler do cluster ou desativar o autoscaler do cluster no pool de nós antes de o escalar manualmente.
O suporte ao Azure Linux 2.0 terminou a 30 de novembro de 2025. A partir de 31 de março de 2026, as imagens dos nós do Azure Linux 2.0 foram removidas e os pools de nós afetados deixam de poder ser dimensionados. Migre para Azure Linux 3 antes de escalar um pool de nós Azure Linux 2.0.

Os nomes do pool de nós devem cumprir os seguintes requisitos:

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

Dimensionar nós do cluster no AKS

Importante

Remover nós de um pool de nós usando o kubectl comando não é suportado. Esta ação pode criar problemas de escalabilidade no seu cluster AKS.

CLI do Azure
Azure PowerShell

Obtenha o nome, o modo e o número de nós dos seus conjuntos de nós utilizando o comando az aks show. O exemplo seguinte 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
```
O seguinte exemplo mostra que o nodepool1 é um pool de nós do sistema com três nós:
```
Name       Mode    Count
---------  ------  -------
nodepool1  System  3
```
Escala os nós do cluster usando o az aks scale comando. O exemplo seguinte escala 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
```
O seguinte exemplo mostra o pool de nós do sistema escalado com sucesso para dois nós:
```
Name       Mode    Count
---------  ------  -------
nodepool1  System  2
```
Os pools de nós do sistema devem ter pelo menos dois nós. Para clusters de produção, utilize pelo menos três nós num conjunto de nós do sistema. Para obter mais informações, consulte Sistema e grupos de nós de utilizador.

Pode obter o nome, o modo, o número de nós e o estado de aprovisionamento dos seus pools de nós utilizando o comando Get-AzAksCluster. O exemplo seguinte obtém os detalhes do conjunto de nós para o cluster chamado myAKSCluster no grupo de recursos myResourceGroup:
```
Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -ExpandProperty AgentPoolProfiles |
  Select-Object Name, Mode, Count, ProvisioningState
```
O seguinte exemplo mostra que o nodepool1 é um pool de nós do sistema com três nós:
```
Name                   : nodepool1
Mode                   : System
Count                  : 3
ProvisioningState      : Succeeded
```
Escale os nós do cluster usando o comando Set-AzAksCluster . O -NodeName parâmetro aceita o nome do pool de nós. O exemplo seguinte escala 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 seguinte exemplo mostra o pool de nós do sistema escalado com sucesso 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 num pool de nós do sistema. Para obter mais informações, consulte Sistema e grupos de nós de utilizador.

Dimensionar conjuntos de nós de utilizador para 0

Ao contrário dos pools de nós do sistema que exigem sempre nós em execução, os pools de nós utilizadores podem escalar até 0. Para saber mais sobre as diferenças entre pools de nós do sistema e de utilizador, consulte Pools de sistema e de nós de utilizador.

Importante

Para escalar um pool de nós de utilizador para 0 nós, desative o autoescalador do cluster. Para obter mais informações, consulte Desabilitar o autoscaler de cluster em um pool de nós.

CLI do Azure
Azure PowerShell

Para dimensionar um pool de nós de utilizador para 0, utilize az aks nodepool scale em vez do comando az aks scale utilizado para o 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

Pode permitir, mas não forçar, o dimensionamento automático até zero nós em conjuntos de nós de utilizador com dimensionamento automático, definindo o parâmetro --min-count do Dimensionador Automático de Clusters como 0.

Para escalar um pool de nós de utilizador para 0, use Update-AzAksNodePool em vez do Set-AzAksCluster comando usado para escalonamento geral de nós, e defina -NodeCount para 0.

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

Pode permitir, mas não forçar, o dimensionamento automático para zero nós em conjuntos de nós de utilizador com dimensionamento 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óximos passos

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.

Comentários

Esta página foi útil?

Última atualização a 2026-09-24