All Products
Search
Document Center

Container Service for Kubernetes:Create and manage hybrid cloud node pools

Last Updated:Mar 26, 2026

Hybrid cloud node pools let you add on-premises servers or third-party cloud servers to an ACK managed Pro cluster as worker nodes, so you can manage your entire infrastructure from a single Kubernetes control plane.

Prerequisites

Before you begin, ensure that you have:

  • An ACK managed Pro cluster with:

  • At least one Elastic Compute Service (ECS) node in the cluster to host critical ACK management components. For high availability, use at least three ECS nodes.

  • The Terway Hybrid network plugin installed in the cluster

Default label and taint behavior

To prevent unintended impact on existing workloads, nodes in a hybrid cloud node pool are created with the following default label and taint:

apiVersion: v1
kind: Node
metadata:
  labels:
    alibabacloud.com/nodepool-type: hybridcloud
...
spec:
  taints:
  - effect: NoSchedule
    key: nodepool-type
    value: "hybridcloud"
...

To schedule pods onto hybrid nodes, add a toleration for this taint to your pod specifications. If your workloads do not need to distinguish between cloud and on-premises nodes, remove the taint.

Important

Do not remove the default label alibabacloud.com/nodepool-type: hybridcloud. Doing so will impact service functionality.

Create a hybrid cloud node pool

Some settings, such as availability and networking, cannot be changed after the node pool is created. Creating a node pool does not affect existing node pools or their workloads.
  1. Log on to the ACK console. In the left navigation pane, click Clusters.

  2. On the Clusters page, click the name of the target cluster. In the left navigation pane, choose Nodes > Node Pools.

  3. On the Node Pools page, click ... next to Create Node Pool, then click Create Hybrid Cloud Node Pool.

  4. In the dialog box, configure the following parameters:

    ParameterDescription
    Node pool nameA unique name for the node pool. For example, hybrid-nodepool-mexxSA.
    ZoneA custom logical zone name. For example, idc-zone-1. Must be unique within the cluster.
    Network plug-inUse CNI (Terway-Hybrid) (recommended): ensures network connectivity between pods running on-premises and in the cloud. If the Terway-Hybrid Container Network Interface (CNI) component is not installed, install it from the Add-ons page first. See Terway Hybrid network plugin. Configure CNI: select this if you need specific CNI features and want to install a custom CNI plugin.
    Network typeunderlay: high performance with low latency by eliminating VXLAN encapsulation overhead. Approximately 20% higher performance than overlay mode. overlay: simple configuration and flexible deployment with no special requirements for the underlying network.
  5. Click OK to create the node pool.

After the node pool is created, modify its settings on the Edit Node Pool page.

Add nodes to a hybrid cloud node pool

Add your existing on-premises or third-party cloud servers as worker nodes using one of two methods.

Auto add instances with Cloud Assistant installed

Use this method if your servers are already registered as Alibaba Cloud managed instances.

  1. Register each server as an Alibaba Cloud managed instance.

    Important

    Register the instance in the same region as your ACK cluster.

  2. On the Node Pools page, click image in the Actions column of the target node pool, then click Add Existing Node.

  3. Set the upload method to Add Existing.

  4. Select the instances to add to the cluster.

Manually add instances

Use this method if your servers are not yet registered as managed instances.

  1. On the Node Pools page, click image in the Actions column of the target node pool, then click Add Existing Node.

  2. Set the upload method to Manual.

  3. Configure the activation ID and activation code. Generate these on the Alibaba Cloud managed instances page.

  4. Click OK to generate the installation script.

  5. Copy the script and run it on each server you want to add.

Remove nodes from a hybrid cloud node pool

Important

Removing a node from the cluster does not unregister the third-party server. To unregister it, see Unregister a third-party server.

  1. On the Clusters page, click the name of the target cluster. In the left navigation pane, choose Nodes > Node Pools.

  2. Click the target node pool name. On the details page, select the nodes to remove and click Batch Remove.

Billing

Costs comprise three parts:

  • The cluster management fee

  • The hybrid cloud node management fee (currently waived during the preview period)

  • The costs of any associated cloud resources

Supported operating systems

The following table lists the operating systems supported by hybrid cloud node pools. For operating systems not in this list, contact your business manager for an evaluation.

OS image type

Platform

Architecture

Image name (with version)

Image ID

Alibaba Cloud Linux 3.2104 LTS 64-bit ACK-optimized

Aliyun

x86_64

Alibaba Cloud Linux 3.2104 Container-Optimized

aliyun_3_x64_20G_container_optimized_20241226.vhd

(Defaults to cgroup V2)

Alibaba Cloud Linux 3

Aliyun

x86_64

Alibaba Cloud Linux 3.2104 LTS 64-bit

aliyun_3_x64_20G_alibase_20240528.vhd

Alibaba Cloud Linux 3 ARM

Aliyun

arm64

Alibaba Cloud Linux 3.2104 LTS 64-bit ARM Edition

aliyun_3_arm64_20G_alibase_20240528.vhd

Alibaba Cloud Linux UEFI 3

Aliyun

x86_64

Alibaba Cloud Linux UEFI 3.2104 Security Enhanced

aliyun_3_x64_20G_uefi_alibase_20230727.vhd

Red Hat

Red Hat

x86_64

Red Hat Enterprise Linux (RHEL) 9.3 64-bit

Red Hat Enterprise Linux 9.3 64-bit

(RHEL 9 and later versions use cgroup V2 by default)