Uaktualnianie klastra usługi Azure Kubernetes Service (AKS)

  • Artykuł

Dotyczy: Azure Stack HCI, 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 poprawianie) 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 stopniowy, aby zapewnić nieprzerwaną dostępność obciążeń. Gdy nowy węzeł roboczy 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 stary węzeł 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

Następujące przykładowe dane wyjściowe pokazują 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. Wersja 1.24.x do 1.26.x jest niedozwolona.

Uwaga

Jeśli nie określono poprawki, klaster automatycznie uaktualnia do najnowszej poprawki ogólnie dostępnej określonej wersji pomocniczej. Na przykład ustawienie --kubernetes-versionwartoś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 dwie lub więcej wersji pomocniczych, uaktualnienie nie może zagwarantować prawidłowej funkcjonalności. Jeśli twoja 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 , ponieważ uaktualnienie będzie kontynuowane w tle. Nie jest wymagana żadna akcja; uaktualnienie będzie kontynuowane do momentu ukończenia.

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 tylko obrazu węzła 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.

Następne kroki