Självstudie: Migrera noder till Azure Linux

Artikel
10/17/2024

I den här självstudien, del tre av fem, migrerar du dina befintliga noder till Azure Linux. Du kan migrera dina befintliga noder till Azure Linux med någon av följande metoder:

Ta bort befintliga nodpooler och lägg till nya Azure Linux-nodpooler.
Os SKU-migrering på plats.

Om du inte har några befintliga noder att migrera till Azure Linux går du vidare till nästa självstudie. I senare självstudier får du lära dig hur du aktiverar telemetri och övervakning i dina kluster och uppgraderar Azure Linux-noder.

Förutsättningar

I tidigare självstudier skapade och distribuerade du en Azure Linux Container Host för AKS-kluster. För att slutföra den här självstudien måste du lägga till en Azure Linux-nodpool i ditt befintliga kluster. Om du inte har gjort det här steget och vill följa med börjar du med Självstudie 2: Lägg till en Azure Linux-nodpool i ditt befintliga AKS-kluster.

Kommentar

När du lägger till en ny Azure Linux-nodpool måste du lägga till minst en som --mode System. Annars tillåter INTE AKS att du tar bort din befintliga nodpool.
Du behöver den senaste versionen av Azure CLI. Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

Lägga till Azure Linux-nodpooler och ta bort befintliga nodpooler

Lägg till en ny Azure Linux-nodpool med kommandot az aks nodepool add . Det här kommandot lägger till en ny nodpool i klustret med --mode System flaggan, vilket gör den till en systemnodpool. Systemnodpooler krävs för Azure Linux-kluster.
```
az aks nodepool add --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --mode System --os-sku AzureLinux
```

Ta bort dina befintliga noder med kommandot az aks nodepool delete .

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

Os SKU-migrering på plats

Nu kan du migrera dina befintliga Ubuntu-nodpooler till Azure Linux genom att ändra os-SKU:n för nodpoolen, som rullar klustret via standardprocessen för nodavbildningsuppgradering. Den här nya funktionen kräver inte att nya nodpooler skapas.

Begränsningar

Det finns flera inställningar som kan blockera begäran om OS SKU-migrering. Granska följande riktlinjer och begränsningar för att säkerställa en lyckad migrering:

Os SKU-migreringsfunktionen är inte tillgänglig via PowerShell eller Azure Portal.
Migreringsfunktionen för OS SKU kan inte byta namn på befintliga nodpooler.
Ubuntu och Azure Linux är de enda SKU-migreringsmålen för Linux OS SKU som stöds.
En Ubuntu OS SKU med UseGPUDedicatedVHD aktiverad kan inte utföra en OS SKU-migrering.
En Ubuntu OS SKU med CVM 20.04 aktiverat kan inte utföra en OS SKU-migrering.
Nodpooler med Kata aktiverat kan inte utföra en OS SKU-migrering.
Windows OS SKU-migrering stöds inte.
OS SKU-migrering från Mariner till Azure Linux stöds, men återställning till Mariner stöds inte.

Förutsättningar

Ett befintligt AKS-kluster med minst en Ubuntu-nodpool.
Vi rekommenderar att du ser till att dina arbetsbelastningar konfigureras och körs på Azure Linux-containervärden innan du försöker använda OS SKU-migreringsfunktionen genom att distribuera ett Azure Linux-kluster i dev/prod och verifiera att tjänsten förblir felfri.
Se till att migreringsfunktionen fungerar för dig i test/utveckling innan du använder processen i ett produktionskluster.
Se till att dina poddar har tillräckligt med podduppstörningsbudget så att AKS kan flytta poddar mellan virtuella datorer under uppgraderingen.
Du behöver Azure CLI version 2.61.0 eller senare. Kör az --version för att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.
Om du använder Terraform måste du ha v3.111.0 eller senare av AzureRM Terraform-modulen.

Migrera OS SKU för din Ubuntu-nodpool

Migrera OS-SKU:n för nodpoolen till Azure Linux med hjälp av az aks nodepool update kommandot . Det här kommandot uppdaterar OS SKU för din nodpool från Ubuntu till Azure Linux. Os SKU-ändringen utlöser en omedelbar uppgraderingsåtgärd, vilket tar flera minuter att slutföra.
```
az aks nodepool update --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
```
Kommentar

Om du får problem under OS SKU-migreringen kan du återställa till din tidigare OS SKU.

Exempel på ARM-mallar

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

Distribuera ett testkluster

