How to Upgrade a Hosted Kubernetes Cluster?

Overview

The Upgrades tab in Hosted Kubernetes allows you to upgrade the Kubernetes version of a cluster. The upgrade process is performed in two steps:

1. Upgrade the control plane.

2. Upgrade the node groups.

You must complete the control plane upgrade before upgrading the node groups.

View Available Kubernetes Upgrades

1. Log in to the AceCloud portal.

2. Navigate to Kubernetes > Hosted > Overview.

3. Select the cluster you want to upgrade.

4. Click the Upgrades tab.

The page displays the current Kubernetes versions and available upgrade information, including:

• Current control plane version

• Current worker nodes version

• Available upgrade version

• End-of-Life (EOL) date for the current and available versions

Note: The available upgrade versions depend on the Kubernetes versions supported by the platform.

Step 1: Upgrade the Control Plane

1. In the Step 1 of 2: control plane section, review the available upgrade version.

2. Click Upgrade control plane to vX.X.X.

1. Follow the on-screen instructions to confirm the upgrade, if prompted.

2. Wait for the control plane upgrade to complete.

Important: The control plane must be upgraded before you can upgrade the node groups.

Step 2: Upgrade Node Groups

After the control plane upgrade is completed, proceed to the Step 2 of 2: node groups section.

1. Review the node groups available for upgrade.

2. Select the node groups you want to upgrade.

3. To select all upgradeable node groups, select Select all upgradeable node groups.

4. Click Upgrade selected groups to upgrade the selected node groups.

Alternatively, click Upgrade all groups to upgrade all eligible node groups.

The node group status is displayed on the page after the upgrade.

Node Group Upgrade Status

The Node Groups section displays the current and target Kubernetes versions for each node group.

A node group may display Up to date when no upgrade is currently required or available for that node group.

Upgrade Sequence

Hosted Kubernetes upgrades must follow this sequence:

Current Kubernetes Version → Control Plane Upgrade → Node Group Upgrade

For example:

• Current control plane: 1.34.6

• Current worker nodes: 1.34.6

• Available upgrade: 1.35.5

• First upgrade the control plane from 1.34.6 → 1.35.5

• Then upgrade the eligible node groups from 1.34.6 → 1.35.5

Note: Upgrade availability and supported target versions may vary based on the cluster's current Kubernetes version.

Note: Hosted Kubernetes cluster upgrades are performed as a rolling upgrade. During the upgrade, workloads are gradually shifted to the newly created nodes. The existing nodes are removed only after their workloads have been successfully rescheduled and the new nodes are ready.

It is recommended to upgrade the cluster before the current Kubernetes version reaches End of Life (EOL) to ensure continued support and compatibility.