Tutorial: Migrar nós para o Linux do Azure

Implantar e explorar

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

• Remova os pools de nós existentes e adicione novos pools de nós do Linux do Azure.
• Migração in-loco do SKU do sistema operacional.

Se você não tiver nenhum nó existente para migrar para o Linux do Azure, vá 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 Linux do Azure.

Importante

A partir de 30 de novembro de 2025, o AKS não oferecerá mais suporte ou fornecerá atualizações de segurança para o Azure Linux 2.0. A partir de 31 de março de 2026, as imagens dos nós serão removidas e, consequentemente, você não poderá dimensionar os pools 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 osSku AzureLinux3. Para obter mais informações, consulte [Desativação] Pools de nós do Azure Linux 2.0 no AKS.

Pré-requisitos

• Nos tutoriais anteriores, você criou e implantou um Host de Contêiner do Linux do Azure para clusters do AKS. Para concluir este tutorial, você precisa adicionar um pool de nós do Linux do Azure ao cluster existente. Se você ainda não tiver feito isso, comece com o Tutorial 2: Adicionar um pool de nós do Linux do Azure ao cluster existente do AKS.

  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 o pool de nós existente.

• Você precisa instalar a versão mais recente da CLI do Azure. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

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

1. Adicione um novo pool de nós do Linux do Azure usando o comando az aks nodepool add. Esse comando adiciona um novo pool de nós ao cluster com o sinalizador --mode System, o que o torna um pool de nós do sistema. Os pools de nós do sistema são necessários para clusters do 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"
}

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

Migração in-loco do SKU do sistema operacional

Agora você pode migrar seus pools de nós do Ubuntu existentes para o Linux do Azure alterando o SKU do sistema operacional do pool de nós, o que aciona o processo padrão de atualização da imagem do nó no cluster. 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, examine 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 pode renomear pools de nós existentes.
• O Ubuntu, o Azure Linux e o Linux do Azure com o OS Guard são os únicos destinos de migração de SKU do sistema operacional Linux com suporte.
• O início confiável é exigido por padrão para o Linux do Azure com o OS Guard, os clientes precisam ter a inicialização confiável habilitada para poder migrar para o Azure Linux com o OS Guard. Como o Início Confiável não pode ser habilitado em pools de nós existentes, isso pode exigir a criação de um novo pool de nós.
• Os clientes que usam tamanhos de VM somente Geração 1 não poderão migrar para o Azure Linux com proteção de SO, pois não há nenhuma imagem da Geração 1 com suporte. Eles precisarão criar novos pools de nós com um tamanho de VM que dê suporte à geração 2.
• Um SKU do sistema operacional Ubuntu com UseGPUDedicatedVHD habilitado não pode executar uma migração de SKU do sistema operacional.
• Um SKU do sistema operacional Ubuntu com CVM 20.04 habilitado não pode executar uma migração de SKU do sistema operacional.
• Os pools de nós com o Kata habilitado não podem executar uma migração de SKU do sistema operacional.
• Não há suporte para a migração do SKU do sistema operacional Windows.
• Há suporte para a migração de SKU do SO do Mariner para o Linux do Azure, mas não há suporte para a reversão para o Mariner.

Pré-requisitos

• Um cluster do AKS existente com pelo menos um pool de nós do Ubuntu.
• É recomendável garantir que suas cargas de trabalho configurem e executem com sucesso no host de contêiner do Linux do Azure antes de tentar usar o recurso de migração de SKU do sistema operacional implantando um cluster do Linux do Azure no desenvolvimento/produção e verificando se o serviço permanece íntegro.
• Verifique se o recurso de migração está funcionando para você no teste/desenvolvimento antes de usar o processo em um cluster de produção.
• Verifique se os pods têm Orçamento de Interrupção de Pod suficiente para permitir que o AKS mova os pods entre as VMs durante a atualização.
• Você precisa da versão 2.61.0 ou posterior da CLI do Azure. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.
• Se você estiver usando o Terraform, deverá ter v3.111.0 ou superior do módulo Terraform do AzureRM.

