Zelfstudie: Knooppunten migreren naar Azure Linux

In deze zelfstudie, deel drie van vijf, migreert u uw bestaande knooppunten naar Azure Linux. U kunt uw bestaande knooppunten migreren naar Azure Linux met behulp van een van de volgende methoden:

• Verwijder bestaande knooppuntgroepen en voeg nieuwe Azure Linux-knooppuntgroepen toe.
• In-place SKU-migratie van besturingssysteem.

Als u geen bestaande knooppunten hebt om te migreren naar Azure Linux, gaat u verder met de volgende zelfstudie. In latere zelfstudies leert u hoe u telemetrie en bewaking inschakelt in uw clusters en Azure Linux-knooppunten bijwerkt.

Vereisten

• In de vorige zelfstudies hebt u een Azure Linux-containerhost voor AKS-cluster gemaakt en geïmplementeerd. Als u deze zelfstudie wilt voltooien, moet u een Azure Linux-knooppuntgroep toevoegen aan uw bestaande cluster. Als u deze stap nog niet hebt uitgevoerd en u deze wilt volgen, begint u met zelfstudie 2: Een Azure Linux-knooppuntgroep toevoegen aan uw bestaande AKS-cluster.

  Notitie

  Wanneer u een nieuwe Azure Linux-knooppuntgroep toevoegt, moet u ten minste één --mode Systemals . Anders kunt u met AKS uw bestaande knooppuntgroep niet verwijderen.

• U hebt de nieuwste versie van Azure CLI nodig. Voer az --version uit om de versie te bekijken. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.

Azure Linux-knooppuntgroepen toevoegen en bestaande knooppuntgroepen verwijderen

1. Voeg een nieuwe Azure Linux-knooppuntgroep toe met behulp van de az aks nodepool add opdracht. Met deze opdracht wordt een nieuwe knooppuntgroep aan uw cluster toegevoegd met de --mode System vlag, waardoor het een systeemknooppuntgroep wordt. Systeemknooppuntgroepen zijn vereist voor Azure Linux-clusters.

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

2. Verwijder uw bestaande knooppunten met behulp van de az aks nodepool delete opdracht.

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

In-place SKU-migratie van besturingssysteem

U kunt nu uw bestaande Ubuntu-knooppuntgroepen migreren naar Azure Linux door de SKU van het besturingssysteem van de knooppuntgroep te wijzigen, waarmee het cluster wordt gevouwen via het upgradeproces van de standaardinstallatiekopie van knooppunten. Voor deze nieuwe functie is het maken van nieuwe knooppuntgroepen niet vereist.

Beperkingen

Er zijn verschillende instellingen waarmee de migratieaanvraag voor de SKU van het besturingssysteem kan worden geblokkeerd. Bekijk de volgende richtlijnen en beperkingen om een geslaagde migratie te garanderen:

• De SKU-migratiefunctie van het besturingssysteem is niet beschikbaar via PowerShell of Azure Portal.
• De SKU-migratiefunctie van het besturingssysteem kan de naam van bestaande knooppuntgroepen niet wijzigen.
• Ubuntu en Azure Linux zijn de enige ondersteunde Linux OS SKU-migratiedoelen.
• Een Ubuntu OS-SKU waarvoor UseGPUDedicatedVHD ingeschakeld is, kan geen SKU-migratie van het besturingssysteem uitvoeren.
• Een Ubuntu OS SKU waarvoor CVM 20.04 is ingeschakeld, kan geen SKU-migratie van het besturingssysteem uitvoeren.
• Knooppuntgroepen waarvoor Kata is ingeschakeld, kunnen geen SKU-migratie van het besturingssysteem uitvoeren.
• Migratie van windows-besturingssysteem-SKU's wordt niet ondersteund.
• Migratie van os-SKU van Mariner naar Azure Linux wordt ondersteund, maar terugdraaien naar Mariner wordt niet ondersteund.

Vereisten

• Een bestaand AKS-cluster met ten minste één Ubuntu-knooppuntgroep.
• We raden u aan ervoor te zorgen dat uw workloads met succes worden geconfigureerd en uitgevoerd op de Azure Linux-containerhost voordat u de SKU-migratiefunctie van het besturingssysteem probeert te gebruiken door een Azure Linux-cluster te implementeren in dev/prod en te controleren of uw service in orde blijft.
• Zorg ervoor dat de migratiefunctie voor u in test/dev werkt voordat u het proces in een productiecluster gebruikt.
• Zorg ervoor dat uw pods voldoende budget voor podonderbreking hebben, zodat AKS tijdens de upgrade pods tussen VM's kan verplaatsen.
• U hebt Azure CLI versie 2.61.0 of hoger nodig. Voer az --version uit om de versie te bekijken. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.
• Als u Terraform gebruikt, moet u beschikken over v3.111.0 of hoger van de AzureRM Terraform-module.

Azure-CLI

Migreer de SKU van het besturingssysteem van uw Ubuntu-knooppuntgroep

