Esercitazione: Eseguire la migrazione di nodi in Azure Linux

In questa esercitazione, parte 3 di cinque, si esegue la migrazione dei nodi esistenti in Azure Linux. È possibile eseguire la migrazione dei nodi esistenti in Azure Linux usando uno dei metodi seguenti:

• Rimuovere i pool di nodi esistenti e aggiungere nuovi pool di nodi Linux di Azure.
• Migrazione dello SKU del sistema operativo sul posto.

Se non sono presenti nodi esistenti per eseguire la migrazione ad Azure Linux, passare all'esercitazione successiva. Nelle esercitazioni successive si apprenderà come abilitare la telemetria e il monitoraggio nei cluster e aggiornare i nodi Linux di Azure.

Prerequisiti

• Nelle esercitazioni precedenti è stato creato e distribuito un host contenitore Linux di Azure per il cluster del servizio Azure Kubernetes. Per completare questa esercitazione, è necessario aggiungere un pool di nodi Linux di Azure al cluster esistente. Se non è stato fatto questo passaggio e si vuole seguire questa procedura, iniziare con Esercitazione 2: Aggiungere un pool di nodi Linux di Azure al cluster del servizio Azure Kubernetes esistente.

  Nota

  Quando si aggiunge un nuovo pool di nodi Linux di Azure, è necessario aggiungerne almeno uno come --mode System. In caso contrario, il servizio Azure Kubernetes non consente di eliminare il pool di nodi esistente.

• È necessaria la versione più recente dell'interfaccia della riga di comando di Azure. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Aggiungere pool di nodi Linux di Azure e rimuovere pool di nodi esistenti

1. Aggiungere un nuovo pool di nodi Linux di Azure usando il comando az aks nodepool add. Questo comando aggiunge un nuovo pool di nodi al cluster con il flag --mode System, che lo rende un pool di nodi di sistema. I pool di nodi di sistema sono necessari per i cluster Linux di Azure.

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

2. Rimuovere i nodi esistenti usando il comando az aks nodepool delete.

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

Migrazione dello SKU del sistema operativo sul posto

È ora possibile eseguire la migrazione dei pool di nodi Ubuntu esistenti in Azure Linux modificando lo SKU del sistema operativo del pool di nodi, che esegue il rollback del cluster tramite il processo di aggiornamento dell'immagine del nodo standard. Questa nuova funzionalità non richiede la creazione di nuovi pool di nodi.

Limiti

Esistono diverse impostazioni che possono bloccare la richiesta di migrazione dello SKU del sistema operativo. Per garantire una migrazione corretta, esaminare le linee guida e le limitazioni seguenti:

• La funzionalità di migrazione dello SKU del sistema operativo non è disponibile tramite PowerShell o il portale di Azure.
• La funzionalità di migrazione dello SKU del sistema operativo non è in grado di rinominare i pool di nodi esistenti.
• Ubuntu e Azure Linux sono le uniche destinazioni di migrazione dello SKU del sistema operativo Linux supportate.
• Uno SKU del sistema operativo Ubuntu con UseGPUDedicatedVHD abilitato non può eseguire una migrazione dello SKU del sistema operativo.
• Uno SKU del sistema operativo Ubuntu con CVM 20.04 abilitato non può eseguire una migrazione dello SKU del sistema operativo.
• I pool di nodi con Kata abilitato non possono eseguire una migrazione dello SKU del sistema operativo.
• La migrazione dello SKU del sistema operativo Windows non è supportata.
• La migrazione dello SKU del sistema operativo da Mariner ad Azure Linux è supportata, ma il rollback a Mariner non è supportato.

Prerequisiti

• Un cluster del servizio Azure Kubernetes esistente con almeno un pool di nodi Ubuntu.
• È consigliabile assicurarsi che i carichi di lavoro vengano configurati ed eseguiti correttamente nell'host contenitore Linux di Azure prima di provare a usare la funzionalità di migrazione dello SKU del sistema operativo distribuendo un cluster Linux di Azure in dev/prod e verificando che il servizio rimanga integro.
• Assicurarsi che la funzionalità di migrazione funzioni in fase di test/sviluppo prima di usare il processo in un cluster di produzione.
• Assicurarsi che i pod abbiano abbastanza budget di interruzione dei pod per consentire al servizio Azure Kubernetes di spostare i pod tra le macchine virtuali durante l'aggiornamento.
• È necessaria la versione dell'interfaccia della riga di comando di Azure 2.61.0 o successiva. Eseguire az --version per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.
• Se si usa Terraform, è necessario avere v3.111.0 o versione successiva del modulo Terraform di AzureRM.

Interfaccia della riga di comando di Azure

Eseguire la migrazione dello SKU del sistema operativo del pool di nodi Ubuntu

