# Upgrading Control Plane Version

Currently, 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](https://vks.console-dev.vngcloud.tech/overview)

**Step 2: At the Overview** screen , select the **Kubernetes Cluster menu.**

**Step 3:** Select the icon ![](https://docs.vngcloud.vn/~gitbook/image?url=https%3A%2F%2Fdocs-admin.vngcloud.vn%2Fdownload%2Fthumbnails%2F73762015%2Fimage2024-4-16_15-51-55.png%3Fversion%3D1%26modificationDate%3D1713262579000%26api%3Dv2\&width=40\&dpr=4\&quality=100\&sign=10c09f1b\&sv=1)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** .

{% hint style="info" %}
**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.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vngcloud.vn/vng-cloud-document/vks/clusters/upgrading-control-plane-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.