• Migreer de SKU van het besturingssysteem van uw knooppuntgroep naar Azure Linux met behulp van de az aks nodepool update opdracht. Met deze opdracht wordt de SKU van het besturingssysteem voor uw knooppuntgroep bijgewerkt van Ubuntu naar Azure Linux. De SKU-wijziging van het besturingssysteem activeert een onmiddellijke upgradebewerking, die enkele minuten duurt.

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

  Notitie

  Als u problemen ondervindt tijdens de migratie van de SKU van het besturingssysteem, kunt u terugdraaien naar uw vorige SKU van het besturingssysteem.

ARM-sjabloon

Voorbeeld van ARM-sjablonen

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

Een testcluster implementeren

1. Maak een resourcegroep voor het testcluster met behulp van de az group create opdracht.

   az group create --name testRG --location eastus
   

2. Implementeer een Ubuntu OS SKU-cluster met drie knooppunten met behulp van de az deployment group create opdracht en de 0base.json voorbeeld-ARM-sjabloon.

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

3. Migreer de SKU van het besturingssysteem van uw systeemknooppuntgroep naar Azure Linux met behulp van de az deployment group create opdracht.

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

4. Migreer de SKU van het besturingssysteem van uw systeemknooppuntgroep terug naar Ubuntu met behulp van de az deployment group create opdracht.

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

Terraform

Voorbeeld van Terraform-sjabloon

1. Controleer of uw providers.tf bestand is bijgewerkt om de vereiste versie van de Azure-provider op te halen.

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. Ter beknoptheid wordt hieronder alleen het codefragment van de Terraform-sjabloon weergegeven die van belang is. In deze eerste configuratie wordt een AKS-cluster met een knooppuntpool van os_sku met Ubuntu geïmplementeerd.

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. Als u een in-place SKU-migratie van het besturingssysteem wilt uitvoeren, vervangt u de os_sku naar AzureLinux en past u het Terraform-plan opnieuw toe.

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

De migratie van de SKU van het besturingssysteem controleren

Zodra de migratie is voltooid op uw testclusters, moet u het volgende controleren om een geslaagde migratie te garanderen:

• Als uw migratiedoel Azure Linux is, voert u de kubectl get nodes -o wide opdracht uit. De uitvoer moet worden weergegeven CBL-Mariner/Linux als de installatiekopieën van het besturingssysteem en .cm2 aan het einde van de kernelversie.
• Voer de kubectl get pods -o wide -A opdracht uit om te controleren of al uw pods en daemonsets worden uitgevoerd in de nieuwe knooppuntgroep.
• Voer de kubectl get nodes --show-labels opdracht uit om te controleren of alle knooppuntlabels in de bijgewerkte knooppuntgroep zijn wat u verwacht.

Tip

Het is raadzaam om de status van uw service een paar weken te controleren voordat u uw productieclusters migreert.

De SKU-migratie van het besturingssysteem uitvoeren op uw productieclusters

1. Werk uw bestaande sjablonen bij om in te stellen OSSKU=AzureLinux. In ARM-sjablonen gebruikt "OSSKU: "AzureLinux" u in de agentPoolProfile sectie. In Bicep gebruikt osSku: "AzureLinux" u in de agentPoolProfile sectie. Ten slotte gebruikt "os_sku = "AzureLinux" u voor Terraform de default_node_pool sectie. Zorg ervoor dat de apiVersion instellingen zijn ingesteld op 2023-07-01 of hoger.
2. Implementeer de ARM-, Bicep- of Terraform-sjabloon opnieuw voor het cluster om de nieuwe OSSKU instelling toe te passen. Tijdens deze implementatie gedraagt uw cluster zich alsof het een upgrade van de knooppuntinstallatiekopieën uitvoert. Het cluster piekt de capaciteit en start vervolgens uw bestaande knooppunten één voor één opnieuw op in de meest recente AKS-installatiekopieën van uw nieuwe SKU voor het besturingssysteem.

Terugdraaiactie

Als u problemen ondervindt tijdens de migratie van de SKU van het besturingssysteem, kunt u terugdraaien naar uw vorige SKU van het besturingssysteem. Hiervoor moet u het veld os-SKU in uw sjabloon wijzigen en de implementatie opnieuw indienen, waardoor een andere upgradebewerking wordt geactiveerd en de knooppuntgroep wordt hersteld naar de vorige SKU van het besturingssysteem.

Notitie

Migratie van os-SKU biedt geen ondersteuning voor terugdraaien naar OS SKU Mariner.

• Ga terug naar de vorige SKU van het besturingssysteem met behulp van de az aks nodepool update opdracht. Met deze opdracht wordt de SKU van het besturingssysteem voor uw knooppuntgroep bijgewerkt van Azure Linux terug naar Ubuntu.

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

Volgende stappen

In deze zelfstudie hebt u bestaande knooppunten gemigreerd naar Azure Linux met behulp van een van de volgende methoden:

• Verwijder bestaande knooppuntgroepen en voeg nieuwe Azure Linux-knooppuntgroepen toe.
• In-place SKU-migratie van besturingssysteem.

In de volgende zelfstudie leert u hoe u telemetrie kunt inschakelen om uw clusters te bewaken.

Telemetrie en bewaking inschakelen