Upgrade clusteru Azure Kubernetes Service (AKS)

  • Článek

Platí pro: Azure Stack HCI verze 23H2

V rámci 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 (opravy) nebo obojí. AKS Arc podporuje upgrade (nebo opravy) uzlů v clusteru úloh s nejnovějšími aktualizacemi operačního systému a modulu runtime.

Všechny upgrady se provádějí nepřetržitě a průběžně, aby byla zajištěna nepřerušená dostupnost úloh. Když se do clusteru přenese nový pracovní uzel Kubernetes s novějším sestavením, prostředky se přesunou ze starého uzlu do nového uzlu. Po úspěšném dokončení se starý uzel vyřadí z provozu a odebere se 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 dostupné:

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ádět postupně podle čísla hlavní verze. Jsou například povoleny upgrady z verze 1.24.x na verzi 1.25.x nebo z 1.25.x na verzi 1.26.x . Verze 1.24.x na 1.26.x nejsou povoleny.

Poznámka

Pokud není zadána žádná oprava, cluster se automaticky upgraduje na nejnovější opravu GA určené 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ěží na 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é

Pokud provedete upgrade z nepodporované verze, která přeskočí dvě nebo více podverze, upgrade nemůže zaručit správnou funkčnost. Pokud je vaše verze výrazně za zastaralý, doporučujeme místo toho cluster vytvořit znovu.

Během operace upgradu indikátory provisioningState a currentState zobrazují zprávu Upgrade , která odráží probíhající proces. Pokud však vyprší časový limit operace, provisioningState zobrazí se chyba, zatímco currentState upgrade bude dál zobrazovat upgrade , protože upgrade pokračuje na pozadí. Nevyžaduje se žádná akce. upgrade bude pokračovat, dokud se nedokončí.

Aktualizace verze operačního systému

Aktualizace pracovních uzlů na novější verzi image uzlu bez změny verze Kubernetes funguje jenom v případě, že nová image nevyžaduje jinou verzi Kubernetes. V současné době AKS Arc nepodporuje aktualizace jen pro image uzlů ve všech verzích Kubernetes, které jsou podporované. Pokud potřebujete aktualizovat image uzlu, musíte cluster upgradovat na nejnovější verzi Kubernetes, aby se zajistilo, že budou zahrnuty všechny aktualizace image uzlu.

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á.

Další kroky