Oktatóanyag: Csomópontok migrálása Azure Linuxra

Ebben az oktatóanyagban, az öt rész harmadik részében migrálja a meglévő csomópontokat az Azure Linuxba. A meglévő csomópontokat az alábbi módszerek egyikével migrálhatja az Azure Linuxba:

• Távolítsa el a meglévő csomópontkészleteket, és vegyen fel új Azure Linux-csomópontkészleteket.
• Helyszíni operációsrendszer-termékváltozat migrálása.

Ha nincs meglévő csomópontja az Azure Linuxra való migráláshoz, ugorjon a következő oktatóanyagra. A későbbi oktatóanyagokban megtanulhatja, hogyan engedélyezheti a telemetriát és a monitorozást a fürtökben, és hogyan frissítheti az Azure Linux-csomópontokat.

Előfeltételek

• A korábbi oktatóanyagokban létrehozott és üzembe helyezett egy Azure Linux Container Host for AKS-fürtöt. Az oktatóanyag elvégzéséhez hozzá kell adnia egy Azure Linux-csomópontkészletet a meglévő fürthöz. Ha még nem tette meg ezt a lépést, és követni szeretné, kezdje a 2. oktatóanyaggal : Azure Linux-csomópontkészlet hozzáadása a meglévő AKS-fürthöz.

  Feljegyzés

  Új Azure Linux-csomópontkészlet hozzáadásakor legalább egyet hozzá kell adnia.--mode System Ellenkező esetben az AKS nem engedélyezi a meglévő csomópontkészlet törlését.

• Az Azure CLI legújabb verziójára van szüksége. A verzió azonosításához futtassa a következőt: az --version. Ha telepíteni vagy frissíteni szeretne: Az Azure CLI telepítése.

Azure Linux-csomópontkészletek hozzáadása és meglévő csomópontkészletek eltávolítása

1. Adjon hozzá egy új Azure Linux-csomópontkészletet a az aks nodepool add parancs használatával. Ez a parancs egy új csomópontkészletet ad hozzá a fürthöz a --mode System jelölővel, ami rendszercsomópont-készletet hoz létre. Az Azure Linux-fürtökhöz rendszercsomópont-készletek szükségesek.

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

2. Távolítsa el a meglévő csomópontokat a az aks nodepool delete paranccsal.

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

Helyszíni operációsrendszer-termékváltozat migrálása

A meglévő Ubuntu-csomópontkészleteket most már migrálhatja az Azure Linuxba a csomópontkészlet operációsrendszer-termékváltozatának módosításával, amely a fürtöt a szabványos csomópontrendszerkép-frissítési folyamaton keresztül összesít. Ez az új funkció nem igényel új csomópontkészletek létrehozását.

Korlátozások

Az operációsrendszer-termékváltozat migrálási kérését több beállítás is letilthatja. A sikeres migrálás biztosításához tekintse át az alábbi irányelveket és korlátozásokat:

• Az operációsrendszer-termékváltozat migrálási funkciója nem érhető el a PowerShellen vagy az Azure Portalon keresztül.
• Az operációsrendszer-termékváltozat migrálási funkciója nem tudja átnevezni a meglévő csomópontkészleteket.
• Az Ubuntu és az Azure Linux az egyetlen támogatott Linux operációsrendszer-termékváltozat-áttelepítési cél.
• Az engedélyezett Ubuntu operációsrendszer-termékváltozatok UseGPUDedicatedVHD nem hajthatnak végre operációsrendszer-termékváltozat-migrálást.
• A CVM 20.04-kompatibilis Ubuntu operációsrendszer-termékváltozat nem képes operációsrendszer-termékváltozat migrálására.
• A Kata-kompatibilis csomópontkészletek nem hajthatnak végre operációsrendszer-termékváltozat-migrálást.
• A Windows operációs rendszer termékváltozatának áttelepítése nem támogatott.
• Az operációsrendszer-termékváltozat marinerről Azure Linuxra történő migrálása támogatott, de a Marinerbe való visszalépés nem támogatott.

Előfeltételek

• Meglévő AKS-fürt legalább egy Ubuntu csomópontkészlettel.
• Javasoljuk, hogy a számítási feladatok konfigurálását és sikeres futtatását az Azure Linux-tároló gazdagépen végezze el, mielőtt megkísérli használni az operációsrendszer-termékváltozat migrálási funkcióját úgy, hogy üzembe helyez egy Azure Linux-fürtöt a fejlesztői/fejlesztői környezetben, és ellenőrzi, hogy a szolgáltatás kifogástalan-e.
• Győződjön meg arról, hogy a migrálási funkció a teszt/fejlesztés során működik, mielőtt éles fürtön használjuk a folyamatot.
• Győződjön meg arról, hogy a podok elegendő podkimaradási költségvetéssel rendelkeznek ahhoz, hogy az AKS áthelyezhesse a podokat a virtuális gépek között a frissítés során.
• Az Azure CLI 2.61.0-s vagy újabb verziójára van szüksége. A verzió azonosításához futtassa a következőt: az --version. Ha telepíteni vagy frissíteni szeretne: Az Azure CLI telepítése.
• Ha Terraformot használ, az AzureRM Terraform modul 3.111.0-s vagy újabb verziójával kell rendelkeznie.

Azure CLI

Az Ubuntu-csomópontkészlet operációsrendszer-termékváltozatának migrálása

