Share via

Een AKS-cluster (Azure Kubernetes Service) upgraden

  • Artikel

Van toepassing op: Azure Stack HCI, versie 23H2

Als onderdeel van het beheren van de levenscyclus van de toepassing en het cluster 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 versie-updates van het besturingssysteem (OS) (patching) of beide. AKS Arc ondersteunt 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 gebracht, worden resources verplaatst van het oude knooppunt naar het nieuwe knooppunt. Zodra dit is voltooid, wordt het oude knooppunt buiten gebruik gesteld en uit het cluster verwijderd.

Voordat u begint

Als u de Azure CLI gebruikt, is voor dit artikel Versie 2.34.1 of hoger van Azure CLI vereist. Voer az --version uit om de versie te bekijken. Zie Azure CLI installeren als u de CLI wilt installeren of upgraden.

Controleren op beschikbare upgrades

Controleer met behulp van 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 secundaire kubernetes-versies niet overslaan. U moet alle upgrades sequentieel uitvoeren op basis van het 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 meest recente ga-patch van de opgegeven secundaire versie. Als u --kubernetes-version bijvoorbeeld instelt op 1.25 , wordt het cluster bijgewerkt 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 waarbij twee of meer secundaire versies worden overgeslagen, kan de upgrade de juiste functionaliteit niet garanderen. Als uw versie aanzienlijk verouderd is, raden we u aan in plaats daarvan uw cluster opnieuw te maken.

Tijdens een upgradebewerking geven zowel de provisioningState indicatoren als currentState 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 currentStateUpgraden op de achtergrond wordt weergegeven terwijl de upgrade wordt voortgezet. Er is geen actie vereist; de upgrade wordt voortgezet totdat deze is voltooid.

Versie van besturingssysteem (OS) bijwerken

Het bijwerken van werkknooppunten 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 met alleen knooppunten voor alle Kubernetes-versies die worden ondersteund. Als u de installatiekopieën van het knooppunt moet bijwerken, moet u het cluster upgraden naar de nieuwste Kubernetes-versie om ervoor te zorgen dat alle updates van de knooppuntinstallatiekopieën worden 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.

Volgende stappen