Självstudie: Migrera noder till Azure Linux

2025-09-11

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.
Migrering av operativsystemets SKU direkt.

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

Viktigt!

Från och med den 30 november 2025 kommer AKS inte längre att stödja eller tillhandahålla säkerhetsuppdateringar för Azure Linux 2.0. Från och med den 31 mars 2026 tas nodbilder bort och du kan inte skala dina nodpooler. Migrera till en Azure Linux-version som stöds genom att uppgradera dina nodpooler till en Kubernetes-version som stöds eller migrera till osSku AzureLinux3. Mer information finns i [Pensionering] Azure Linux 2.0-nodpooler på AKS.

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.

# 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

Resultat:

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

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

Migrering av operativsystem-SKU direkt

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 stödda mål för migration av Linux OS SKU.
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 säkerställer att dina arbetsbelastningar konfigureras och körs framgångsrikt 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 din tjänst förblir stabil.
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 --cluster-name $CLUSTER_NAME --name $NODE_POOL_NAME --os-sku AzureLinux

Resultat:

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

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 användning 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
  }
}

För att köra en in-place OS SKU-migrering 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 visa Microsoft Azure Linux 3.0 som operativsystemets avbildning och .azl3 i slutet av din kärnversion.
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.

Tips

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 du "OSSKU": "AzureLinux" i avsnittet agentPoolProfile. I Bicep använder du osSku: "AzureLinux" i avsnittet agentPoolProfile. Slutligen, för Terraform, använder du os_sku = "AzureLinux" i default_node_pool-avsnittet. Kontrollera att din apiVersion är inställd på 2023-07-01 eller senare.
Återdistribuera din ARM-, Bicep- eller Terraform-mall för klustret för att tillämpa den nya OSSKU inställning. Under den här distributionen beter sig klustret som om det genomgår en uppgradering av nodavbildningen. 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.

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.
Migrering av operativsystemets SKU direkt.

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

Feedback

Var den här sidan till hjälp?

Dela via

Självstudie: Migrera noder till Azure Linux

Förutsättningar

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

Migrering av operativsystem-SKU direkt

Begränsningar

Förutsättningar

Migrera OS SKU för din Ubuntu-nodpool

Verifiera OS SKU-migreringen

Kör OS SKU-migreringen i dina produktionskluster

Återställning

Nästa steg

Feedback

Ytterligare resurser