• A parancs használatával migrálja a csomópontkészlet operációsrendszer-termékváltozatát az az aks nodepool update Azure Linuxba. Ez a parancs frissíti a csomópontkészlet operációsrendszer-termékváltozatát az Ubuntutól az Azure Linuxig. Az operációsrendszer-termékváltozat módosítása azonnali frissítési műveletet indít el, amely több percet vesz igénybe.

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

  Feljegyzés

  Ha problémákat tapasztal az operációsrendszer-termékváltozat migrálása során, visszatérhet az előző operációsrendszer-termékváltozathoz.

ARM-sablon

Példa ARM-sablonokra

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

Tesztfürt üzembe helyezése

1. Hozzon létre egy erőforráscsoportot a tesztfürthöz a az group create paranccsal.

   az group create --name testRG --location eastus
   

2. Helyezzen üzembe egy alapkonfigurációs Ubuntu operációsrendszer-termékváltozat-fürtöt három csomóponttal a az deployment group create parancs és a 0base.json arm-példasablon használatával.

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

3. A parancs használatával migrálja a rendszercsomópontkészlet operációsrendszer-termékváltozatát az az deployment group create Azure Linuxba.

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

4. A parancs használatával migrálja a rendszercsomópontkészlet operációsrendszer-termékváltozatát az az deployment group create Ubuntu-ba.

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

Terraform

Példa Terraform-sablonra

1. Győződjön meg arról, hogy a providers.tf fájl frissült az Azure-szolgáltató szükséges verziójának kiválasztásához.

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. A rövidség kedvéért az alábbiakban csak az érdekes Terraform-sablon kódrészlete jelenik meg. Ebben a kezdeti konfigurációban egy olyan AKS-fürt lesz üzembe helyezve, amely os_sku csomópontkészlettel rendelkezik az Ubuntu használatával.

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. Helyi operációsrendszer-termékváltozat migrálásának futtatásához cserélje le a os_sku az AzureLinux-ra, és alkalmazza újra a Terraform-csomagot.

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

Az operációsrendszer-termékváltozat migrálásának ellenőrzése

Ha az áttelepítés befejeződött a tesztfürtökön, a sikeres migrálás biztosításához ellenőrizze az alábbiakat:

• Ha a migrálási cél Azure Linux, futtassa a kubectl get nodes -o wide parancsot. A kimenetnek az operációs rendszer képeként és .cm2 a kernelverzió végén kell megjelennieCBL-Mariner/Linux.
• Futtassa a kubectl get pods -o wide -A parancsot annak ellenőrzéséhez, hogy az összes pod és démonkészlet fut-e az új csomópontkészleten.
• Futtassa a kubectl get nodes --show-labels parancsot annak ellenőrzéséhez, hogy a frissített csomópontkészlet összes csomópontcímkéje megfelel-e a vártnak.

Tipp.

Javasoljuk, hogy az éles fürtök áttelepítése előtt néhány hétig monitorozza a szolgáltatás állapotát.

Futtassa az operációsrendszer-termékváltozat migrálását az éles fürtökön

1. Frissítse a meglévő sablonokat a beállításhoz OSSKU=AzureLinux. AZ ARM-sablonokban a agentPoolProfile szakaszt használja"OSSKU: "AzureLinux". A Bicepben a szakaszt agentPoolProfile használjaosSku: "AzureLinux". Végül a Terraform esetében a szakaszt default_node_pool használja"os_sku = "AzureLinux". Győződjön meg arról, hogy a apiVersion beállítás értéke 2023-07-01 vagy újabb.
2. Helyezze újra üzembe az ARM-, Bicep- vagy Terraform-sablont a fürthöz az új OSSKU beállítás alkalmazásához. Az üzembe helyezés során a fürt úgy viselkedik, mintha csomópontrendszerkép-frissítést szeretne elvégezni. A fürt kapacitása megnő, majd egyenként újraindítja a meglévő csomópontokat az új operációsrendszer-termékváltozat legújabb AKS-rendszerképébe.

Visszaállítás

Ha problémákat tapasztal az operációsrendszer-termékváltozat migrálása során, visszatérhet az előző operációsrendszer-termékváltozathoz. Ehhez módosítania kell a sablon operációsrendszer-termékváltozatának mezőjét, és újra kell küldenie az üzembe helyezést, amely újabb frissítési műveletet indít el, és visszaállítja a csomópontkészletet a korábbi operációsrendszer-termékváltozatra.

Feljegyzés

Az operációsrendszer-termékváltozat migrálása nem támogatja az operációsrendszer-termékváltozat marinerre való visszatérést.

• Térjen vissza az előző operációsrendszer-termékváltozathoz a az aks nodepool update paranccsal. Ez a parancs frissíti a csomópontkészlet operációsrendszer-termékváltozatát az Azure Linuxról vissza az Ubuntu-ba.

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

Következő lépések

Ebben az oktatóanyagban a meglévő csomópontokat migrálta az Azure Linuxba az alábbi módszerek egyikével:

• Távolítsa el a meglévő csomópontkészleteket, és vegyen fel új Azure Linux-csomópontkészleteket.
• Helyszíni operációsrendszer-termékváltozat migrálása.

A következő oktatóanyagban megtudhatja, hogyan engedélyezheti a telemetriát a fürtök monitorozásához.

Telemetria és monitorozás engedélyezése