Partilhar via

Criar pools de nós para um cluster no Azure Kubernetes Service (AKS)

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

Observação

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

Importante

Desde 30 de novembro de 2025, o Azure Kubernetes Service (AKS) já não suporta nem fornece atualizações de segurança para o Azure Linux 2.0. A imagem da máquina virtual do 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 não conseguirá escalar os seus pools de nós. Migre para uma versão Azure Linux suportada atualizando os seus pools de nós para uma versão Kubernetes suportada 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. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, consulte Install Azure CLI.

  • Para implantar um modelo ARM, necessita-se de acesso de escrita nos recursos que está a implantar e acesso a todas as operações no tipo de recurso Microsoft.Resources/deployments. Por exemplo, para implantar uma máquina virtual (VM), precisas de Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/* permissões. Para obter uma lista de funções e permissões, veja Funções incorporadas do Azure.

  • Analise os seguintes requisitos para cada parâmetro:

    • osTYPE: O tipo de sistema operacional. O padrão é Linux.
    • osSKU: Especifica a SKU do sistema operacional usada 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 grupos de usuários e no intervalo de 1 a 1000 (inclusive) para pools de sistema. O valor padrão é 1.

  • Depois de implantar o cluster usando um modelo 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 limitações a seguir se aplicam quando você cria clusters AKS que suportam vários pools de nós:

  • Você pode excluir o pool de nós do sistema se tiver outro pool de nós do sistema para ocupar seu lugar no cluster AKS. Caso contrário, não será possível excluir o pool de nós do sistema.

  • Os pools do sistema devem conter pelo menos um nó. Os 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 OS SKU pode ser qualquer variação do Linux, como Ubuntu ou AzureLinux. Não é possível criar um cluster com um único pool de nós do Windows. Se quiser executar contêineres do Windows, você deve 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 AKS deve usar o balanceador de carga SKU padrão para usar vários pools de nós. Esse recurso não é suportado com balanceadores de carga SKU básicos.

  • O cluster AKS deve usar Conjuntos de Escala de Máquina Virtual 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 Linux, o comprimento deve estar entre 1 e 12 caracteres.
    • Para pools de nós do Windows, o comprimento deve estar entre 1 e 6 caracteres.

  • Todos os pools de nós devem residir na mesma rede virtual.

  • Não podes alterar o tamanho da máquina virtual (VM) de um pool de nós depois de o criares.

  • 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 para o plano de controle. Você pode fazer atualizações após o provisionamento do cluster usando operações por pool de nós.

Criar pools de nós especializados

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

Definir variáveis de ambiente

  • Defina as seguintes variáveis de ambiente em seu shell para simplificar os comandos neste artigo. Você pode alterar os valores para seus nomes preferidos.

    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 az group create comando.

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

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

Se você quiser apenas um pool de nós em seu cluster AKS, poderá agendar pods de aplicativos em pools de nós do sistema. Se você executar um único pool de nós do sistema para seu cluster AKS em um ambiente de produção, recomendamos usar pelo menos três nós para o pool de nós. Se um nó falhar, a redundância fica prejudicada. Você pode reduzir esse risco aumentando o número de nós no cluster 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 únicos.

    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

    A criação do cluster demora alguns minutos.

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

    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. Este segundo pool de nós pode ter um tipo de sistema operativo de Linux com uma SKU de Ubuntu ou AzureLinux, ou um tipo de sistema operativo de Windows.

Observação

Se quiseres adicionar um pool de nós que usa discos do sistema operativo efémero ao cluster AKS, podes definir o sinalizador --node-osdisk-type para Ephemeral ao executar o comando az aks nodepool add.

Com o Ephemeral OS, pode-se implantar VMs e imagens de instância até ao limite do cache da VM. A configuração de disco do SO do nó padrão no AKS usa 128 GB, o que significa que você precisa de um tamanho de VM que tenha 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. O Standard_DS3_v2 VM SKU 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 lembre-se de que o tamanho mínimo para imagens AKS é de 30 GB.

Se quiser criar pools de nós com discos de sistema operativo ligados à rede, pode definir o sinalizador --node-osdisk-type para Managed ao executar o comando az aks nodepool add.

Adicionar um pool de nós Linux

  • Crie um novo pool de nós usando o az aks nodepool add comando. O exemplo a seguir cria um Linux conjunto de nós com a SKU do Ubuntu sistema operativo que executa três nós. Se você não especificar um OS SKU, AKS assume 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 aks-preview extensão da CLI do Azure usando o az extension add comando.

    Importante

    Os recursos de pré-visualização do AKS estão disponíveis numa base de autosserviço e adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de teste do AKS são parcialmente cobertas pelo suporte ao cliente numa base de melhor esforço. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

    az extension add --name aks-preview

  2. Atualize para a versão mais recente da extensão usando o az extension update comando. O Windows Server 2025 requer um mínimo de 18.0.0b5.

    az extension update --name aks-preview
Registar o sinalizador de funcionalidade AksWindows2025Preview

  1. Registe o sinalizador de funcionalidade AksWindows2025Preview com o comando az feature register.

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

  2. Verifique o status do registro usando o az feature show comando. Leva alguns minutos para que o status mostre Registrado.

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

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

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

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

    Para obter mais informações sobre o sistema operacional Windows, consulte 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 estado 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 AKS com um único pool de nós usando um modelo ARM

Se você quiser apenas um pool de nós em seu cluster AKS, poderá agendar pods de aplicativos em pools de nós do sistema. Se você executar um único pool de nós do sistema para seu cluster AKS em um ambiente de produção, recomendamos usar pelo menos três nós para o pool de nós. Se um nó falhar, a redundância fica prejudicada. Você pode reduzir esse risco aumentando o número de nós no cluster 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 em seu cluster AKS fazendo as seguintes modificações no seu modelo ARM:

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

Adicionar um segundo pool de nós usando um modelo 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. Este segundo pool de nós pode ter um tipo de sistema operativo de Linux com uma SKU de Ubuntu ou AzureLinux, ou um tipo de sistema operativo de Windows.

Adicionar pools de nós Linux

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

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

Adicionar pools de nós do Windows Server

Instalar a aks-preview extensão

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

    Importante

    Os recursos de pré-visualização do AKS estão disponíveis numa base de autosserviço e adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de teste do AKS são parcialmente cobertas pelo suporte ao cliente numa base de melhor esforço. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

    az extension add --name aks-preview

  2. Atualize para a versão mais recente da extensão usando o az extension update comando. O Windows Server 2025 requer um mínimo de 18.0.0b5.

    az extension update --name aks-preview
Registar o sinalizador de funcionalidade AksWindows2025Preview

  1. Registe o sinalizador de funcionalidade AksWindows2025Preview com o comando az feature register.

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

  2. Verifique o status do registro usando o az feature show comando. Leva alguns minutos para que o status mostre Registrado.

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

  3. Quando o status refletir 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 em seu cluster AKS fazendo as seguintes modificações no seu modelo ARM:

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

Implantar seu modelo ARM

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

Ao criar um pool de nós, você pode adicionar manchas, rótulos ou tags a ele. Quando você adiciona uma mancha, rótulo ou marca, todos os nós dentro desse pool de nós também obtêm essa mancha, rótulo ou marca. Recomendamos a aplicação destas propriedades a um conjunto inteiro de nós em vez de a nós individuais. Desta forma, pode gerir facilmente as propriedades de todos os nós no conjunto de nós, atualizando as propriedades do conjunto em vez de atualizar cada nó individualmente.

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

Próximos passos

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

  • Last updated on