Upgrading Control Plane Version
Last updated
Last updated
Address
VNG CorporationCurrently, our VKS system has supported you to upgrade Control Plane Version, you can:
Upgrade to a newer Minor Version (e.g. 1.24 to 1.25)
Upgrade to a newer Patch Version (for example: 1.24.2-VKS.100 to 1.24.5-VKS.200)
To upgrade the Control Plane version, you can follow these instructions:
Step 1: Visit https://vks.console.vngcloud.vn/overview
Step 2: At the Overview screen , select the Kubernetes Cluster menu.
Step 3: Select the icon and select Upgrade control plane version to upgrade the control plane version.
Step 4: You can select a new version for the control plane. The new version needs to be valid and compatible with the current version of the cluster. Specifically: you can choose:
Upgrade to a newer Minor Version (e.g. 1.24 to 1.25)
Upgrade to a newer Patch Version (for example: 1.24.2-VKS.100 to 1.24.5-VKS.200)
Step 4: The VKS system will upgrade the Control Plane components of the Cluster to the new version. After the upgrade is complete, the Cluster state returns to ACTIVE .
Attention:
Upgrading Control Plane Version is optional and independent of upgrading Node Group Version. However, Control Plane Version and Node Group Version in the same Cluster cannot differ by more than 1 minor version. Besides, the VKS system automatically upgrades Control Plane Version when the current K8S Version used for your Cluster exceeds the supplier's support period.
During the Control Plane Version upgrade, you cannot perform other actions on your Cluster.
Below are a few notes before, during and after the upgrade process, please refer to:
Before getting into work:
Back up data: You should back up cluster data before upgrading to ensure safety in case the upgrade fails.
Check the current version: Visit Releases for a list of supported versions. Select a new version that is valid and compatible with the current version of the cluster.
Ensure cluster availability: Cluster must be in active state (ACTIVE) and all nodes must be HEALTHY.
Stop running tasks: Stop running tasks on the cluster to avoid affecting the upgrade process.
While doing:
Monitor cluster status: Monitor cluster status during the upgrade process. The cluster status will change to UPDATING and after completion will return to ACTIVE.
Check system log: Check the system log for any errors or warnings during the upgrade process.
After implementation:
Check cluster availability: Confirm that the cluster has been upgraded successfully and all nodes are operating normally.
Test applications: Test applications running on the cluster to ensure they work properly after the upgrade.
Note:
Upgrading Control Plane Version may take some time depending on the size and complexity of the cluster.
In some rare cases, the Control Plane Version upgrade may fail. If this happens, the VKS system will automatically rollback the cluster to the current version.
