Tutorial: Adicionar um pool de nós do Azure Linux com OS Guard (visualização) a um cluster existente do Serviço Kubernetes do Azure (AKS)

No AKS, os nós com as mesmas configurações são agrupados em grupos de nós. Cada pool de nós contém as máquinas virtuais (VMs) que executam seus aplicativos. No tutorial anterior, você criou um cluster do Azure Linux com o OS Guard com um único pool de nós. Para atender aos diferentes requisitos de computação, armazenamento ou segurança de seus aplicativos, você pode adicionar pools de nós de usuário.

Neste tutorial, parte dois de cinco, aprende como:

Os comandos deste tutorial usam as variáveis de ambiente definidas em Tutorial 1: Cria um cluster com Azure Linux com OS Guard para AKS.

Em tutoriais posteriores, você aprenderá como migrar nós para o Azure Linux com o OS Guard e habilitar a telemetria para monitorar seus clusters.

Pré-requisitos

• No tutorial anterior, você criou e implantou um cluster do Azure Linux com o OS Guard. Se você não concluiu essas etapas e deseja acompanhar, consulte Tutorial 1: Criar um cluster com o Azure Linux com o OS Guard for AKS.
• Você precisa da versão mais recente da CLI do Azure. Use o az version comando para localizar a versão. Para atualizar para a versão mais recente, use o az upgrade comando.

Considerações e limitações do Azure Linux com OS Guard

Antes de começar, revise as seguintes considerações e limitações para o Azure Linux com o OS Guard (visualização):

• O Kubernetes versão 1.32.0 ou superior é necessário para o Azure Linux com OS Guard.
• Todas as imagens do Azure Linux com OS Guard têm o Federal Information Process Standard (FIPS) e o Trusted Launch habilitados.
• O CLI do Azure e os modelos ARM são os únicos métodos de implementação com suporte para o Azure Linux com o OS Guard no AKS em pré-visualização. O PowerShell e o Terraform não são suportados.
• As imagens Arm64 não são suportadas com Azure Linux e OS Guard no AKS na versão preview.
• NodeImage e None são os únicos canais de atualização sistema operativo (SO) suportados para Azure Linux com OS Guard em AKS. Unmanaged e SecurityPatch são incompatíveis com o Azure Linux com o OS Guard devido ao diretório /usr imutável.
• O Streaming de Artefactos não é suportado.
• O Pod Sandboxing não é suportado.
• Não há suporte para Máquinas Virtuais Confidenciais (CVMs).
• Não há suporte para máquinas virtuais (VMs) de geração 1.

Adicionar um Linux do Azure com o pool de nós do OS Guard

Adicione um pool de nós do Azure Linux com OS Guard ao cluster existente usando o az aks nodepool add comando e especifique --os-sku AzureLinuxOSGuard. Também é necessário ativar FIPS, secure boot e vtpm para usar Azure Linux com o OS Guard. O exemplo seguinte cria um pool de nós chamado osgNodePool que adiciona três nós ao cluster:

az aks nodepool add \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --name osgNodePool \
    --node-count 3 \
    --os-sku AzureLinuxOSGuard
    --node-osdisk-type Managed 
    --enable-fips-image 
    --enable-secure-boot 
    --enable-vtpm

Exemplo de saída:

{
  "agentPoolType": "VirtualMachineScaleSets",
  "count": 3,
  "name": "osgNodePool",
  "osType": "Linux",
  "provisioningState": "Succeeded",
  "resourceGroup": "testAzureLinuxOSGuardResourceGroupxxxxx",
  "type": "Microsoft.ContainerService/managedClusters/agentPools"
}

Verificar o status do pool de nós

Verifique o estado dos seus pools de nós utilizando o comando az aks nodepool list.

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

Exemplo de saída:

[
  {
    "agentPoolType": "VirtualMachineScaleSets",
    "availabilityZones": null,
    "count": 3,
    "enableAutoScaling": false,
    "enableEncryptionAtHost": false,
    "enableFips": false,
    "enableNodePublicIp": false,
    "id": "/subscriptions/REDACTED/resourcegroups/myAKSResourceGroupxxxxx/providers/Microsoft.ContainerService/managedClusters/myAKSClusterxxxxx/agentPools/npxxxxxx",
    "maxPods": 110,
    "mode": "User",
    "name": "npxxxxxx",
    "nodeImageVersion": "AzureLinuxContainerHost-2025.10.03",
    "orchestratorVersion": "1.32.6",
    "osDiskSizeGb": 128,
    "osDiskType": "Managed",
    "osSku": "AzureLinux",
    "osType": "Linux",
    "powerState": {
      "code": "Running"
    },
    "provisioningState": "Succeeded",
    "resourceGroup": "myAKSResourceGroupxxxxx",
    "type": "Microsoft.ContainerService/managedClusters/agentPools",
    "vmSize": "Standard_DS2_v2"
  },
  {
    "agentPoolType": "VirtualMachineScaleSets",
    "availabilityZones": null,
    "count": 3,
    "enableAutoScaling": false,
    "enableEncryptionAtHost": false,
    "enableFips": false,
    "enableNodePublicIp": false,
    "id": "/subscriptions/REDACTED/resourcegroups/myAKSResourceGroupxxxxx/providers/Microsoft.ContainerService/managedClusters/myAKSClusterxxxxx/agentPools/npxxxxxx",
    "maxPods": 110,
    "mode": "User",
    "name": "npxxxxxx",
    "nodeImageVersion": "AzureLinuxOSGuard-2025.10.03",
    "orchestratorVersion": "1.32.6",
    "osDiskSizeGb": 128,
    "osDiskType": "Managed",
    "osSku": "AzureLinuxOSGuard",
    "osType": "Linux",
    "powerState": {
      "code": "Running"
    },
    "provisioningState": "Succeeded",
    "resourceGroup": "myAKSResourceGroupxxxxx",
    "type": "Microsoft.ContainerService/managedClusters/agentPools",
    "vmSize": "Standard_DS2_v2"
  }
]

Passo seguinte

Neste tutorial, você adicionou um pool de nós do Azure Linux com OS Guard ao cluster existente. No próximo tutorial, você aprenderá a migrar nós existentes para o Azure Linux com o OS Guard.