Durchführen eines Upgrades für einen Azure Kubernetes Service-Cluster (AKS)
Gilt für: Azure Local, Version 23H2
Im Rahmen der Verwaltung des Anwendungs- und Clusterlebenszyklus sollten Sie ein Upgrade auf die neueste verfügbare Version von Kubernetes durchführen. Ein Upgrade umfasst entweder einen Wechsel zu einer neueren Version von Kubernetes, das Anwenden von Betriebssystemversionsupdates (Betriebssystemupdates) (Patching) oder beides. AKS Arc unterstützt Upgrades (oder Patching)-Knoten in einem Workloadcluster mit den neuesten Betriebssystem- und Laufzeitupdates.
Alle Upgrades werden kontinuierlich und fortlaufend ausgeführt, um eine unterbrechungsfreie Verfügbarkeit von Workloads sicherzustellen. Wenn ein neuer Kubernetes-Workerknoten mit einem neueren Build in den Cluster integriert wird, werden die Ressourcen vom alten Knoten auf den neuen Knoten verschoben. Anschließend wird der alte Knoten außer Betrieb genommen und aus dem Cluster entfernt.
Voraussetzungen
Bei Verwendung der Azure CLI ist für diesen Artikel Azure CLI-Version 2.34.1 oder höher erforderlich. Führen Sie az --version aus, um die Version zu finden. Wenn Sie CLI installieren oder aktualisieren müssen, lesen Sie " Installieren von Azure CLI".
Überprüfen auf verfügbare Upgrades
Überprüfen Sie, welche Kubernetes-Versionen für Ihren Cluster verfügbar sind, indem Sie den folgenden Befehl verwenden:
az aksarc get-upgrades --resource-group myResourceGroup --name myAKSCluster
Die folgende Beispielausgabe zeigt die aktuelle Version als 1.24.11 und listet die verfügbaren Versionen unter 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",
...
}
Aktualisieren der Kubernetes-Version
Beim Upgrade eines unterstützten AKS-Clusters können Sie Nebenversionen von Kubernetes nicht überspringen. Sie müssen alle Upgrades nacheinander nach der Hauptversionsnummer ausführen. Beispielsweise sind Upgrades von 1.24.x auf 1.25.x oder 1.25.x auf 1.26.x zulässig. 1.24.x bis 1.26.x ist nicht zulässig.
Hinweis
Ist kein Patch angegeben, wird der Cluster automatisch auf den neuesten GA-Patch der angegebenen Nebenversion aktualisiert. Die Einstellung --kubernetes-version auf 1,25 führt z. B. zum Upgrade des Clusters auf 1.25.7.
Sie können ihren Cluster mit dem folgenden Befehl aktualisieren:
az aksarc upgrade \
--resource-group myResourceGroup \
--name myAKSCluster \
--kubernetes-version <KUBERNETES_VERSION>
Bestätigen Sie, dass das Upgrade erfolgreich war, indem Sie den show Befehl verwenden:
az aksarc show --resource-group myResourceGroup --name myAKSCluster
Die folgende Beispielausgabe zeigt, dass der Cluster jetzt 1.25.7 ausführt:
{
"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"
}
Wichtig
Wenn Sie ein Upgrade von einer nicht unterstützten Version durchführen, die zwei oder mehr Nebenversionen überspringt, kann das Upgrade keine ordnungsgemäße Funktionalität garantieren. Wenn Ihre Version erheblich veraltet ist, empfehlen wir Ihnen, Ihren Cluster stattdessen neu zu erstellen.
Während eines Upgradevorgangs zeigen sowohl die currentState provisioningState Indikatoren als auch die Indikatoren eine Aktualisierungsmeldung an, um den laufenden Prozess widerzuspiegeln. Wenn der Vorgang jedoch ausgeht, provisioningState wird "Fehlgeschlagen" angezeigt, während "currentStateUpgrade" weiterhin angezeigt wird, während das Upgrade im Hintergrund fortgesetzt wird. Es ist keine Aktion erforderlich; das Upgrade fortgesetzt wird, bis es abgeschlossen ist.
Betriebssystemversion aktualisieren
Das Aktualisieren von Workerknoten auf eine neuere Version des Knotenimages ohne Ändern der Kubernetes-Version funktioniert nur, wenn für das neue Image keine andere Kubernetes-Version erforderlich ist. Derzeit unterstützt AKS Arc keine Nur-Knoten-Image-Updates für alle Kubernetes-Versionen, die unterstützt werden. Wenn Sie das Knotenimage aktualisieren müssen, müssen Sie den Cluster auf die neueste Kubernetes-Version aktualisieren, um sicherzustellen, dass alle Knotenimageupdates integriert sind.
Wichtig
Wenn Sie versuchen, die node-image-only Kennzeichnung zu verwenden, erhalten Sie eine Meldung, die angibt, dass dieses Feature noch nicht unterstützt wird.