Tutorial: Como migrar nodos para o Linux Azure

Implantar e explorar

Neste tutorial, parte três de cinco, você migra seus nós existentes para o Azure Linux. Você pode migrar seus nós existentes para o Azure Linux usando um dos seguintes métodos:

Remova pools de nós existentes e adicione novos pools de nós do Azure Linux.
Migração de SKU do SO no local.

Se você não tiver nenhum nó existente para migrar para o Azure Linux, pule para o próximo tutorial. Em tutoriais posteriores, você aprenderá a habilitar a telemetria e o monitoramento em seus clusters e atualizar os nós do Azure Linux.

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 Aposentadoria: pools de nós do Azure Linux 2.0 no AKS.

Pré-requisitos

Em tutoriais anteriores, você criou e implantou um host de contêiner Linux do Azure para cluster AKS. Para concluir este tutorial, você precisa adicionar um pool de nós do Azure Linux ao cluster existente. Se você ainda não fez essa etapa e gostaria de acompanhar, comece com o Tutorial 2: Adicionar um pool de nós do Azure Linux ao seu cluster AKS existente.

Observação

Ao adicionar um novo pool de nós do Azure Linux, você precisa adicionar pelo menos um como --mode System. Caso contrário, o AKS não permitirá que você exclua seu pool de nós existente.
Você precisa da versão mais recente da CLI do Azure. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, consulte Install Azure CLI.

Adicionar pools de nós do Azure Linux e remover pools de nós existentes

Adicione um novo pool de nós do Azure Linux usando o az aks nodepool add comando. Este comando adiciona um novo pool de nós ao cluster com o sinalizador --mode System, tornando-o um pool de nós do sistema. Os grupos de nós do sistema são necessários para os clusters Linux do Azure.

# Declare environment variables with a random suffix for uniqueness
export RANDOM_SUFFIX=$(openssl rand -hex 3)
export NODE_POOL_NAME="np$RANDOM_SUFFIX"
az aks nodepool add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name $NODE_POOL_NAME --mode System --os-sku AzureLinux

Resultados:

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/nodePools/systempool",
  "name": "systempool",
  "provisioningState": "Succeeded"
}

Remova os nós existentes usando o az aks nodepool delete comando.

Migração de SKU do SO no local

Agora você pode migrar seus pools de nós existentes do Ubuntu para o Azure Linux alterando a SKU do sistema operacional do pool de nós, que rola o cluster através do processo de atualização de imagem de nó padrão. Esse novo recurso não requer a criação de novos pools de nós.

Limitações

Há várias configurações que podem bloquear a solicitação de migração de SKU do sistema operacional. Para garantir uma migração bem-sucedida, revise as seguintes diretrizes e limitações:

O recurso de migração de SKU do sistema operacional não está disponível por meio do PowerShell ou do portal do Azure.
O recurso de migração de SKU do sistema operacional não consegue renomear grupos de nós existentes.
Ubuntu, Azure Linux e Azure Linux com OS Guard são os únicos destinos de migração de SKU do sistema operacional Linux suportados.
A inicialização confiável é exigida por padrão para o Azure Linux com OS Guard, os clientes precisam ter a inicialização confiável habilitada para poder migrar para o Azure Linux com o OS Guard. Como a Inicialização Confiável não pode ser habilitada em pools de nós existentes, isso pode exigir a criação de um novo pool de nós.
Os clientes que usam apenas tamanhos de vm Gen 1 não poderão migrar para o Azure Linux com o OS Guard, pois não há nenhuma imagem Gen 1 suportada. Eles precisarão criar novos pools de nós com um tamanho de vm que suporte a geração 2.
Um SKU do sistema operacional Ubuntu com UseGPUDedicatedVHD ativado não pode executar uma migração de SKU do sistema operacional.
Um SKU do sistema operacional Ubuntu com o CVM 20.04 habilitado não pode executar uma migração de SKU do sistema operacional.
Os pools de nós com Kata ativado não podem executar uma migração de SKU do sistema operacional.
A migração de SKU do sistema operacional Windows não é suportada.
A migração de SKU do SO do Mariner para o Azure Linux é suportada, mas a reversão para o Mariner não é suportada.

Pré-requisitos

