Een AKS-cluster (Azure Kubernetes Service) upgraden
Van toepassing op: Azure Local, versie 23H2
Als onderdeel van het beheren van de levenscyclus van toepassingen en clusters, wilt u mogelijk upgraden naar de nieuwste beschikbare versie van Kubernetes. Een upgrade omvat een overstap naar een nieuwere versie van Kubernetes, het toepassen van besturingssysteemversie-updates (patching) of beide. AKS Arc biedt ondersteuning voor het upgraden (of patchen) van knooppunten in een workloadcluster met de meest recente updates voor het besturingssysteem en de runtime.
Alle upgrades worden doorlopend uitgevoerd om een ononderbroken beschikbaarheid van workloads te garanderen. Wanneer een nieuw Kubernetes-werkknooppunt met een nieuwere build in het cluster wordt geplaatst, worden resources verplaatst van het oude knooppunt naar het nieuwe knooppunt. Zodra dit is voltooid, wordt het oude knooppunt buiten gebruik gesteld en verwijderd uit het cluster.
Voordat u begint
Als u de Azure CLI gebruikt, is voor dit artikel Azure CLI versie 2.34.1 of hoger vereist. Voer az --version
uit om de versie te bekijken. Als u CLI wilt installeren of upgraden, raadpleegt u Azure CLI installeren.
Controleren op beschikbare upgrades
Controleer met de volgende opdracht welke Kubernetes-releases beschikbaar zijn voor uw cluster:
az aksarc get-upgrades --resource-group myResourceGroup --name myAKSCluster
De volgende voorbeelduitvoer toont de huidige versie als 1.24.11 en vermeldt de beschikbare versies onder 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",
...
}
De Kubernetes-versie upgraden
Wanneer u een upgrade uitvoert van een ondersteund AKS-cluster, kunt u de secundaire versies van Kubernetes niet overslaan. U moet alle upgrades sequentieel uitvoeren op primaire versienummer. Upgrades van 1.24.x naar 1.25.x of 1.25.x naar 1.26.x zijn bijvoorbeeld toegestaan. 1.24.x tot 1.26.x is niet toegestaan.
Notitie
Als er geen patch is opgegeven, wordt het cluster automatisch bijgewerkt naar de gespecificeerde secundaire versie, nieuwste GA-patch. Als u bijvoorbeeld instelt --kubernetes-version
op 1.25 , wordt het cluster geupgraded naar 1.25.7.
U kunt uw cluster upgraden met behulp van de volgende opdracht:
az aksarc upgrade \
--resource-group myResourceGroup \
--name myAKSCluster \
--kubernetes-version <KUBERNETES_VERSION>
Controleer of de upgrade is geslaagd met behulp van de show
opdracht:
az aksarc show --resource-group myResourceGroup --name myAKSCluster
In de volgende voorbeelduitvoer ziet u dat het cluster nu 1.25.7 uitvoert:
{
"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"
}
Belangrijk
Wanneer u een upgrade uitvoert van een niet-ondersteunde versie die twee of meer secundaire versies overslaat, kan de upgrade geen goede functionaliteit garanderen. Als uw versie aanzienlijk verouderd is, raden we u aan uw cluster opnieuw te maken.
Tijdens een upgradebewerking geven zowel de provisioningState
als currentState
de indicatoren een upgradebericht weer om het lopende proces weer te geven. Als er echter een time-out optreedt voor de bewerking, provisioningState
wordt Mislukt weergegeven, terwijl currentState
de upgrade blijft worden weergegeven terwijl de upgrade op de achtergrond wordt voortgezet. Er is geen actie vereist; de upgrade wordt voortgezet totdat deze is voltooid.
Besturingssysteemversie (OS) bijwerken
Werkknooppunten bijwerken naar een nieuwere versie van de knooppuntinstallatiekopieën zonder de Kubernetes-versie te wijzigen, werkt alleen als voor de nieuwe installatiekopieën geen andere Kubernetes-versie is vereist. Momenteel biedt AKS Arc geen ondersteuning voor updates voor alleen knooppuntinstallatiekopieën in alle Kubernetes-versies die worden ondersteund. Als u de installatiekopieën van het knooppunt wilt bijwerken, moet u het cluster upgraden naar de nieuwste Kubernetes-versie om ervoor te zorgen dat alle updates voor knooppuntinstallatiekopieën zijn opgenomen.
Belangrijk
Wanneer u de node-image-only
vlag probeert te gebruiken, ontvangt u een bericht dat aangeeft dat deze functie nog niet wordt ondersteund.