Compartilhar via

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, o AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para o Azure Linux 2.0. A imagem do nó do Azure no Linux 2.0 está congelada na versão 202512.06.0. A partir de 31 de março de 2026, as imagens de nó serão removidas e não será possível escalar os grupos de nós. Migre para uma versão do Azure Linux com suporte atualizando os pools de nós para uma versão do Kubernetes com suporte ou migrando para o osSku AzureLinux3. Para obter mais informações, consulte [Desativação] Pools de nós do Azure Linux 2.0 no AKS.

Pré-requisitos

  • Você precisa da CLI do Azure versão 2.2.0 ou posterior instalada e configurada. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

  • Para implantar um modelo do ARM, é necessário ter acesso de gravação aos recursos que você implanta 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 Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/* permissões. Para ver uma lista de funções e permissões, consulte Funções interna 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 a CLI do Azure ou o 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 um nó. Pools de nós de 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 ou AzureLinux. Você não pode criar um cluster com um único pool de nós do Windows. Se você quiser executar contêineres do Windows, deverá adicionar um pool de nós do Windows ao cluster depois de 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 estar na mesma rede virtual.

  • Você não pode alterar o tamanho da VM (máquina virtual) de um pool de nós depois de criá-lo.

  • 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ó.

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 do 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 a 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 a 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 do Windows Server

Instalar a aks-preview extensão

  1. Instale a extensão aks-preview da CLI do Azure usando o comando az extension add.

    Importante

    As funcionalidades em versão preliminar do AKS estão disponíveis de forma optativa e por autoatendimento. As versões prévias são fornecidas “no estado em que se encontram” e “conforme disponíveis” e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

    az extension add --name aks-preview

  2. Atualize para a última versão da extensão usando o comando az extension update. O Windows Server 2025 requer um mínimo de 18,0,0b5.

    az extension update --name aks-preview
Registrar o sinalizador de recurso AksWindows2025Preview

  1. Registre o sinalizador de recurso AksWindows2025Preview usando o comando az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Verifique o status do registro usando o comando az feature show. Demora alguns minutos para o status mostrar Registrado.

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Quando o status reflete Registrado, atualize o registro do provedor de recursos Microsoft.ContainerService usando o comando az provider register.

    az provider register --namespace Microsoft.ContainerService
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 o sistema operacional Windows, consulte as práticas recomendadas do Windows.

    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.

Criar um Microsoft.ContainerService/managedClusters recurso

  • Crie um Microsoft.ContainerService/managedClusters recurso adicionando este 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

Instalar a aks-preview extensão

  1. Instale a extensão aks-preview da CLI do Azure usando o comando az extension add.

    Importante

    As funcionalidades em versão preliminar do AKS estão disponíveis de forma optativa e por autoatendimento. As versões prévias são fornecidas “no estado em que se encontram” e “conforme disponíveis” e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

    az extension add --name aks-preview

  2. Atualize para a última versão da extensão usando o comando az extension update. O Windows Server 2025 requer um mínimo de 18,0,0b5.

    az extension update --name aks-preview
Registrar o sinalizador de recurso AksWindows2025Preview

  1. Registre o sinalizador de recurso AksWindows2025Preview usando o comando az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Verifique o status do registro usando o comando az feature show. Demora alguns minutos para o status mostrar Registrado.

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Quando o status reflete Registrado, atualize o registro do provedor de recursos Microsoft.ContainerService usando o comando az provider register.

    az provider register --namespace Microsoft.ContainerService
Criar os pools de nós do Windows Server 2025

  • Crie vários pools de nós do 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