Csomópontkészlet-verziók visszaállítása a Azure Kubernetes Service (AKS)

A csomópontkészlet verzió-visszaállítási funkciója az Azure Kubernetes Service (AKS)-ben lehetővé teszi a váratlan viselkedésekből való helyreállítást a Kubernetes frissítések után. Ha problémák lépnek fel, visszaállíthatja a csomópontkészleteket az előző Kubernetes-verzióra és a csomópontrendszerkép-kombinációra, biztosítva az üzletmenet folytonosságát és minimalizálva az állásidőt. Ez a cikk bemutatja, hogy mikor és hogyan használhatja a visszaállítási funkciót, annak képességeit és korlátait, valamint a visszaállítás utáni műveletek ajánlott eljárásait.

Előfeltételek

• Azure CLI 2.88.0-s vagy újabb verziója. Keresse meg az Ön verzióját a az --version parancs használatával. Ha telepítenie vagy frissítenie kell, tekintse meg a Install Azure CLI című témakört. A aks-preview bővítmény nem szükséges.
• API-verzió 2026-04-01 vagy újabb.

A csomópontkészlet verzió-visszaállításának támogatott funkciói

A csomópontkészlet verzió-visszaállítási funkciója a következő képességeket támogatja:

Tulajdonság	Description
Verzió visszaállítása	A Kubernetes és a csomópont rendszerképének korábbi állapotát is visszaállítja.
Manuális eseményindító, automatikus végrehajtás	A visszaállítás manuális kezdeményezést igényel, de az aktiválás után a rendszer további beavatkozás nélkül automatikusan kezeli a teljes visszaállítási folyamatot.
Csomópontkészlet kompatibilitása	A csomópontkészletek minden típusán működik, beleértve a virtuálisgép-készleteket és a Virtual Machine Scale Sets (VMSS)-alapú csomópontkészleteket is.
Operációs rendszer támogatása	Kompatibilis az összes operációsrendszer-készletmegőrzési egységgel (SKU- val), beleértve az Ubuntu-t, Azure Linuxot és Windows készleteket.
Egyszerűsített folyamat	Nincs szükség pillanatkép-kezelésre.

A csomópontkészlet visszaállítási korlátozásai és szempontjai

Tartsa szem előtt az alábbi korlátozásokat a csomópontkészlet visszaállítási funkciójának használatakor:

• Csak a verziómódosításra korlátozódik. A csomópontkészlet egyéb módosításai nem lesznek visszaállítva.
• A visszaállítás során nem engedélyezett egyidejű műveletek.
• A kubernetes automatikus frissítési csatornát a visszaállítás előtt le kell tiltania. Ha a csomópont operációsrendszer-frissítési csatornája engedélyezve van, a Kubernetes-verzió visszaállítása folytatódhat, de előfordulhat, hogy az előző csomópontkép esetleg nem állítható vissza. Tiltsa le a csomópont operációsrendszer-frissítési csatornát, ha a Kubernetes-verziót és a csomópont lemezképét is vissza kell állítania.
• Csak a frissítés befejezését követő hét napig érhető el.
• Nem lehet egymást követő visszaállításokat végrehajtani több verzió visszaállításához.
• A visszaállítás nem támogatja az operációsrendszer-termékváltozat módosításainak visszaállítását. Ha módosította a csomópontkészlet operációsrendszer-termékváltozatát (például Ubuntu-ról Azure Linuxra), a visszaállítás megkísérli visszaállítani az előző csomópontrendszerkép-verziót, amely egy másik operációsrendszer-termékváltozathoz tartozik, és elutasítja. Az operációsrendszer-termékváltozat módosításának visszaállításához használja inkább a az aks nodepool update --os-sku parancsot.

Tartsa szem előtt a következő szempontokat a csomópontkészlet visszaállításának használatakor:

Biztonsági következmények	Működési szempontok
* Biztonsági rések kitettsége: A visszaállítás eltávolítja a biztonsági javításokat és frissítéseket az újabb verzióból. Ezért azt javasoljuk, hogy csak ideiglenesen használja a visszaállítást a problémák megoldása során, majd a lehető leghamarabb frissítse újra.	* Szolgáltatáskimaradás: A visszaállítási folyamat ideiglenes számítási feladatkimaradásokat okozhat. * Erőforrás rendelkezésre állása: Elegendő kapacitás biztosítása a visszaállítási művelethez. * Tesztelési követelmények: Tervezze meg a mögöttes problémák megoldását, mielőtt újra megkísérli a frissítést.