CLI do Azure

Migrar o SKU do sistema operacional do pool de nós do Ubuntu

• Migre o SKU do sistema operacional do pool de nós para o Linux do Azure usando o comando az aks nodepool update. Esse comando atualiza o SKU do sistema operacional para o pool de nós do Ubuntu para o Linux do Azure. A alteração do SKU do sistema operacional dispara 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.

Modelo de ARM

Modelos do 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

1. Crie um grupo de recursos para o cluster de teste usando o comando az group create.

   az group create --name testRG --location eastus
   

2. Implante um cluster de SKU do sistema operacional Ubuntu de linha de base com três nós usando o comando az deployment group create e o modelo do ARM de exemplo 0base.json.

   az deployment group create --resource-group testRG --template-file 0base.json
   

3. Migre o SKU do sistema operacional do pool de nós do sistema para o Linux do Azure usando o comando az deployment group create.

   az deployment group create --resource-group testRG --template-file 1mcupdate.json
   

4. Migre o SKU do sistema operacional do pool de nós do sistema de volta ao Ubuntu usando o comando az deployment group create.

   az deployment group create --resource-group testRG --template-file 2apupdate.json
   

Terraform

Exemplo de modelo do Terraform

1. Confirme se o arquivo providers.tf 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 {}
    }

2. Para fins de brevidade, somente o snippet do modelo Terraform que é de interesse é exibido abaixo. Nesta configuração inicial, um cluster do AKS com um nó 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
  }
}

3. Para executar uma migração de SKU do sistema operacional in-loco, basta substituir o os_sku por AzureLinux e reaplicá-lo.

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 de SKU do sistema operacional

Depois que a migração for concluída em seus clusters de teste, você deverá verificar o seguinte para garantir uma migração bem-sucedida:

• Se o destino de migração for o Linux do Azure, execute o comando kubectl get nodes -o wide. A saída deve mostrar Microsoft Azure Linux 3.0 como a imagem do sistema operacional e .azl3 no final da versão do kernel.
• Execute o comando kubectl get pods -o wide -A para verificar se todos os pods e daemonsets estão em execução no novo pool de nós.
• Execute o comando kubectl get nodes --show-labels para verificar se todos os rótulos de nó no pool de nós atualizado são o que você espera.

Dica

É recomendável monitorar a integridade do serviço por algumas semanas antes de migrar os clusters de produção.

Executar a migração de SKU do sistema operacional nos clusters de produção

1. Atualize os modelos existentes para definir OSSKU=AzureLinux. Nos modelos do ARM, use "OSSKU": "AzureLinux" na seção agentPoolProfile. No Bicep, use osSku: "AzureLinux" na seção agentPoolProfile. Por fim, para o Terraform, você usa os_sku = "AzureLinux" na seção default_node_pool. Verifique se apiVersion está definido como 2023-07-01 ou posterior.
2. Reimplante o modelo do ARM, Bicep ou Terraform para que o cluster aplique a nova configuração OSSKU. Durante a implantação, o cluster se comporta como se estivesse fazendo uma atualização de imagem de nó. O cluster aumenta a capacidade e reinicia os nós existentes um a um na imagem mais recente do AKS do novo SKU do sistema operacional.

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, você precisa alterar o campo SKU do sistema operacional em seu modelo e reenviar a implantação, o que dispara outra operação de atualização e restaura o pool de nós para seu SKU anterior do sistema operacional.

Observação

A migração de SKU do SO não dá suporte à reversão para o SKU Mariner do SO.

• Reverta para o SKU do sistema operacional anterior usando o comando az aks nodepool update. Esse comando atualiza o SKU do sistema operacional para o pool de nós do Linux do Azure de volta para o Ubuntu.

Próximas etapas

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

• Remova os pools de nós existentes e adicione novos pools de nós do Linux do Azure.
• Migração in-loco do SKU do sistema operacional.

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

Habilitar a telemetria e o monitoramento