Partilhar via

Crie 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

A partir de 30 de novembro de 2025, Azure Kubernetes Service (AKS) já não suporta nem fornece atualizações de segurança para Azure Linux 2.0. A imagem Azure do nó 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 poderá ajustar o tamanho dos 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 osSku AzureLinux3. Para mais informações, consulte a issue de reforma do GitHub e o anúncio de retirada das atualizações do Azure. Para se manter informado sobre anúncios e atualizações, siga as Notas de Lançamento do AKS.

Pré-requisitos

  • Precisa de instalar e configurar a versão 2.2.0 ou posterior do CLI do Azure. Executar az --version para localizar a versão. Se precisares de instalar ou atualizar, vê Install CLI do Azure.

  • Para implementar um template ARM, precisas de acesso de escrita aos recursos que estás a implementar e acesso a todas as operações no tipo de recurso Microsoft.Resources/deployments. Por exemplo, para implementar uma máquina virtual (VM), precisa de permissões Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/*. Para uma lista de funções e permissões, veja Azure funções incorporadas.

  • 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 implementar o cluster usando um template ARM, pode usar o CLI do Azure ou o Azure PowerShell para se ligar ao cluster e implementar a aplicação 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 se pode criar um cluster com um único pool de nós do Windows. Se pretender executar containers Windows, deve adicionar um pool de nós Windows ao cluster depois de o criar 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 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 Linux, o comprimento deve estar entre 1 e 12 caracteres.
    • Para pools de nós do Windows, o comprimento deve ser 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 Azure usando o comando az group create.

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

Crie 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 grupo de nós pode ter um tipo de SO Linux com um SKU de Ubuntu ou AzureLinux, ou um tipo de SO 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. Instala a extensão aks-preview CLI do Azure usando o comando az extension add.

    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. Windows Server 2025 exige 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 estado refletir Registado, atualize o registo do Microsoft. ContainerService fornecedor de recursos 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 seguinte cria um pool de nós Windows com o SKU Windows2025 OS que executa três nós.

    Para mais informações sobre o sistema operativo Windows, consulte as melhores práticas 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 recurso Microsoft.ContainerService/managedClusters

  • Crie um recurso Microsoft.ContainerService/managedClusters adicionando this 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 grupo de nós pode ter um tipo de SO Linux com um SKU de Ubuntu ou AzureLinux, ou um tipo de SO 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. Instala a extensão aks-preview CLI do Azure usando o comando az extension add.

    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. Windows Server 2025 exige 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 estado refletir Registado, atualize o registo do Microsoft. ContainerService fornecedor de recursos usando o comando az provider register.

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

  • Crie múltiplos pools de nós Windows no seu cluster AKS fazendo as seguintes modificações ao 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