Um cluster AKS existente com pelo menos um pool de nós do Ubuntu.
Recomendamos que você garanta que suas cargas de trabalho sejam configuradas e executadas com êxito no host de contêiner do Azure Linux antes de tentar usar o recurso de migração SKU do sistema operacional implantando um cluster Linux do Azure no dev/prod e verificando se o serviço permanece íntegro.
Verifique se o recurso de migração está funcionando para você em teste/desenvolvimento antes de usar o processo em um cluster de produção.
Certifique-se de que os seus pods tenham um Pod Disruption Budget suficiente para permitir que o Azure Kubernetes Service mova pods entre VMs durante a atualização.
Você precisa da CLI do Azure versão 2.61.0 ou superior. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, consulte Install Azure CLI.
Se estiveres a usar o Terraform, deves ter a v3.111.0 ou uma versão superior do módulo AzureRM para Terraform.

Migre o SKU do sistema operacional do seu pool de nós do Ubuntu

Migre a SKU do sistema operacional do seu pool de nós para o Azure Linux usando o az aks nodepool update comando. Este comando atualiza o SKU do sistema operacional para seu pool de nós do Ubuntu para o Azure Linux. A alteração do SKU do sistema operacional aciona uma operação de atualização imediata, que leva vários minutos para ser concluída.

az aks nodepool update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name $NODE_POOL_NAME --os-sku AzureLinux

Resultados:

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/nodePools/nodepool1",
  "name": "nodepool1",
  "osSku": "AzureLinux",
  "provisioningState": "Succeeded"
}

Observação

Se você tiver problemas durante a migração do SKU do sistema operacional, poderá reverter para o SKU do sistema operacional anterior.

Modelos ARM de exemplo

0base.json

 {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2023-07-01",
      "name": "akstestcluster",
      "location": "[resourceGroup().location]",
      "tags": {
        "displayname": "Demo of AKS Nodepool Migration"
      },
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "enableRBAC": true,
        "dnsPrefix": "testcluster",
        "agentPoolProfiles": [
          {
            "name": "testnp",
            "count": 3,
            "vmSize": "Standard_D4a_v4",
            "osType": "Linux",
            "osSku": "Ubuntu",
            "mode": "System"
          }
        ]
      }
    }
  ]
}

1mcupdate.json

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2023-07-01",
      "name": "akstestcluster",
      "location": "[resourceGroup().location]",
      "tags": {
        "displayname": "Demo of AKS Nodepool Migration"
      },
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "enableRBAC": true,
        "dnsPrefix": "testcluster",
        "agentPoolProfiles": [
          {
            "name": "testnp",
            "osType": "Linux",
            "osSku": "AzureLinux",
            "mode": "System"
          }
        ]
      }
    }
  ]
}

2apupdate.json

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "apiVersion": "2023-07-01",
      "type": "Microsoft.ContainerService/managedClusters/agentPools",
      "name": "akstestcluster/testnp",
      "location": "[resourceGroup().location]",
      "properties": {
        "osType": "Linux",
        "osSku": "Ubuntu",
        "mode": "System"
      }
    }
  ]
}

Implantar um cluster de teste

Crie um grupo de recursos para o cluster de teste usando o az group create comando.
```
az group create --name testRG --location eastus
```
Implante um cluster SKU do Ubuntu OS de linha de base com três nós usando o az deployment group create comando e o modelo ARM de exemplo0base.json.
```
az deployment group create --resource-group testRG --template-file 0base.json
```
Migre a SKU do SO do seu pool de nós para Azure Linux usando o comando az deployment group create.
```
az deployment group create --resource-group testRG --template-file 1mcupdate.json
```
Migre o SKU do sistema operacional do seu pool de nós de volta para o Ubuntu usando o comando az deployment group create.
```
az deployment group create --resource-group testRG --template-file 2apupdate.json
```

Exemplo de modelo Terraform

Confirme se seu providers.tf arquivo está atualizado para pegar a versão necessária do provedor do Azure.

providers.tf

terraform {
      required_version = ">=1.0"

      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~>3.111.0"
        }
        random = {
          source  = "hashicorp/random"
          version = "~>3.0"
        }
      }
    }

    provider "azurerm" {
      features {}
    }

Para maior brevidade, apenas o trecho do modelo Terraform que é de interesse é exibido abaixo. Nesta configuração inicial, um cluster AKS com um nodepool de os_sku com Ubuntu é implantado.

base.tf

resource "azurerm_kubernetes_cluster" "k8s" {
  location            = azurerm_resource_group.rg.location
  name                = var.cluster_name
  resource_group_name = azurerm_resource_group.rg.name
  dns_prefix          = var.dns_prefix
  tags                = {
    Environment = "Development"
  }

  default_node_pool {
    name       = "azurelinuxpool"
    vm_size    = "Standard_D2_v2"
    node_count = var.agent_count
    os_sku = "Ubuntu"
  }
  linux_profile {
    admin_username = "azurelinux"

    ssh_key {
      key_data = file(var.ssh_public_key)
    }
  }
  network_profile {
    network_plugin    = "kubenet"
    load_balancer_sku = "standard"
  }
  service_principal {
    client_id     = var.aks_service_principal_app_id
    client_secret = var.aks_service_principal_client_secret
  }
}

