Edit

Upgrade the Kubernetes version of an AKS workload cluster using Windows Admin Center

  • Article

Applies to: AKS on Azure Stack HCI 22H2, AKS on Windows Server

This article describes how to upgrade an Azure Kubernetes Service (AKS) workload cluster to a new Kubernetes version in AKS enabled by Azure Arc. You should update the AKS hosts to a new version of the operating system before updating the Kubernetes version.

Note

You can also use PowerShell to upgrade AKS workload clusters.

We recommend updating an AKS workload cluster in AKS Arc at least once every 60 days. New updates are available every 30 days. To avoid outages in workload availability, rolling updates are performed.

When you bring a new node with a newer build into the cluster, resources move from the old node to the new node, and when the resources are successfully moved, the old node is decommissioned and removed from the cluster.

Upgrade the Kubernetes version

To upgrade the Kubernetes version of an AKS workload cluster with Windows Admin Center, follow these steps:

  1. On the Windows Admin Center Connections page, connect to your management cluster.

  2. Select Azure Kubernetes Service from the Tools list. When the tool loads, the Overview page is displayed.

  3. Select the workload cluster you want to upgrade.

  4. Select Settings under Kubernetes clusters to navigate to the Settings page.

    Screenshot showing the Settings option for Kubernetes clusters in Windows Admin Center.

  5. Select Update now to upgrade your workload cluster's Kubernetes version.

    Screenshot showing the Update Now button on the Host Settings page in Windows Admin Center.

The following update scenarios are not supported in Windows Admin Center, but you can use PowerShell to perform them:

  • Windows Admin Center doesn't support skipping a patch update. You can only update a workload cluster to the next available patch version, even when a minor update is available.
  • Windows Admin Center doesn't support upgrading the OS image of the Kubernetes cluster without updating the Kubernetes version.

Next steps

In this article, you learned how to upgrade AKS workload clusters in AKS hybrid. Next, you can: