Vrácení verzí fondu uzlů zpět v Azure Kubernetes Service (AKS)

Funkce vrácení verze fondu uzlů ve Azure Kubernetes Service (AKS) umožňuje zotavení po upgradu Kubernetes z neočekávaného chování. Pokud dojde k problémům, můžete vrátit fondy uzlů do předchozí kombinace verzí a imagí uzlů Kubernetes, čímž zajistíte kontinuitu podnikových procesů a minimalizujete výpadky. Tento článek vysvětluje, kdy a jak používat funkci vrácení zpět, její možnosti a omezení a osvědčené postupy pro akce po vrácení zpět.

Předpoklady

• Azure CLI verze 2.88.0 nebo novější. Pomocí příkazu najděte svoji verzi az --version . Pokud potřebujete nainstalovat nebo upgradovat, přečtěte si téma Instalace Azure CLI. Rozšíření aks-preview není povinné.
• Verze 2026-04-01 rozhraní API nebo novější.

Podporované funkce pro vrácení verze uzlové skupiny

Funkce vrácení verze fondu uzlů podporuje následující možnosti:

Vlastnost	Description
Zpětná verze	Obnoví verzi image Kubernetes i uzlu do předchozího stavu.
Ruční aktivace, automatické spuštění	Vrácení zpět vyžaduje ruční spuštění, ale jakmile se aktivuje, systém automaticky zpracuje celý proces vrácení zpět bez dalšího zásahu.
Kompatibilita poolu uzlů	Funguje na všech typech fondů uzlů, včetně fondů virtuálních počítačů i fondů uzlů založených na Virtual Machine Scale Sets (VMSS).
Podpora operačního systému	Kompatibilní se všemi skladovými jednotkami (SKU) operačního systému, včetně Ubuntu, Azure Linuxu a fondů Windows.
Zjednodušený proces	Nevyžaduje se žádná správa snímků.

Omezení a úvahy o vrácení fondu uzlů zpět

Mějte na paměti následující omezení při použití funkce vrácení zpět fondu uzlů.

• Omezeno pouze na změny verzí. Jiné změny fondu uzlů nebudou vráceny.
• Během vrácení zpět nejsou povoleny žádné souběžné operace.
• Před vrácením zpět musíte kanál automatického upgradu Kubernetes zakázat. Pokud je kanál upgradu operačního systému uzlu povolený, může vrácení verze Kubernetes pokračovat, ale předchozí image uzlu se nemusí obnovit. Pokud potřebujete vrátit zpět verzi Kubernetes i image uzlu, zakažte kanál upgradu operačního systému uzlu.
• K dispozici je pouze sedm dní po dokončení upgradu.
• Nelze provést více po sobě jdoucích vrácení k předchozím verzím.
• Vrácení zpět nepodporuje vrácení změn SKU operačního systému. Pokud jste změnili skladovou položku operačního systému vašeho fondu uzlů (například z Ubuntu na Azure Linux), pokusí se vrácení zpět obnovit předchozí verzi image uzlu, která patří do jiné skladové položky operačního systému a je odmítnutá. Pokud chcete vrátit změnu skladové položky operačního systému, použijte az aks nodepool update --os-sku místo toho příkaz.

Při použití obnovení skupiny uzlů je třeba mít na paměti následující skutečnosti:

Vliv na zabezpečení	Důležité informace o provozu
* Ohrožení zabezpečení: Vrácení zpět odebere opravy zabezpečení a aktualizace z novější verze. Proto doporučujeme použít vrácení zpět pouze dočasně při řešení problémů a pak co nejdříve provést upgrade.	* Přerušení služeb: Proces vrácení zpět může způsobit dočasné přerušení úloh. * Dostupnost prostředků: Zajistěte dostatečnou kapacitu pro operaci vrácení zpět. * Požadavky na testování: Před dalším pokusem o upgrade naplánujte opravu základních problémů.

Proč používat vrácení zpět

Vrácení zpět poskytuje kritický mechanismus obnovení pro produkční prostředí:

• Provozní kontinuita: Minimalizace výpadků, když upgrady způsobují neočekávané problémy
• Zmírnění rizik: Rychlé obnovení známých konfigurací bez složitých postupů obnovení
• Zjednodušené obnovení: Vyhněte se ručnímu zásahu nebo opětovnému sestavení clusterů ze záloh

Kdy použít vrácení nodového poolu

Zvažte vrácení zpět jako možnost obnovení v následujících scénářích:

• K selháním upgradu dochází: Problémy s infrastrukturou, omezení prostředků nebo problémy s kompatibilitou brání úspěšným upgradům.
• Přerušení aplikací: U úloh dochází k kritickým selháním nebo poškození dat s novějšími verzemi Kubernetes.
• Snížení výkonu: Nové verze způsobují nepřijatelnou latenci, problémy s propustností nebo spotřebu prostředků.
• Objeví se mezery při testování: Problémy v produkčním prostředí, které nebyly zachyceny během předprodukčního testování.

