Tutorial: Migrar nós para o Azure Linux

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 in-loco.

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.

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.

  Nota

  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, veja Install Azure CLI (Instalar o Azure CLI).

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

1. 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, o --mode System que o torna um pool de nós do sistema. Os pools de nós do sistema são necessários para clusters Linux do Azure.

   az aks nodepool add --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --mode System --os-sku AzureLinux
   

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

   az aks nodepool delete --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name>
   

Migração de SKU do SO in-loco

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 pode renomear pools de nós existentes.
• Ubuntu e Azure Linux são os únicos destinos de migração de SKU do sistema operacional Linux suportados.
• 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 seus pods tenham orçamento de interrupção de pod suficiente para permitir que o AKS 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, veja Install Azure CLI (Instalar o Azure CLI).
• Se você estiver usando o Terraform, deverá ter a v3.111.0 ou superior do módulo Terraform do AzureRM.

CLI do Azure

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-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
  

  Nota

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

Modelo ARM

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

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

   az group create --name testRG --location eastus
   

2. 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 exemplo 0base.json.

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

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

   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 para o Ubuntu usando o az deployment group create comando.

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

Terraform

Exemplo de modelo Terraform

1. 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 {}
    }

2. 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 o 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 para 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 de SKU do SO

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 CBL-Mariner/Linux como sua imagem do sistema operacional e .cm2 no final da sua versão do kernel.
• Execute o kubectl get pods -o wide -A comando para verificar se todos os pods e daemonsets estão em execução no novo pool de nós.
• Execute o kubectl get nodes --show-labels comando para verificar se todos os rótulos de nó no pool de nós atualizado são o esperado.

Gorjeta

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

1. Atualize seus modelos existentes para definir OSSKU=AzureLinuxo . Em modelos ARM, você usa "OSSKU: "AzureLinux" na agentPoolProfile seção . No Bicep, você usa osSku: "AzureLinux" na agentPoolProfile seção . 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 posterior.
2. Reimplante seu modelo ARM, Bíceps ou Terraform para o cluster para aplicar a nova OSSKU configuração. Durante essa implantação, o cluster se comporta como se estivesse fazendo 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, você precisa alterar o campo SKU do sistema operacional em seu modelo e reenviar a implantação, que dispara outra operação de atualização e restaura o pool de nós para o SKU do sistema operacional anterior.

Nota

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

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

  az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku 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 in-loco.

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

Habilite a telemetria e o monitoramento