# Modify cluster settings

## &#x20;**1. Adding a Worker Group**

&#x20;**Step 1**: Select <mark style="color:red;">**\[Containers] > \[Kubernetes]**</mark> from the menu to display the **Kubernetes Management** page. Select the cluster to which you want to add a worker group.

<figure><img src="/files/C3p4TV7czW5YH9u75x6F" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Select **Node Pools > Edit Workers.**

<figure><img src="/files/RA1t5GoOPoaKIWo8sROX" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3**: Select **ADD WORKER GROUP.**

<figure><img src="/files/lhdLLXmoGgxv5FM99oDb" alt=""><figcaption></figcaption></figure>

&#x20;**Step 4:** Enter the required information in each field.

<figure><img src="/files/9owu2PDZnznxxYBiO1Jm" alt=""><figcaption></figcaption></figure>

* **Instance Type:** Select **the worker node instance type** (CPU or GPU).
* **Type:** Select **the worker node configuration** (CPU and memory).
* **Container Runtime:** Select **Containerd.**
* **Storage Policy:** Select the storage policy type for the worker node disk (supports IOPS).
* **Disk (GB):** Select the capacity **of the worker node's root disk.**
* **Network:** Select the subnet used to deploy Kubernetes cluster VMs.
* **Scale min**: Minimum number of VM instances for worker nodes in the k8s cluster. A minimum of 3 nodes is recommended for production environments.
* **Scale max**: The maximum number of VM instances for worker nodes in the worker group within the k8s cluster.
* **Label:** Apply a label to a **worker** group
* **Taint:** Apply a Taint **to the worker group.**

&#x20;**Step 5**: Review the information and select **"Save"** to add the new worker.

<figure><img src="/files/KbvbDr7cTC50VXJO7Why" alt=""><figcaption></figcaption></figure>

&#x20;Adding the cluster takes a few minutes, and the cluster status changes to "**Processing."** The cluster continues to function normally even after adding a new worker group.

## &#x20;**2. Editing Worker Group Labels/Taints**

&#x20;**Step 1:** Select <mark style="color:red;">**\[Containers] > \[Kubernetes]**</mark> from the menu to display the **Kubernetes Management** page. **Select the cluster** whose labels/taint you wish to edit.

<figure><img src="/files/T8vI2F4EzecPia1by1AO" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Select **Node Pools > Edit Workers.**

<figure><img src="/files/Cbto3eEN519U9BiEzAiL" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Enter the labels and **taints** you want to add to the worker group, then click the **\[Save]** button.

<figure><img src="/files/SRJ1V71S0mtCBUQBTKEr" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/332Lv0OFUDvgIUBgqRcD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oa8G9xt3lfQjlZSYVeSM" alt=""><figcaption></figcaption></figure>

*Note: Label and taint editing takes effect within a few minutes, and the cluster status changes to **"Processing."** Users cannot perform editing operations on the cluster until this process completes.*

## &#x20;**3. Enabling/Disabling Automatic Node Repair**

**In addition to cluster autoscaling,** FPTCloud provides a node auto-healing feature that automatically restarts worker nodes that remain in the NotReady state for over 3 minutes. This feature is effective when worker nodes become overloaded or when issues related to the container runtime or kubelet cause a node to enter the NotReady state. If a node fails to return to the Ready state after auto-repair, the system replaces the NotReady node with a new node with identical settings after 10 minutes. This feature is enabled by default for worker groups (worker groups containing cluster system components). Users can enable or disable this feature for other worker groups within the cluster.

&#x20;**Step 1:** Select <mark style="color:red;">**"Containers" > "Kubernetes"**</mark> from the menu to display the **Kubernetes Management** page. Select the cluster for which you want to enable/disable Node Auto-repair.

<figure><img src="/files/TxTUcVr20lEBuDjqpPJa" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Select **Node Pools** > <mark style="color:red;">**Edit Workers.**</mark>

<figure><img src="/files/y0nxd8XRJYIX0ASo7p9N" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** **Within&#x20;**<mark style="color:red;">**worker**</mark>**&#x20;pool, toggle the Node auto repair feature on or off.**

<figure><img src="/files/R8tzGhvxZn0skouBqGI5" alt=""><figcaption></figcaption></figure>

&#x20;*Note: Only version upgrades are possible; downgrades cannot be performed.*

&#x20;**Step 4:** Click the **\[Save]** button.

<figure><img src="/files/WaQLnUJGSUC1aLzMsnHa" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/sje6Z7BVAB0qXDAd2bgt" alt=""><figcaption></figcaption></figure>

Editing the Node auto repair on/off setting takes effect within a few minutes, and the cluster status changes to **Processing.** During execution, you cannot perform any cluster editing operations until the process completes.

## &#x20;**4. Worker Group-Based Migration Feature**

&#x20;If a user wishes to change the worker group base, system components (such as CoreDNS, Metrics Server, CNI Controller, etc.) will be redeployed to worker nodes belonging to the new worker group base. This feature is useful when you want to increase or decrease the worker node flavor configuration within a worker group base. In such cases, create a new worker group with the desired worker node configuration, migrate to that new worker group base, and then delete the old worker group base.

**Step 1:** Select <mark style="color:red;">**\[Containers] > \[Kubernetes]**</mark> from the menu to display the **Kubernetes Management** page. Select the cluster for which you want to modify Worker Group settings.

<figure><img src="/files/g2YXEOyCKeo0lEn7n1QA" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Select **Node Pools > Edit Workers.**

