> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/kubernetes-hosted/how-to-add-a-node-group-to-a-hosted-kubernetes-cluster.md).

# How to Add a Node Group to a Hosted Kubernetes Cluster?

## **Overview**

Hosted Kubernetes allows you to add worker nodes to an existing cluster by creating a **Node Group**. A node group is a pool of worker nodes with a common configuration, including compute flavor, storage, security groups, key pair, autoscaling settings, labels, and taints.

## **Prerequisites**

Before adding a node group:

* Ensure that a Hosted Kubernetes cluster is available.
* Ensure that you have the required **quota** available for the worker nodes, including the required **compute flavor, number of worker nodes, and storage capacity**
* Ensure that you have the required **Security Group** and **Key Pair**, or permission to create them.
* Determine the required compute flavor, number of worker nodes, and storage capacity.
* If autoscaling is required, determine the minimum and maximum number of worker nodes.

## **Add a Node Group**

1. Log in to the **AceCloud portal**.
2. Navigate to **Kubernetes > Hosted > Overview**.

![](/files/FkDAp0cgOXoVSjGhnLwT)

3. Click the name of the cluster to which you want to add worker nodes.

![](/files/PI8hgb3rnuGYjkzlWXzH)

4. Go to the **Compute** tab.

![](/files/XLnm3Kbo54Mlr8cNY6Sb)

5. Under **Node Groups**, click **Add Node Group**.

![](/files/WGQygvgd6JFXaNVWSUHW)

### **Configure Node Group Details**

Under **Node Group Details**, enter the following:

* **Node Group Name**: Enter a unique name for the node group. This name is used as the hostname prefix for the worker nodes in the pool.

![](/files/GORE98UNdIZwOPRT0QJB)

### **Configure Compute and Storage**

Under **Specification**, configure the worker node resources:

1. Select the required **Flavor Type**.
2. Select the required **Flavor**.
3. Enter the **Quantity of worker nodes** to specify the number of worker nodes to create.
4. Enter the required **Volume (GB)** for worker node storage.

![](/files/8mnGBccQpzG1EMNe1qVP)

### **Configure Access and Metadata**

Under **Access & Metadata**, configure the following options:

#### **Security Groups**

Select the required **Security Group** for the worker nodes.

If the required security group is not available, click **Create** to create one.

#### **Key Pair**

Select the **Key Pair** that will be used for SSH access to the worker nodes.

If required, click **Create** to create a new key pair.

### **Configure Autoscaling**

Enable **Enable Autoscaling** if you want the number of worker nodes in the node group to automatically scale based on the configured limits.

When autoscaling is enabled:

* **Minimum worker nodes**: Specify the minimum number of worker nodes that the node group can scale down to.
* **Maximum worker nodes**: Specify the maximum number of worker nodes that the node group can scale up to.

If autoscaling is disabled, the node group maintains the configured quantity of worker nodes.

### **Configure Worker Node Labels**

Use **Worker Node Labels** to assign key-value labels to the worker nodes.

1. Enter a label **Key**.
2. Enter the corresponding **Value**.
3. Click **+ Add Label** to add additional labels.

Labels can be used to identify and organize worker nodes and can be used by Kubernetes workloads for node selection.

### **Configure Taints**

Use **Taints** to control which workloads can be scheduled on the worker nodes.

1. Enter the **Key**.
2. Enter the **Value**.
3. Select the required **Effect**.
4. Click **+ Add Taint** to add additional taints.

![](/files/XRiDffsP2EumgP5BfKaj)

## **Review the Node Group Configuration**

The **Node Group Overview** panel displays a summary of the configuration, including:

* Node Group Name
* Flavor
* Quantity of worker nodes
* Volume
* Key Pair
* Security Groups
* Worker Node Labels
* Taints
* Autoscaling status
* Minimum worker nodes
* Maximum worker nodes

Review the configuration before creating the node group.

![](/files/oxiHSbKVoFLYDIDA3T2H)

## **Create the Node Group**

1. Review the configuration in the **Node Group Overview** panel.
2. Click **Create Node Group**.

![](/files/3WT1c1z8BVXeMr8CTRde)

3. The node group is created and added to the selected Hosted Kubernetes cluster.

After successful creation, the node group and its worker nodes are available under the cluster's **Compute** tab.

**Note:** The available flavors, security groups, key pairs, and other options may vary depending on the project, region, and available resources.