Upgrade clusteru Azure Kubernetes Service (AKS)
Platí pro: Azure Local, verze 23H2
Jako součást správy životního cyklu aplikace a clusteru můžete chtít upgradovat na nejnovější dostupnou verzi Kubernetes. Upgrade zahrnuje buď přechod na novější verzi Kubernetes, použití aktualizací verzí operačního systému (OS) (opravy) nebo obojí. AKS Arc podporuje upgradování (nebo opravy) uzlů v clusteru úloh s nejnovějšími aktualizacemi operačního systému a modulu runtime.
Všechny upgrady se spouštějí nepřetržitě a průběžně, aby se zajistila nepřerušovaná dostupnost úloh. Když se do clusteru přenese nový pracovní uzel Kubernetes s novějším buildem, přesunou se prostředky ze starého uzlu do nového uzlu. Po úspěšném dokončení se starý uzel vyřadí z provozu a odebere z clusteru.
Než začnete
Pokud používáte Azure CLI, tento článek vyžaduje Azure CLI verze 2.34.1 nebo novější. Verzi zjistíte spuštěním příkazu az --version. Pokud potřebujete nainstalovat nebo upgradovat rozhraní příkazového řádku, přečtěte si téma Instalace Azure CLI.
Kontrola dostupných upgradů
Pomocí následujícího příkazu zkontrolujte, které verze Kubernetes jsou pro váš cluster k dispozici:
az aksarc get-upgrades --resource-group myResourceGroup --name myAKSCluster
Následující příklad výstupu ukazuje aktuální verzi jako 1.24.11 a uvádí dostupné verze v části upgrades:
{
"agentPoolProfiles": [
{
"kubernetesVersion": "1.24.11",
"upgrades": [
{
"kubernetesVersion": "1.25.7"
}
]
}
],
"controlPlaneProfile": {
"kubernetesVersion": "1.24.11",
"name": "aksarc-testupgrade",
"osType": "Linux",
"upgrades": [
{
"kubernetesVersion": "1.25.7"
}
]
},
...
"provisioningState": "Succeeded",
...
}
Upgrade verze Kubernetes
Při upgradu podporovaného clusteru AKS nemůžete přeskočit podverze Kubernetes. Všechny upgrady musíte provést postupně podle čísla hlavní verze. Jsou povoleny například upgrady z verze 1.24.x na 1.25.x nebo 1.25.x na 1.26.x . Verze 1.24.x až 1.26.x není povolená.
Poznámka:
Pokud není zadána žádná oprava, cluster se automaticky upgraduje na nejnovější opravu GA zadané podverze. Například nastavení --kubernetes-version na 1.25 způsobí upgrade clusteru na verzi 1.25.7.
Cluster můžete upgradovat pomocí následujícího příkazu:
az aksarc upgrade \
--resource-group myResourceGroup \
--name myAKSCluster \
--kubernetes-version <KUBERNETES_VERSION>
Pomocí příkazu ověřte, že upgrade proběhl úspěšně show :
az aksarc show --resource-group myResourceGroup --name myAKSCluster
Následující příklad výstupu ukazuje, že cluster teď běží 1.25.7:
{
"extendedLocation": {
"name":
"/subscriptions/<subscription>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom
location>",
"type": "CustomLocation"
},
"id": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/Microsoft.Kubernetes/connectedClusters/aksarc-testupgrade/providers/Microsoft.HybridContainerService/provisionedClusterInstances/default",
"name": "default",
"properties": {
"agentPoolProfiles": [
{
}
],
"controlPlane": {
"availabilityZones": null,
"controlPlaneEndpoint": {
"hostIp": null,
"port": null
},
"count": 1,
"linuxProfile": {
"ssh": {
"publicKeys": null
}
},
"name": null,
"nodeImageVersion": null,
"osSku": "CBLMariner",
"osType": "Linux",
"vmSize": "Standard_A4_v2"
},
"kubernetesVersion": "1.25.7",
...
"provisioningState": "Succeeded",
...
},
....
"type": "microsoft.hybridcontainerservice/provisionedclusterinstances"
}
Důležité
Když provedete upgrade z nepodporované verze, která přeskočí dvě nebo více podverzí, upgrade nezaručuje správnou funkčnost. Pokud je vaše verze výrazně zaplněná, doporučujeme místo toho cluster vytvořit znovu.
Během operace upgradu zobrazují indikátory provisioningState currentState zprávu o upgradu, která bude odrážet probíhající proces. Pokud však vyprší časový limit operace, provisioningState zobrazí se chyba, zatímco se bude dál zobrazovat upgrade, protože currentState upgrade pokračuje na pozadí. Nevyžaduje se žádná akce; upgrade bude pokračovat, dokud se nedokončí.
Aktualizace verze operačního systému (OS)
Aktualizace pracovních uzlů na novější verzi image uzlu beze změny verze Kubernetes funguje jenom v případě, že nová image nevyžaduje jinou verzi Kubernetes. AKS Arc v současné době nepodporuje aktualizace jen image uzlu ve všech verzích Kubernetes, které podporují. Pokud potřebujete aktualizovat image uzlu, musíte cluster upgradovat na nejnovější verzi Kubernetes, abyste měli jistotu, že jsou zahrnuty všechny aktualizace imagí uzlů.
Důležité
Při pokusu o použití příznaku node-image-only se zobrazí zpráva oznamující, že tato funkce ještě není podporovaná.