<figure><img src="/files/bpnSTZhs09SFi5IZ2u8d" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Select the worker group you want to modify.

<figure><img src="/files/neZN37D9Y9BljRUN9vFA" alt=""><figcaption></figcaption></figure>

&#x20;**Step 4:** Review the information and select **\[Save]** to save the changes.

<figure><img src="/files/wqgYTDVLBODeBuaTfSM1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/l0ykcXynAKlwcH0ksFtv" alt=""><figcaption></figcaption></figure>

&#x20;The Worker Group Base modification process will run. While it is running, users cannot perform any editing operations on the cluster until the process completes.

&#x20;*<mark style="color:orange;">**Tip:**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">When changing worker group parameters, the system first creates new worker nodes with the desired configuration. Once new worker nodes are successfully created, the old worker nodes are removed from the system. Pods are migrated from the old worker nodes to the new worker nodes.</mark>*

## &#x20;**5. K8s Version Upgrade**

&#x20;**Step 1:** Select <mark style="color:red;">**\[Containers] > \[Kubernetes]**</mark> from the menu to display the **Kubernetes Management** page. Select the cluster for which you want to upgrade the K8s version.

<figure><img src="/files/0r3vV6ilgyLaBQv7uKww" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Under **\[Cluster Information] > \[Version]**, select the **\[Setting]** icon.

<figure><img src="/files/fNIAlFOBhKy3ma0lIDoB" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Select the version to upgrade to and choose **\[Upgrade].**

<figure><img src="/files/NAQpNVvb8YtFc99PmLld" alt=""><figcaption></figcaption></figure>

&#x20;*<mark style="color:red;">**Note:**</mark> <mark style="color:red;"></mark><mark style="color:red;">Only version upgrades are possible; downgrades cannot be performed.</mark>*

&#x20;*<mark style="color:red;">To avoid issues during processing, we recommend upgrading versions sequentially.</mark>*

## **6. Changing Cluster Endpoint Access**

### &#x20;1️⃣ **To change the access mode for a Kubernetes cluster**

&#x20;⚠️ **Note**:

* M-FKE only supports converting access modes between Public & Private ➔ Private and vice versa.
* M-FKE does not support access mode conversion when the Kubernetes cluster is in Public mode.

&#x20;**Step 1:** Select the cluster whose access mode you want to change and click its name.

<figure><img src="/files/JXgNJnnjtgfw8JHJlrkR" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Under \[Cluster Endpoint Access], click the \[Edit] button.

<figure><img src="/files/7VEiIXRBtIJWGCmfHJdN" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Select the desired access mode, enter a valid Allow CIDR, and click the Confirm button.

<figure><img src="/files/22OyEqic5OAlvrZJHWGw" alt=""><figcaption></figcaption></figure>

### &#x20;2️⃣ **To update the Allow CIDR:**

&#x20;**Step 1:** Select the cluster whose access mode you want to change and click the cluster name.

<figure><img src="/files/30Ldpx1QlY9EOgNjEFuU" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Under Cluster Endpoint Access, click the Edit button.

<figure><img src="/files/M3oM15sGVQu5ISzha2ET" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Enter additional valid CIDR ranges and click the Confirm button.

<figure><img src="/files/GH7tZ2UXsSa16nqLCjNs" alt=""><figcaption></figcaption></figure>

### &#x20;2️⃣ **To remove an Allow CIDR:**

&#x20;**Step 1**: Select the cluster whose access mode you want to change and click the cluster name.

<figure><img src="/files/3p0adYYZSQFcA3PDufqt" alt=""><figcaption></figcaption></figure>

&#x20;**Step 2:** Under "Cluster Endpoint Access," click the Edit button.

<figure><img src="/files/MlTLyYoQkrsbgTcnNoMj" alt=""><figcaption></figcaption></figure>

&#x20;**Step 3:** Delete all existing CIDRs and click the Confirm button.

<figure><img src="/files/DL853BR2FxSE4uKA9zo1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/krqk41WTzmBudeFJkpOt" alt=""><figcaption></figcaption></figure>

⚠️ The access mode update will be applied within a few minutes, and the cluster status will change to **"Processing."** The cluster will continue to function normally during the transition to the new access mode.

## &#x20;**7. Changing Internal Subnet Load Balancer (CIDR) Settings**

&#x20;FPT Cloud supports customers who wish to change the range of their Internal Subnet Load Balancer (CIDR) on the Unify Portal. Customers should follow the steps below.

**Step 1**: Select the cluster for which you wish to change the Internal Subnet Load Balancer and click the cluster name.

<figure><img src="/files/h2pOZUMQ2En9A8ENW5O4" alt=""><figcaption></figcaption></figure>

**Step 2**: Select the \[Advanced] tab and click the \[Config Internal subnet Load Balancer] button.

<figure><img src="/files/GfzyrxT97v9AooaCKcP3" alt=""><figcaption></figcaption></figure>

**Step 3**: Enter a valid CIDR range and click the "Confirm" button.

<figure><img src="/files/CDkIYyyKIwHlF8MiGKlU" alt=""><figcaption></figcaption></figure>

⚠️ The internal subnet load balancer update will be performed within a few minutes, and the cluster status will change to "Processing." The cluster will continue to function normally during the transition to the new internal subnet load balancer (CIDR).


---

# 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://ai-docs.fptcloud.com/fpt-gpu-cloud/gpu-cluster/managed-k8s-with-gpu-virtual-machine/tutorial/modify-cluster-settings.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.