Skapa en resursgrupp för testklustret med kommandot az group create .
```
az group create --name testRG --location eastus
```
Distribuera ett Ubuntu OS SKU-baslinjekluster med tre noder med hjälp av az deployment group create kommandot och 0base.json exempel på ARM-mallen.
```
az deployment group create --resource-group testRG --template-file 0base.json
```
Migrera OS-SKU:n för systemnodpoolen till Azure Linux med hjälp av az deployment group create kommandot .
```
az deployment group create --resource-group testRG --template-file 1mcupdate.json
```
Migrera os-SKU:n för systemnodpoolen tillbaka till Ubuntu med hjälp av az deployment group create kommandot .
```
az deployment group create --resource-group testRG --template-file 2apupdate.json
```

Exempel på Terraform-mall

Bekräfta att providers.tf filen har uppdaterats för att hämta den version av Azure-providern som krävs.

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

För korthet visas bara kodfragmentet i Terraform-mallen som är av intresse nedan. I den här inledande konfigurationen distribueras ett AKS-kluster med en nodpool av os_sku med 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
  }
}

Om du vill köra en os SKU-migrering på plats ersätter du bara os_sku till AzureLinux och tillämpar Terraform-planen på nytt.

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

Verifiera OS SKU-migreringen

När migreringen är klar i dina testkluster bör du kontrollera följande för att säkerställa en lyckad migrering:

Om migreringsmålet är Azure Linux kör du kubectl get nodes -o wide kommandot . Utdata ska visas CBL-Mariner/Linux som operativsystemavbildning och .cm2 i slutet av kernelversionen.
kubectl get pods -o wide -A Kör kommandot för att kontrollera att alla dina poddar och daemonuppsättningar körs i den nya nodpoolen.
kubectl get nodes --show-labels Kör kommandot för att kontrollera att alla nodetiketter i den uppgraderade nodpoolen är det du förväntar dig.

Dricks

Vi rekommenderar att du övervakar tjänstens hälsotillstånd i ett par veckor innan du migrerar dina produktionskluster.

Kör OS SKU-migreringen i dina produktionskluster

Uppdatera dina befintliga mallar för att ange OSSKU=AzureLinux. I ARM-mallar använder "OSSKU: "AzureLinux" du i avsnittet agentPoolProfile . I Bicep använder osSku: "AzureLinux" du i avsnittet agentPoolProfile . Slutligen använder "os_sku = "AzureLinux" du i default_node_pool avsnittet för Terraform. Kontrollera att din apiVersion är inställd på 2023-07-01 eller senare.
Distribuera om arm-, Bicep- eller Terraform-mallen för klustret för att tillämpa den nya OSSKU inställningen. Under den här distributionen fungerar klustret som om det tar en nodavbildningsuppgradering. Klustret ökar kapaciteten och startar sedan om dina befintliga noder en i taget till den senaste AKS-avbildningen från din nya OS SKU.

Återställning

Om du får problem under OS SKU-migreringen kan du återställa till din tidigare OS SKU. För att göra detta måste du ändra OS SKU-fältet i mallen och skicka distributionen igen, vilket utlöser en annan uppgraderingsåtgärd och återställer nodpoolen till dess tidigare OS SKU.

Kommentar

OS SKU-migrering stöder inte återställning till OS SKU Mariner.

Återställ till din tidigare OS SKU med kommandot az aks nodepool update . Det här kommandot uppdaterar OS SKU för din nodpool från Azure Linux tillbaka till Ubuntu.
```
az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku Ubuntu
```

Nästa steg

I den här självstudien migrerade du befintliga noder till Azure Linux med någon av följande metoder:

Ta bort befintliga nodpooler och lägg till nya Azure Linux-nodpooler.
Os SKU-migrering på plats.

I nästa självstudie får du lära dig hur du aktiverar telemetri för att övervaka dina kluster.

Aktivera telemetri och övervakning

Dela via

Självstudie: Migrera noder till Azure Linux

Förutsättningar

Lägga till Azure Linux-nodpooler och ta bort befintliga nodpooler

Os SKU-migrering på plats

Begränsningar

Förutsättningar

Migrera OS SKU för din Ubuntu-nodpool

Exempel på ARM-mallar

0base.json

1mcupdate.json

2apupdate.json

Distribuera ett testkluster

Exempel på Terraform-mall

providers.tf

base.tf

update.tf

Verifiera OS SKU-migreringen

Kör OS SKU-migreringen i dina produktionskluster

Återställning

Nästa steg

Feedback

Ytterligare resurser