Para executar uma migração de SKU do sistema operativo no local, basta substituir o os_sku por AzureLinux e reaplicar o plano Terraform.

update.tf

resource "azurerm_kubernetes_cluster" "k8s" {
  location            = azurerm_resource_group.rg.location
  name                = var.cluster_name
  resource_group_name = azurerm_resource_group.rg.name
  dns_prefix          = var.dns_prefix
  tags                = {
    Environment = "Development"
  }

  default_node_pool {
    name       = "azurelinuxpool"
    vm_size    = "Standard_D2_v2"
    node_count = var.agent_count
    os_sku = "AzureLinux"
  }
  linux_profile {
    admin_username = "azurelinux"

    ssh_key {
      key_data = file(var.ssh_public_key)
    }
  }
  network_profile {
    network_plugin    = "kubenet"
    load_balancer_sku = "standard"
  }
  service_principal {
    client_id     = var.aks_service_principal_app_id
    client_secret = var.aks_service_principal_client_secret
  }
}

Verificar a migração do SKU do Sistema Operativo

Quando a migração estiver concluída em seus clusters de teste, você deve verificar o seguinte para garantir uma migração bem-sucedida:

Se o destino da migração for o Azure Linux, execute o kubectl get nodes -o wide comando. A saída deve aparecer Microsoft Azure Linux 3.0 como sua imagem do sistema operacional e .azl3 no final da sua versão do kernel.
Execute o comando kubectl get pods -o wide -A para verificar se todos os pods e daemonsets estão a funcionar no novo pool de nós.
Execute o kubectl get nodes --show-labels comando para verificar se todos os rótulos de nó no grupo de nós atualizado correspondem ao que é esperado.

Sugestão

Recomendamos monitorar a integridade do serviço por algumas semanas antes de migrar os clusters de produção.

Execute a migração de SKU do sistema operacional em seus clusters de produção

Atualize os seus modelos existentes para configurar OSSKU=AzureLinux. Em modelos ARM, você usa "OSSKU": "AzureLinux" na agentPoolProfile seção . No Bicep, você usa osSku: "AzureLinux" na seção agentPoolProfile. Por fim, para Terraform, você usa os_sku = "AzureLinux" na default_node_pool seção . Certifique-se de que o seu apiVersion está definido para 2023-07-01 ou mais tarde.
Reimplante seu modelo ARM, Bíceps ou Terraform para o cluster para aplicar a nova OSSKU configuração. Durante esta implantação, o cluster comporta-se como se estivesse a fazer uma atualização de imagem de nó. O cluster aumenta a capacidade e, em seguida, reinicia os nós existentes, um a um, na imagem AKS mais recente do seu novo SKU do SO.

Reversão

Se você tiver problemas durante a migração do SKU do sistema operacional, poderá reverter para o SKU do sistema operacional anterior. Para fazer isso, precisa-se alterar o campo SKU do sistema operativo no seu modelo e reenviar a implementação, o que inicia outra operação de atualização e restaura o conjunto de nós para o SKU do sistema operativo anterior.

Observação

A migração do OS SKU não suporta a reversão para o OS SKU Mariner.

Volte para o SKU do sistema operacional anterior usando o comando az aks nodepool update. Este comando atualiza a SKU do sistema operativo do seu pool de nós de Azure Linux para Ubuntu.

Próximos passos

Neste tutorial, você migrou nós existentes para o Azure Linux usando um dos seguintes métodos:

Remova pools de nós existentes e adicione novos pools de nós do Azure Linux.
Migração de SKU do SO no local.

No próximo tutorial, você aprenderá a habilitar a telemetria para monitorar seus clusters.

Habilite a telemetria e o monitoramento

Feedback

Esta página foi útil?

Last updated on 2025-09-11

Partilhar via

Tutorial: Como migrar nodos para o Linux Azure

Pré-requisitos

Adicionar pools de nós do Azure Linux e remover pools de nós existentes

Migração de SKU do SO no local

Limitações

Pré-requisitos

Migre o SKU do sistema operacional do seu pool de nós do Ubuntu

Verificar a migração do SKU do Sistema Operativo

Execute a migração de SKU do sistema operacional em seus clusters de produção

Reversão

Próximos passos

Feedback

Recursos adicionais