Delen via


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.

Volgende stappen