Uaktualnianie klastra usługi Azure Kubernetes Service (AKS)
Dotyczy: Azure Local, wersja 23H2
W ramach zarządzania cyklem życia aplikacji i klastra możesz przeprowadzić uaktualnienie do najnowszej dostępnej wersji rozwiązania Kubernetes. Uaktualnienie obejmuje przejście do nowszej wersji platformy Kubernetes, zastosowanie aktualizacji wersji systemu operacyjnego (poprawki) lub obu tych aktualizacji. Usługa AKS Arc obsługuje uaktualnianie (lub stosowanie poprawek) węzłów w klastrze obciążenia przy użyciu najnowszych aktualizacji systemu operacyjnego i środowiska uruchomieniowego.
Wszystkie uaktualnienia są wykonywane w sposób ciągły i ciągły, aby zapewnić nieprzerwaną dostępność obciążeń. Gdy nowy węzeł roboczy platformy Kubernetes z nowszą kompilacją zostanie przeniesiony do klastra, zasoby zostaną przeniesione ze starego węzła do nowego węzła. Po pomyślnym zakończeniu starego węzła zostanie zlikwidowany i usunięty z klastra.
Zanim rozpoczniesz
Jeśli używasz interfejsu wiersza polecenia platformy Azure, ten artykuł wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.34.1 lub nowszej. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli musisz zainstalować lub uaktualnić interfejs wiersza polecenia, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.
Sprawdzanie dostępnych uaktualnień
Sprawdź, które wersje platformy Kubernetes są dostępne dla klastra, używając następującego polecenia:
az aksarc get-upgrades --resource-group myResourceGroup --name myAKSCluster
Poniższe przykładowe dane wyjściowe przedstawiają bieżącą wersję jako 1.24.11 i wyświetla listę dostępnych wersji w obszarze 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",
...
}
Uaktualnianie wersji rozwiązania Kubernetes
Podczas uaktualniania obsługiwanego klastra usługi AKS nie można pominąć wersji pomocniczych platformy Kubernetes. Wszystkie uaktualnienia należy wykonać sekwencyjnie według numeru wersji głównej. Na przykład uaktualnienia z wersji 1.24.x do 1.25.x lub 1.25.x do wersji 1.26.x są dozwolone. Wartość 1.24.x do 1.26.x nie jest dozwolona.
Uwaga
Jeśli nie określono poprawki, klaster automatycznie uaktualnia do najnowszej ogólnie dostępnej poprawki określonej wersji pomocniczej. Na przykład ustawienie --kubernetes-version wartości 1.25 powoduje uaktualnienie klastra do wersji 1.25.7.
Klaster można uaktualnić przy użyciu następującego polecenia:
az aksarc upgrade \
--resource-group myResourceGroup \
--name myAKSCluster \
--kubernetes-version <KUBERNETES_VERSION>
Upewnij się, że uaktualnienie zakończyło się pomyślnie, używając show polecenia :
az aksarc show --resource-group myResourceGroup --name myAKSCluster
Następujące przykładowe dane wyjściowe pokazują, że klaster działa teraz w wersji 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"
}
Ważne
W przypadku przeprowadzenia uaktualnienia z nieobsługiwanej wersji, która pomija co najmniej dwie wersje pomocnicze, uaktualnienie nie może zagwarantować prawidłowej funkcjonalności. Jeśli wersja jest znacznie nieaktualna, zalecamy ponowne utworzenie klastra.
Podczas operacji uaktualniania wskaźniki provisioningState i currentState wyświetlają komunikat Uaktualnianie, aby odzwierciedlić bieżący proces. Jeśli jednak upłynął limit czasu operacji, provisioningState zostanie wyświetlony komunikat Niepowodzenie, ale currentState nadal jest wyświetlany komunikat Uaktualnianie w miarę kontynuowania uaktualniania w tle. Nie jest wymagana żadna akcja; uaktualnienie będzie kontynuowane, dopóki nie zostanie ukończone.
Aktualizacja wersji systemu operacyjnego
Aktualizowanie węzłów procesu roboczego do nowszej wersji obrazu węzła bez zmiany wersji rozwiązania Kubernetes działa tylko wtedy, gdy nowy obraz nie wymaga innej wersji rozwiązania Kubernetes. Obecnie usługa AKS Arc nie obsługuje aktualizacji typu node-image-only we wszystkich wersjach platformy Kubernetes w obsłudze. Jeśli musisz zaktualizować obraz węzła, musisz uaktualnić klaster do najnowszej wersji rozwiązania Kubernetes, aby upewnić się, że wszystkie aktualizacje obrazu węzła są włączone.
Ważne
Podczas próby użycia flagi node-image-only zostanie wyświetlony komunikat informujący, że ta funkcja nie jest jeszcze obsługiwana.