• Eseguire la migrazione dello SKU del sistema operativo del pool di nodi in Azure Linux usando il comando az aks nodepool update. Questo comando aggiorna lo SKU del sistema operativo per il pool di nodi da Ubuntu ad Azure Linux. La modifica dello SKU del sistema operativo attiva un'operazione di aggiornamento immediato, che richiede alcuni minuti.

  az aks nodepool update --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
  

  Nota

  Se si verificano problemi durante la migrazione dello SKU del sistema operativo, è possibile eseguire il rollback allo SKU del sistema operativo precedente.

Modello ARM

Modelli di ARM di esempio

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"
      }
    }
  ]
}

Distribuire un cluster di test

1. Creare un gruppo di risorse per il cluster di test usando il comando az group create.

   az group create --name testRG --location eastus
   

2. Distribuire un cluster SKU del sistema operativo Ubuntu di base con tre nodi usando il comando az deployment group create e il modello ARM di esempio 0base.json.

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

3. Eseguire la migrazione dello SKU del sistema operativo del pool di nodi di sistema in Azure Linux usando il comando az deployment group create.

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

4. Eseguire di nuovo la migrazione dello SKU del sistema operativo del pool di nodi di sistema a Ubuntu usando il comando az deployment group create.

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

Terraform

Modello Terraform di esempio

1. Verificare che il file providers.tf sia aggiornato per selezionare la versione richiesta del provider di 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. Per brevità, di seguito viene visualizzato solo il frammento del modello Terraform di interesse. In questa configurazione iniziale viene distribuito un cluster del servizio Azure Kubernetes con un pool di nodi di os_sku con Ubuntu.

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. Per eseguire una migrazione dello SKU del sistema operativo sul posto, sostituire semplicemente il os_sku per azureLinux e riapplicare il piano 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
  }
}

Verificare la migrazione dello SKU del sistema operativo

Una volta completata la migrazione nei cluster di test, è necessario verificare quanto segue per assicurarsi che la migrazione abbia esito positivo:

• Se la destinazione della migrazione è Azure Linux, eseguire il comando kubectl get nodes -o wide. L'output dovrebbe mostrare CBL-Mariner/Linux come immagine del sistema operativo e .cm2 alla fine della versione del kernel.
• Eseguire il comando kubectl get pods -o wide -A per verificare che tutti i pod e i daemonset siano in esecuzione nel nuovo pool di nodi.
• Eseguire il comando kubectl get nodes --show-labels per verificare che tutte le etichette dei nodi nel pool di nodi aggiornato siano le aspettative.

Suggerimento

È consigliabile monitorare l'integrità del servizio per un paio di settimane prima della migrazione dei cluster di produzione.

Eseguire la migrazione dello SKU del sistema operativo nei cluster di produzione

1. Aggiornare i modelli esistenti per impostare OSSKU=AzureLinux. Nei modelli di Resource Manager è possibile usare "OSSKU: "AzureLinux" nella sezione agentPoolProfile. In Bicep si usa osSku: "AzureLinux" nella sezione agentPoolProfile. Infine, per Terraform si usa "os_sku = "AzureLinux" nella sezione default_node_pool. Assicurarsi che apiVersion sia impostato su 2023-07-01 o versione successiva.
2. Ridistribuire il modello ARM, Bicep o Terraform per il cluster per applicare la nuova impostazione di OSSKU. Durante questa distribuzione, il cluster si comporta come se sta eseguendo un aggiornamento di un'immagine del nodo. Il cluster aumenta la capacità e quindi riavvia i nodi esistenti uno alla sola nell'immagine più recente del servizio Azure Kubernetes dal nuovo SKU del sistema operativo.

Rollback

Se si verificano problemi durante la migrazione dello SKU del sistema operativo, è possibile eseguire il rollback allo SKU del sistema operativo precedente. A tale scopo, è necessario modificare il campo SKU del sistema operativo nel modello e inviare di nuovo la distribuzione, che attiva un'altra operazione di aggiornamento e ripristina il pool di nodi nello SKU precedente del sistema operativo.

Nota

La migrazione dello SKU del sistema operativo non supporta il rollback a OS SKU Mariner.

• Eseguire il rollback allo SKU del sistema operativo precedente usando il comando az aks nodepool update. Questo comando aggiorna lo SKU del sistema operativo per il pool di nodi da Azure Linux a Ubuntu.

  az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku Ubuntu
  

Passaggi successivi

In questa esercitazione è stata eseguita la migrazione di nodi esistenti in Linux di Azure usando uno dei metodi seguenti:

• Rimuovere i pool di nodi esistenti e aggiungere nuovi pool di nodi Linux di Azure.
• Migrazione dello SKU del sistema operativo sul posto.

Nell'esercitazione successiva si apprenderà come abilitare la telemetria per monitorare i cluster.

Abilitare la telemetria e il monitoraggio