Miért érdemes a visszaállítást használni?

A visszaállítás kritikus helyreállítási mechanizmust biztosít az éles környezetekhez:

• Üzletmenet-folytonosság: Az állásidő minimalizálása, ha a frissítések váratlan problémákat okoznak
• Kockázatcsökkentés: Az ismerten jó konfigurációk gyors visszaállítása összetett helyreállítási eljárások nélkül
• Egyszerűsített helyreállítás: A manuális beavatkozás vagy a biztonsági másolatokból történő fürt újraépítés elkerülése

Mikor érdemes a node pool visszaállítását alkalmazni?

Fontolja meg a visszaállítást helyreállítási lehetőségként az alábbi esetekben:

• Frissítési hibák lépnek fel: Az infrastruktúra problémái, az erőforrás-korlátozások vagy a kompatibilitási problémák megakadályozzák a sikeres frissítéseket.
• Alkalmazástörés: A számítási feladatok kritikus hibákat vagy adatsérülést tapasztalnak az újabb Kubernetes-verziókban.
• Teljesítménycsökkenés: Az új verziók elfogadhatatlan késést, átviteli sebességet vagy erőforrás-felhasználást okoznak.
• Tesztelési hiányosságok merülnek fel: Olyan problémák merülnek fel az éles környezetben, amelyeket nem észleltek az éles üzem előtti tesztelés során.

Csomópontkészlet visszaállítási munkafolyamata

Az alábbi ábra a csomópontkészlet visszaállítási munkafolyamatát mutatja be:

A visszaállítási folyamat visszaállítja a csomópontkészlet összes csomópontját a korábbi verzióállapotra. A munkafolyamat főbb szempontjai a következők:

• Minden vagy semmi megközelítés: Minden csomópontnak sikeresen vissza kell térnie az előző verzióra a visszaállítás sikeres befejezéséhez. Ha egy csomópont nem tud visszagördülni, a teljes művelet meghiúsul. Ennek célja a fürt állapotának egyértelmű közlése, hasonlóan a frissítési művelethez.
• Progress tracking: A visszaállítás állapotát a műveletelőzményekhez az Azure tevékenységnapló, valós idejű frissítésekhez pedig a Műveletállapot API használatával lehet monitorozni.

Csomópontkészlet verziójának visszaállítása

Fontos

A csomópontkészlet verziójának visszaállításakor tartsa szem előtt az alábbi információkat:

• A régebbi verziók hosszú távú használata növeli a biztonsági kockázatokat, és előfordulhat, hogy a verzióeltérési korlátozások miatt a frissítéseket is megelőzi. A visszaállítást ideiglenes helyreállítási mechanizmusként, nem pedig állandó megoldásként kezelje.
• A visszagörgetés lecseréli a csomópontkészlet csomópontjait, és ideiglenesen megzavarhatja a számítási feladatokat. Mielőtt hozzákezd, ellenőrizd, hogy a számítási feladatok elegendő kapacitással rendelkeznek-e, és hogy a Pod Disruption Budgetek engedélyezik-e a csomópontok szükséges megszakításait.
• A REST API használatakor meghívhatja az Agent Pools - Get Upgrade Profile API-t, hogy lekérje a legutóbb használt verziókat. Ezen információk segítségével megadhatja a célverziót a visszaállítási kérelemben.

A Azure CLI visszaállítási parancs automatikusan kiválasztja a legutóbb rögzített verziót, más néven N-1-et. A parancs nem használható tetszőleges Kubernetes- vagy csomópont-rendszerképverzió kiválasztására, és nem hajthat végre egymást követő visszaállításokat több korábbi verzió közötti váltáshoz.

1. Tekintse át a fürt automatikus frissítési konfigurációját.

   az aks show \
       --name myAKSCluster \
       --resource-group myResourceGroup \
       --query autoUpgradeProfile
   

   Tiltsa le a Kubernetes automatikus frissítési csatornáját a visszaállítás előtt. Ha vissza kell állítania az előző csomópont lemezképét, tiltsa le a csomópont operációsrendszer-frissítési csatornát is.

2. Tekintse át az elérhető visszaállítási célt a az aks nodepool get-rollback-versions parancs használatával.

   az aks nodepool get-rollback-versions \
       --name myNodePool \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster
   

   Ha a parancs nem ad vissza verziókat, a node pool nem rendelkezik jogosult visszaállítási céllal. A csomópontkészletet az elmúlt hét napban frissíteni kellett, és a rögzített Kubernetes-verziót továbbra is támogatnia kell az AKS-nek.

