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 (előzetes verzió).

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 (előzetes verzió)

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 Terraformon, a PowerShellen vagy az Azure Portalon.
• 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 AgentPool count mező nem módosítható az áttelepítés során.
• 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.

Előfeltételek

• Telepítse a bővítménytaks-preview.
• Regisztrálja a OSSKUMigrationPreview funkciójelzőt az előfizetésben.
• 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 0.5.172-es 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.

Azure CLI

A aks-preview bővítmény telepítése

Fontos

Az AKS előzetes verziójú funkciói önkiszolgáló, opt-in alapon érhetők el. Az előzetes verziókat "ahogy van" és "rendelkezésre állóként" biztosítjuk, és a szolgáltatási szerződésekből és a korlátozott jótállásból kizárjuk őket. Az AKS előzetes verzióit részben az ügyfélszolgálat fedezi a legjobb munkamennyiség alapján. Ezért ezek a funkciók nem éles használatra vannak szánva. További információkért tekintse meg az alábbi támogatási cikkeket:

• AKS támogatási politikák
• Azure-támogatás gyakori kérdések

1. Telepítse a bővítményt aks-preview a az extension add paranccsal.

   az extension add --name aks-preview
   

2. Frissítse a bővítményt, hogy biztosan a legújabb verzióval rendelkezzen a az extension update parancs használatával.

   az extension update --name aks-preview
   

A funkciójelző regisztrálása OSSKUMigrationPreview

1. Regisztrálja a OSSKUMigrationPreview funkciójelzőt az előfizetésben a az feature register paranccsal.

   az feature register --namespace Microsoft.ContainerService --name OSSKUMigrationPreview
   

2. Ellenőrizze a regisztrációs állapotot a az feature list paranccsal.

   az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/OSSKUMigrationPreview')].{Name:name,State:properties.state}"
   

   A kimenetnek a következő példakimenethez hasonlóan kell kinéznie:

   Name                                            State
   ----------------------------------------------  -------
   Microsoft.ContainerService/OSSKUMigrationPreview  Registered
   

3. Frissítse a funkciójelző regisztrációját OSSKUMigrationPreview a az provider register paranccsal.

   az provider register --namespace Microsoft.ContainerService
   

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. Migrálja a rendszercsomópontkészlet operációsrendszer-termékváltozatát az Azure Linuxba a az deployment group create 1mcupdate.json arm-sablonban található parancs és a ManagedClusters API használatával.

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

4. Migrálja a rendszercsomópontkészlet operációsrendszer-termékváltozatát az Ubuntuba a az deployment group create 2apupdate.json arm-sablonban található parancs és az AgentPools API használatával.

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

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". Győződjön meg arról, hogy a apiVersion beállítás értéke 2023-07-01 vagy újabb.
2. Telepítse újra az ARM-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.

• 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 (előzetes verzió).

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