Pracovní postup obnovení předchozího stavu poolu uzlů

Následující diagram znázorňuje pracovní postup vrácení fondu uzlů zpět:

Proces vrácení změn obnoví všechny uzly ve fondu uzlů na jejich předchozí verzi. Mezi klíčové aspekty pracovního postupu patří:

• Přístup typu Vše nebo nic: Všechny uzly se musí úspěšně vrátit k předchozí verzi, aby bylo vrácení zpět úspěšně dokončeno. Pokud se některý uzel nepodaří vrátit zpět, celá operace selže, aby jasně komunikovali stav clusteru, podobně jako operace upgradu.
• Progress tracking: Monitorujte stav vrácení zpět pomocí protokolu aktivit Azure pro historii operací a rozhraní API stavu operace pro aktualizace v reálném čase.

Vrácení verze fondu uzlů

Důležité

Při vracení verze fondu uzlů mějte na paměti následující informace:

• Dlouhodobé udržování starších verzí zvyšuje rizika zabezpečení a může nakonec zabránit upgradům kvůli omezením nerovnoměrné distribuce verzí. Považovat vrácení zpět jako dočasný mechanismus obnovení, nikoli trvalé řešení.
• Vrácení změn nahrazuje uzly ve fondu uzlů a může dočasně narušit pracovní zátěže. Než začnete, ověřte, že vaše úlohy mají dostatečnou kapacitu a že Pod Disruption Budgets umožňují požadované přerušení uzlů.
• Při použití rozhraní REST API můžete nejprve volat Agent Pools - Get Upgrade Profile a načíst naposledy použité verze. Tyto informace použijte k určení cílové verze v požadavku vrácení zpět.

Příkaz Azure CLI vrácení zpět automaticky vybere naposledy zaznamenanou verzi, která se označuje také jako N-1. Příkaz nemůžete použít k výběru libovolné verze image Kubernetes nebo uzlu a nemůžete provést po sobě jdoucí vrácení zpět, abyste mohli procházet více předchozích verzí.

1. Zkontrolujte konfiguraci automatického upgradu clusteru.

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

   Před vrácením zpět zakažte kanál automatického upgradu Kubernetes. Pokud potřebujete obnovit předchozí image uzlu, zakažte také kanál upgradu operačního systému uzlu.

2. Pomocí příkazu az aks nodepool get-rollback-versions zkontrolujte dostupný cíl vrácení zpět.

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

   Pokud příkaz nevrátí žádné verze, fond uzlů nemá vhodný cíl pro návrat zpět. Skupina uzlů musí být upgradována během předchozích sedmi dnů a zaznamenaná verze Kubernetes musí být stále podporována službou AKS.

3. Vraťte skupinu uzlů zpět pomocí příkazu az aks nodepool rollback.

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

4. Po dokončení vrácení zpět ověřte verzi Kubernetes, verzi image uzlu a stav zřizování.

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

   Úspěšné vrácení zpět vrátí Succeeded pro provisioningState a zobrazí zaznamenané verze imagí Kubernetes a uzlů.

Pokud jste změnili nastavení automatického upgradu clusteru před vrácením zpět, obnovte zamýšlená nastavení po prozkoumání a vyřešení problému s upgradem.

Monitorování stavu zrušení fondu uzlů

Pomocí následujících metod můžete monitorovat stav operace vrácení fondu uzlů zpět a ověřit úspěšné vrácení zpět:

• Vyhledejte protokoly aktivit v clusteru.
• Vyhledejte konkrétní události související s upgradem v clusteru.
• Přihlaste se k odběru událostí AKS pomocí Azure Event Grid.
• Pokud se přihlásíte k odběru kanálu automatického upgradu, můžete k oznámením o upgradu použít AKS Communication Manager .

Řešení potíží s vrácením poolu uzlů zpět

Následující tabulka popisuje běžné problémy se vrácením zpět a jejich řešení:

Problém	Příčina a řešení
Nevracejí se žádné verze pro vrácení změn.	Pool uzlů nemusí mít žádný zaznamenaný upgrade, vypršela platnost sedmidenního okna vrácení zpět nebo se už nemusí podporovat předchozí verze Kubernetes. Zkontrolujte historii upgradu fondu uzlů a zásady podpory verzí AKS Kubernetes.
AKS hlásí, že probíhá jiná operace.	Počkejte, než se dokončí aktuální operace clusteru nebo fondu uzlů, a teprve potom zkuste vrácení zpět. Pokud potřebujete operaci zastavit, použijte az aks nodepool operation-abort příkaz.
Verze Kubernetes se vrátí na předchozí verzi, ale image uzlu se nevrátí na předchozí verzi.	Kanál upgradu operačního systému uzlu může být povolený. Pokud potřebujete obnovit předchozí image uzlu, zakažte kanál.
AKS odmítne předchozí verzi bitové kopie uzlu.	SKU operačního systému poolu uzlů se mohlo od zaznamenané verze změnit. Vrácení zpět nepodporuje vrácení změn SKU operačního systému. Místo toho použijte az aks nodepool update --os-sku k vrácení SKU operačního systému.
AKS odmítá předchozí verzi Kubernetes.	Zaznamenaná verze už nemusí být podporovaná. Zkontrolujte zásady podpory verze AKS Kubernetes.