3. A parancs használatával visszaállíthatja a csomópontkészletet az aks nodepool rollback .

   az aks nodepool rollback \
       --name myNodePool \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster
   

4. Ellenőrizze a Kubernetes-verziót, a csomópont lemezképének verzióját és a kiépítés állapotát a visszaállítás befejezése után.

   az aks nodepool show \
       --name myNodePool \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --query '{provisioningState:provisioningState,kubernetesVersion:currentOrchestratorVersion,nodeImageVersion:nodeImageVersion}'
   

   A sikeres visszaállítás provisioningState esetén Succeeded értéket ad vissza, és megjeleníti a rögzített Kubernetes- és csomópont-lemezképverziókat.

Ha a visszaállítás előtt módosította a fürt automatikus frissítési beállításait, a frissítési probléma kivizsgálása és megoldása után állítsa vissza a kívánt beállításokat.

Csomópontkészlet visszaállítási állapotának figyelése

A csomópontkészlet-visszaállítási művelet állapotát az alábbi módszerekkel figyelheti, és ellenőrizheti a sikeres visszaállítást:

• Nézze meg a tevékenységnaplókat a fürtön.
• Keressen bizonyos frissítéssel kapcsolatos eseményeket a fürtön.
• Iratkozzon fel AKS-eseményekre Azure Event Grid.
• Ha feliratkozik egy automatikus frissítési csatornára, az AKS Communication Managert használhatja a frissítési értesítésekhez.

Csomópontkészlet visszaállításának hibaelhárítása

Az alábbi táblázat a gyakori visszaállítási problémákat és azok megoldását ismerteti:

Probléma	Ok és megoldás
A visszagörgetési verziók nem kerülnek visszaadásra.	Előfordulhat, hogy a csomópontkészlet nem rendelkezik rögzített verziófrissítéssel, a hét napos visszaállítási időszak lejárt, vagy a Kubernetes korábbi verziója már nem támogatott. Ellenőrizze a csomópontkészlet frissítési előzményeit és az AKS Kubernetes verziótámogatási szabályzatát.
Az AKS azt jelzi, hogy egy másik művelet is folyamatban van.	A visszaállítás újrapróbálkozása előtt várja meg, amíg az aktuális fürt- vagy csomópontkészlet-művelet befejeződik. Ha le kell állítania a műveletet, használja a az aks nodepool operation-abort parancsot.
A Kubernetes-verzió visszagördül, de a csomópontkép nem.	Lehetséges, hogy a csomópont operációsrendszer-frissítési csatornája engedélyezve van. Tiltsa le a channelt, ha vissza kell állítania az előző node image-et.
Az AKS elutasítja az előző csomópont lemezképének verzióját.	A csomópontkészlet operációsrendszer-termékváltozata a rögzített verzió óta változhatott. A visszaállítás nem támogatja az operációsrendszer-termékváltozat módosításainak visszaállítását. Ehelyett az operációs rendszer SKU-jának visszaállítására használható a az aks nodepool update --os-sku.
Az AKS elutasítja az előző Kubernetes-verziót.	Előfordulhat, hogy a rögzített verzió már nem támogatott. Ellenőrizze az AKS Kubernetes verziótámogatási szabályzatát.

A visszaállítás utáni ajánlott eljárások

A csomópontkészlet sikeres visszaállítása után a stabilitás és a biztonság biztosítása érdekében kövesse az alábbi ajánlott eljárásokat:

• Vizsgálja meg a kiváltó okot: Állapítsa meg, hogy a frissítés miért nem sikerült, mielőtt újabb frissítést kísérelt meg. Tekintse át az alkalmazásnaplókat, az erőforrásmetrikákat és a kompatibilitási követelményeket.
• Tesztelés nem éles környezetben: Ellenőrizze az újabb verziót egy fejlesztési vagy előkészítési környezetben a problémák reprodukálása és megoldása érdekében, mielőtt ismételten frissítené az éles környezetet.
• Tervezze meg az újrafrissítést: Ne maradjon határozatlan ideig a visszagördült verzión. Ütemezzen újrafrissítést a biztonsági javítások és a támogatás fenntartása érdekében:
  • Kritikus biztonsági problémák esetén: A javítások ellenőrzése után napokon belül frissítse újra a frissítést.
  • Alkalmazáskompatibilitási problémák esetén: A kódmódosítások után heteken belül újra frissíthet.
  • Javasolt maximális időkeret: 30 nap a biztonsági rések felhalmozódásának elkerülése érdekében.

