yurt-hub-controlplane is a control plane component that provides node autonomy features for hybrid cloud node pools in ACK clusters. This topic describes the yurt-hub-controlplane component, its usage instructions, and the latest updates.
How it works
When the network between the cloud and an edge node pool is interrupted, edge nodes must continue to serve local workloads without relying on the Kubernetes control plane. yurt-hub-controlplane and yurt-hub work together to deliver this capability:
| Component | Location | Role |
|---|---|---|
| yurt-hub-controlplane | ACK control plane (managed) | Coordinates node autonomy policy and state for hybrid cloud node pools |
| yurt-hub | Each edge node | Intercepts and caches requests from kubelet and pods so that edge nodes continue operating when connectivity to the cloud is lost |
When the cloud-edge network is healthy, both components operate transparently. When connectivity is lost, yurt-hub keeps edge nodes running autonomously, while yurt-hub-controlplane manages the autonomy state from the control plane side.
Prerequisites
Before you begin, ensure that you have:
An ACK managed cluster running version 1.33 or later
The yurt-hub node component installed on your edge nodes
Install yurt-hub-controlplane
Log in to the ACK Clusters page and click the name of your cluster.
In the left navigation pane, click Add-ons.
Find and install the yurt-hub-controlplane managed component by following the on-screen instructions.
Change log
March 2026
| Version number | Registry address | Changes | Change time | Impacts |
|---|---|---|---|---|
| v1.0.1 | registry.cn-hangzhou.aliyuncs.com/acs/yurt-hub-controlplane:v1.0.1 | Fixed an issue where the node autonomy switch label setting did not take effect. | March 3, 2026 | This upgrade does not affect your services. |
January 2026
| Version number | Registry address | Changes | Change time | Impacts |
|---|---|---|---|---|
| v1.0.0 | registry.cn-hangzhou.aliyuncs.com/acs/yurt-hub-controlplane:v1.0.0 | The first version of yurt-hub-controlplane for ACK clusters. | January 13, 2026 | This upgrade does not affect your services. |