Osvědčené postupy po vrácení zpět

Po úspěšném vrácení fondu uzlů použijte následující osvědčené postupy pro zajištění stability a zabezpečení:

• Prozkoumejte původní příčinu: Zjistěte, proč se upgrade nezdařil před pokusem o jiný upgrade. Zkontrolujte protokoly aplikací, metriky prostředků a požadavky na kompatibilitu.
• Testování v neprodukčním prostředí: Před opětovným upgradem produkčního prostředí ověřte novější verzi ve vývojovém nebo přípravném prostředí a reprodukujte a vyřešte problémy.
• Naplánujte si opětovný upgrade: Nechoďte na neomezenou dobu na verzi vrácenou zpět. Naplánujte opětovný upgrade, aby se zachovaly opravy zabezpečení a podpora:
  • V případě kritických problémů se zabezpečením: Po ověření oprav proveďte opětovné upgrade během několika dnů.
  • Problémy s kompatibilitou aplikací: Opětovné upgrade během týdnů po úpravách kódu.
  • Maximální doporučený časový rámec: 30 dní, abyste se vyhnuli shromáždění ohrožení zabezpečení.

Nejčastější dotazy

Můžu během vrácení fondu uzlů provést jiné operace?

Ne, vrácení zpět musí být dokončeno před spuštěním dalších operací. Pokud chcete provést různé operace, nejprve přerušte vrácení zpět.

Vrátí fond uzlů zpět jak verzi Kubernetes, tak i obraz uzlu?

Ano, vrácení se vrátí k naposledy použité verzi Kubernetes a jejímu odpovídajícímu obrazu uzlu. Pokud se obě komponenty změnily, systém obnoví předchozí verzi Kubernetes s poslední kompatibilní imagí uzlu pro danou verzi.

Můžu vrátit zpět jenom obraz uzlu, aniž by došlo ke změně verze fondu uzlů?

Ano, pokud jste během posledních sedmi dnů provedli pouze aktualizaci bitové kopie uzlu (bez upgradu verze poolu uzlů), vrácení obnoví předchozí bitovou kopii virtuálního pevného disku (VHD) a zachová stejnou verzi Kubernetes.

Můžu se vrátit k verzi, která je mimo podporu?

Ne, nemůžete se vrátit k verzi Kubernetes, kterou už AKS nepodporuje. Pokud byl například fond uzlů ve verzi 1.27.9 (teď není podporovaný) a upgradovali jste na verzi 1.28.5, nemůžete se vrátit na verzi 1.27.9, protože už není v seznamu podporovaných verzí. Vždy zkontrolujte zásady podpory verze AKS Kubernetes a ověřte dostupnost verze.

Ze stejného důvodu nemůžete vrátit zpět upgrade iniciovaný platformou. Když AKS upgraduje cluster tak, aby už neběžel na nepodporované verzi, předchozí verze už není k dispozici.

Musím před vrácením node poolu zakázat automatické upgrady?

Ano, před vrácením zpět je nutné zakázat kanál automatického upgradu Kubernetes. Pokud povolíte pouze kanál upgradu operačního systému uzlu, může vrácení verze Kubernetes pokračovat, ale předchozí image uzlu se nemusí obnovit. Pokud potřebujete vrátit zpět verzi Kubernetes i image uzlu, zakažte kanál upgradu operačního systému uzlu.

Pokud je cluster součástí skupiny aktualizací v profilu automatické aktualizace Správce flotily Azure Kubernetes, musíte cluster před vrácením zpět také odebrat ze skupiny aktualizací. Jinak může proces automatického upgradu po dokončení vrácení zpět znovu automaticky upgradovat váš fond uzlů.

Můžu se vrátit zpět po změně skladové položky operačního systému (například z Ubuntu na Azure Linux)?

Ne. Vrácení fondu uzlů je omezeno na změny verzí a neobnoví změny SKU operačního systému. Po migraci z jedné skladové položky operačního systému na jinou (například Ubuntu na Azure Linux) patří předchozí verze image uzlu do staré skladové položky operačního systému a není kompatibilní s aktuální konfigurací. Operace vrácení zpět odmítne předchozí verzi image s chybou podobnou této:

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

Pokud chcete vrátit skladovou položku operačního systému, použijte az aks nodepool update příkaz s parametrem --os-sku . Další informace najdete v tématu Vrácení zpět verze operačního systému.

Související obsah

Další informace o upgradech fondů uzlů v AKS najdete v následujících článcích:

• Konfigurujte upgrady fondu s modrými zelenými uzly v Azure Kubernetes Service (AKS)
• Konfigurujte postupné upgrady pro fondy uzlů Azure Kubernetes Service (AKS)
• image operačního systému uzlu Autoupgrade v Azure Kubernetes Service (AKS)