Gyakori kérdések (GYIK)

Végezhetek más műveleteket a csomópontkészlet visszaállítása során?

Nem, a visszaállításnak be kell fejeződnie, mielőtt más műveleteket indítanának. A különböző műveletek végrehajtásához először megszakítsa a visszaállítást.

Visszaállítja a csomópontkészlet visszaállítása során a Kubernetes-verziót és a csomópont-képet is?

Igen, a visszaállítás visszaáll a legutóbb használt Kubernetes-verzióra és annak megfelelő csomópontrendszerképére. Ha mindkét összetevő megváltozott, a rendszer visszaállítja az előző Kubernetes-verziót az adott verzió utolsó kompatibilis csomópontrendszerképével.

Csak a csomópontrendszerképet állíthatom vissza a csomópontkészlet verziójának módosítása nélkül?

Igen, ha csak egy csomópontrendszerkép-frissítést hajtott végre az elmúlt hét napban (a csomópontkészlet verziójának frissítése nélkül), a visszaállítás visszaállítja az előző virtuális merevlemez -lemezképet, miközben megtartja ugyanazt a Kubernetes-verziót.

Vissza tudok állítani egy olyan verziót, amely nem támogatott?

Nem, az AKS által már nem támogatott Kubernetes-verzióra nem lehet visszatérni. Ha például a csomópontkészlet az 1.27.9-es verzión volt (most már nem támogatott), és az 1.28.5-ös verzióra frissített, akkor nem lehet visszaváltani az 1.27.9-es verzióra, mert már nem szerepel a támogatott verziólistában. Mindig ellenőrizze az AKS Kubernetes verziótámogatási szabályzatát a verzió rendelkezésre állásának ellenőrzéséhez.

Ugyanebből az okból nem vonhatja vissza a platform által kezdeményezett frissítést. Ha az AKS egy már nem támogatott verzióról frissíti a fürtöt, az előző verzió többé nem érhető el.

Le kell tiltani az automatikus frissítést, mielőtt végrehajtja a csomópontkészlet visszaállítását?

Igen, a visszaállítás előtt le kell tiltania a Kubernetes automatikus frissítési csatornát. Ha csak a csomópont operációsrendszer-frissítési csatornát engedélyezi, a Kubernetes-verzió visszaállítása folytatódhat, de előfordulhat, hogy az előző csomópontkép nem állítható vissza. Tiltsa le a csomópont operációsrendszer-frissítési csatornát, ha a Kubernetes-verziót és a csomópont lemezképét is vissza kell állítania.

Ha a fürt szerepel egy frissítési csoportban egy Azure Kubernetes Fleet Manager automatikus frissítési profilban, a visszagörgetés végrehajtása előtt el kell távolítania a fürtöt a frissítési csoportból. Ellenkező esetben előfordulhat, hogy az automatikus frissítési folyamat automatikusan frissíti a csomópontkészletet a visszaállítás befejezése után.

Visszaválthatok az operációsrendszer-termékváltozat módosítása után (például Ubuntu-ról Azure Linuxra)?

Nem. A csomópontkészlet visszaállítása verziómódosításra korlátozódik, és nem fordítja vissza az operációsrendszer-termékváltozat módosításait. Az egyik operációsrendszer-termékváltozatról a másikra (például Ubunturól Azure Linuxra) való migrálás után az előző csomópontrendszerkép verziója a régi operációsrendszer-termékváltozathoz tartozik, és nem kompatibilis az aktuális konfigurációval. A visszaállítási művelet elutasítja az előző lemezképverziót a következőhöz hasonló hibával:

NodeImageVersion 'AKSUbuntu-2204gen2containerd-202602.13.5' is not accepted. NodeImageVersion can only be current version 'AKSAzureLinux-V3gen2-202602.13.5' or 'latest'

Az operációsrendszer-termékváltozat visszaállításához használja a az aks nodepool update parancsot a --os-sku paraméterrel. További információ: Az operációs rendszer verziójának visszaállítása.

Kapcsolódó tartalom

Az AKS csomópontkészlet-frissítéseiről az alábbi cikkekben olvashat bővebben:

• Konfigurálja a kék-zöld csomópontkészlet frissítéseit a Azure Kubernetes Service (AKS)
• Folyamatos frissítések konfigurálása az Azure Kubernetes Szolgáltatás (AKS) csomópontcsoportjainál
• Autoupgrade a csomópontok operációs rendszer képeire az Azure Kubernetes Service (AKS)-ben