Criar pools de nós para um cluster no Serviço de Kubernetes do Azure (AKS)

Este artigo mostra como criar um ou mais pools de nós em um cluster do AKS.

Observação

Esse recurso permite mais controle sobre a criação e o gerenciamento de vários pools de nós e exige comandos separados para operações CRUD (criação/atualização/exclusão). Antes, as operações de cluster por meio de az aks create ou az aks update usavam a API managedCluster e eram as únicas opções para alterar o plano de controle e um único pool de nós. Esse recurso expõe um conjunto de operações separado para pools de agentes por meio da API agentPool e requer o uso do comando az aks nodepool definido para executar operações em um pool de nós individual.

Importante

A partir de 30 de novembro de 2025, AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para Azure Linux 2.0. A imagem do nó Azure Linux 2.0 está congelada na versão 202512.06.0. A partir de 31 de março de 2026, as imagens dos nós serão removidas e você não poderá dimensionar os pools de nós. Migre para uma versão do Linux Azure com suporte atualizando seus pools de nós para uma versão do Kubernetes com suporte ou migrando para osSku AzureLinux3. Para obter mais informações, consulte Problema de desativação do GitHub e o comunicado de desativação das Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de versão do AKS.

Pré-requisitos

  • Você precisa CLI do Azure versão 2.87.0 ou posterior instalada e configurada. Execute az --version para encontrar a versão. Se precisar instalar ou atualizar, consulte Instalar CLI do Azure.
  • Para implantar um modelo ARM, você precisa de acesso de gravação aos recursos que está implantando e acesso a todas as operações no tipo de recurso Microsoft.Resources/deployments. Por exemplo, para implantar uma VM (máquina virtual), você precisa de permissões Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/*. Para obter uma lista de funções e permissões, consulte funções internas do Azure.
  • Examine os seguintes requisitos para cada parâmetro:
    • osType: o tipo de sistema operacional. O padrão é Linux.
    • osSKU: especifica o SKU do sistema operacional usado pelo pool de agentes.
    • count: número de agentes (VMs) para hospedar contêineres do Docker. Os valores permitidos devem estar no intervalo de 0 a 1000 (inclusive) para os pools de usuários e no intervalo de 1 a 1000 (inclusive) para os pools de sistema. O valor padrão é 1.
  • Depois de implantar o cluster usando um modelo do ARM, você pode usar CLI do Azure ou Azure PowerShell para se conectar ao cluster e implantar o aplicativo de exemplo.

Limitações

As seguintes limitações se aplicam quando você cria clusters do AKS com suporte a vários pools de nós:

  • É possível excluir os pools de nós do sistema se você tiver outro pool de nós do sistema para assumir seu lugar no cluster do AKS. Caso contrário, você não poderá excluir o pool de nós do sistema.
  • Os pools do sistema devem conter pelo menos dois nós e os pools de nós do usuário podem conter zero ou mais nós.
  • Se você criar um cluster com um único pool de nós, o tipo de sistema operacional deverá ser Linux. O SKU do sistema operacional pode ser qualquer variação do Linux, como Ubuntu, AzureContainerLinuxou AzureLinux. Você não pode criar um cluster com um único pool de nós Windows. Se você quiser executar contêineres do Windows, deverá adicionar um pool de nós do Windows ao cluster após criá-lo com um pool de nós do sistema Linux.
  • O cluster do AKS deve usar o balanceador de carga do SKU Padrão para usar vários pools de nós. Não há suporte para esse recurso nos balanceadores de carga do SKU Básico.
  • O cluster do AKS deve usar Conjuntos de Dimensionamento de Máquinas Virtuais para os nós.
  • O nome de um pool de nós só pode conter caracteres alfanuméricos minúsculos e deve começar com uma letra minúscula.
    • Para pools de nós do Linux, o comprimento deve ter entre 1 e 12 caracteres.
    • Para pools de nós do Windows, o comprimento deve ter entre 1 e 6 caracteres.
  • Todos os pools de nós devem residir na mesma VNet (rede virtual).
  • Você não pode alterar o tamanho da VM de um pool de nós depois de criá-la.
  • Quando você cria vários pools de nós no momento da criação do cluster, as versões do Kubernetes para os pools de nós devem corresponder à versão definida pelo plano de controle. Você pode fazer atualizações depois de provisionar o cluster utilizando as operações de pool por nó.

Importante

Se você estiver usando Azure ACL (Container Linux) no AKS, examine as seguintes considerações e limitações:

Criar pools de nós especializados

Para saber como criar pools de nós especializados, confira os seguintes artigos:

Definir variáveis de ambiente

Defina as variáveis de ambiente a seguir no shell para simplificar os comandos neste artigo. Você pode alterar os valores para seus nomes preferenciais.

export RESOURCE_GROUP_NAME="my-aks-rg"
export LOCATION="eastus"
export CLUSTER_NAME="my-aks-cluster"
export NODE_POOL_NAME="mynodepool"

Criar um grupo de recursos

Crie um grupo de recursos Azure usando o comando az group create.

az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

Criar um cluster do AKS com um único pool de nós usando o CLI do Azure

Se você quiser apenas um pool de nós no cluster do AKS, poderá agendar os pods de aplicativo nos pools de nós do sistema. Se for executado um único pool de nós do sistema para o cluster do AKS em um ambiente de produção, é recomendável usar pelo menos três nós para o pool de nós. Se um nó ficar inativo, a redundância será comprometida. Você pode atenuar esse risco tendo mais nós do pool de nós do sistema.

  1. Crie um cluster com um único pool de nós do Ubuntu usando o az aks create comando. Esta etapa especifica dois nós no pool de nós único.

    az aks create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $CLUSTER_NAME \
    --vm-set-type VirtualMachineScaleSets \
    --node-count 2 \
    --os-sku Ubuntu \
    --location $LOCATION \
    --load-balancer-sku standard \
    --generate-ssh-keys

    São necessários alguns minutos para criar o cluster.

  2. Quando o cluster estiver pronto, obtenha as credenciais do cluster usando o comando az aks get-credentials.

    az aks get-credentials --resource-group $RESOURCE_GROUP_NAME --name $CLUSTER_NAME

Adicionar um segundo pool de nós usando o CLI do Azure

O cluster criado na seção anterior tem um único pool de nós. Nesta seção, adicionamos um segundo pool de nós ao cluster. Esse segundo pool de nós pode ter um tipo de sistema operacional Linux com um SKU do sistema operacional Ubuntu ou AzureLinux, ou um tipo de sistema operacional Windows.

Observação

Se você quiser adicionar um pool de nós que usa Discos de SO Efêmeros ao cluster do seu AKS, você pode definir o sinalizador --node-osdisk-type como Ephemeral ao executar o comando az aks nodepool add.

Com o sistema operacional Efêmero, você pode implantar VMs e imagens de instância até o tamanho do cache da VM. A configuração de disco do sistema operacional do nó padrão no AKS usa 128 GB, o que significa que você precisa de um tamanho de VM com um cache maior que 128 GB. O padrão Standard_DS2_v2 tem um tamanho de cache de 86 GB, que não é grande o suficiente. A Standard_DS3_v2 SKU da VM tem um tamanho de cache de 172 GB, que é grande o suficiente. Você também pode reduzir o tamanho padrão do disco do sistema operacional usando --node-osdisk-size, mas tenha em mente que o tamanho mínimo para imagens do AKS é de 30 GB.

Se você quiser criar pools de nós com discos do sistema operacional anexados à rede, poderá definir o sinalizador --node-osdisk-type para Managed ao executar o comando az aks nodepool add.

Adicionar um pool de nós do Linux

Crie um novo pool de nós usando o comando az aks nodepool add. O exemplo a seguir cria um pool Linux de nós com o SKU do SO Ubuntu que executa três nós. Se você não especificar um SKU do sistema operacional, o AKS usará como padrão Ubuntu.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Linux \
    --os-sku Ubuntu \
    --node-count 3

Leva alguns minutos para criar o pool de nós.

Adicionar um pool de nós Windows Server

Crie o pool de nós do Windows Server 2025

Crie um novo pool de nós usando o comando az aks nodepool add. O exemplo a seguir cria um pool Windows de nós com o SKU do SO Windows2025 que executa três nós.

Para obter mais informações sobre Windows sistema operacional, consulte Windows práticas recomendadas.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Windows \
    --os-sku Windows2025 \
    --node-count 3

Verificar o status dos pools de nós

Verifique o status dos pools de nós usando o comando az aks nodepool list e especifique o grupo de recursos e o nome do cluster.

az aks nodepool list --resource-group $RESOURCE_GROUP_NAME --cluster-name $CLUSTER_NAME

Criar um cluster do AKS com um único pool de nós usando um modelo do ARM

Se você quiser apenas um pool de nós no cluster do AKS, poderá agendar os pods de aplicativo nos pools de nós do sistema. Se for executado um único pool de nós do sistema para o cluster do AKS em um ambiente de produção, é recomendável usar pelo menos três nós para o pool de nós. Se um nó ficar inativo, a redundância será comprometida. Você pode atenuar esse risco tendo mais nós do pool de nós do sistema.

Microsoft.ContainerService/managedClusters Criar um Recurso

Crie um recurso de Microsoft.ContainerService/managedClusters adicionando this JSON ao seu modelo.

  • Crie um único pool de nós do Ubuntu no cluster do AKS fazendo as seguintes modificações no modelo do ARM:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "1",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Adicionar um segundo pool de nós usando um modelo do ARM

O cluster criado na seção anterior tem um único pool de nós. Nesta seção, adicionamos um segundo pool de nós ao cluster. Esse segundo pool de nós pode ter um tipo de sistema operacional Linux com um SKU do sistema operacional Ubuntu ou AzureLinux, ou um tipo de sistema operacional Windows.

Adicionar pools de nós do Linux

  • Crie vários pools de nós do Ubuntu no cluster do AKS fazendo as seguintes modificações no modelo do ARM:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Adicionar grupos de nós do Windows Server

Crie os conjuntos de nós Windows Server 2025

  • Crie vários pools de nós Windows no cluster do AKS fazendo as seguintes modificações no modelo do ARM:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "windows2025",
        "osType": "windows"
     } 
     ],
}

Implantar seu modelo do ARM

Definir taints, rótulos ou tags para um pool de nós

Ao criar um pool de nós, você pode adicionar taints, rótulos ou marcas a ele. Quando você adiciona um taint, um rótulo ou uma marca, todos os nós nesse pool de nós também recebem esse taint, esse rótulo ou essa marca. Recomendamos aplicar essas propriedades a um conjunto de nós inteiro, em vez de nós individuais. Dessa forma, você pode gerenciar facilmente as propriedades de todos os nós no pool de nós, atualizando as propriedades do pool em vez de atualizar cada nó individualmente.

Para obter instruções específicas sobre como definir taints, rótulos ou tags para um pool de nós, utilize os seguintes recursos:

Próximas etapas

Neste artigo, você aprendeu a criar um cluster do AKS com um único pool de nós e adicionar pools de nós adicionais ao cluster. Para saber mais sobre como gerenciar seus pools de nós, consulte os seguintes artigos:

  • Last updated on