edge-controller-manager is the edge controller for ACK Edge clusters. This topic describes the latest updates for edge-controller-manager.
Component introduction
edge-controller-manager is a core managed component of ACK Edge clusters. It handles:
-
Edge node lifecycle management — monitors and reconciles the lifecycle state of edge nodes
-
Certificate Signing Request (CSR) approval — automatically approves CSR requests from edge components
-
Pod toleration management — controls pod scheduling behavior on edge nodes through a dedicated toleration management controller
Usage notes
edge-controller-manager is installed by default and is not visible in the console. When a new version is available, the console displays an upgrade prompt. Upgrade the component from the console when prompted.
Version index
Use this table to find the edge-controller-manager version that corresponds to your cluster version.
| Component version | Applicable cluster version | Release |
|---|---|---|
| v2.5.1 | 1.32.1-aliyun.1 and later | October 2025 |
| v2.4.2 | 1.32.1-aliyun.1 and later | August 2025 |
| v2.4.1 | 1.32.1-aliyun.1 and later | June 2025 |
| v2.3.1 | 1.30.1-aliyun.1 and later | December 2024 |
| v2.2.1 | 1.28.9-aliyun.1 and later | December 2024 |
| v2.1.3 | 1.26.3-aliyun.1 | August 2025 |
| v1.26.3-aliyun.1 | v1.26.3-aliyun.1 | November 2023 |
| v1.24.6-aliyunedge.1 | v1.24.6-aliyunedge.1 | February 2023 |
| v1.22.15-aliyunedge.3 | 1.22.15-aliyunedge.1 | July 2025 |
| v1.22.15-aliyunedge.1 | v1.22.15-aliyunedge.1 | February 2023 |
| v1.20.11-aliyunedge.2 | v1.20.11-aliyunedge.1 | July 2022 |
| v1.20.11-aliyunedge.1 | v1.20.11-aliyunedge.1 | February 2022 |
| v1.18.8-aliyunedge.2 | v1.18.8-aliyunedge.1 | July 2022 |
| v1.18.8-aliyunedge.1 | v1.18.8-aliyunedge.1 | June 2021 |
| v1.16.9-aliyunedge.1 | v1.16.9-aliyunedge.1 | January 2021 |
Change records
October 2025
| Version | Applicable cluster version | Image address |
|---|---|---|
| v2.5.1 | 1.32.1-aliyun.1 and later | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.5.1 |
Added
-
Image prefetch for over-the-air (OTA) updates.
Changed
-
Updated supported cluster versions.
August 2025
| Version | Applicable cluster version | Image address |
|---|---|---|
| v2.4.2 | 1.32.1-aliyun.1 and later | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.4.2 |
| v2.1.3 | 1.26.3-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.1.3 |
v2.4.2
Changed
-
Updated supported cluster versions.
-
Optimized the control plane of the cloud-edge O&M channel for scenarios where node IP addresses change.
v2.1.3
Added
-
Support for configuring the autonomy period of edge nodes.
Changed
-
Updated supported cluster versions.
July 2025
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.22.15-aliyunedge.3 | 1.22.15-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.22.15-aliyunedge.3 |
Changed
-
Updated supported cluster versions.
-
Optimized node status updates and node PodCIDR allocation.
June 2025
| Version | Applicable cluster version | Image address |
|---|---|---|
| v2.4.1 | 1.32.1-aliyun.1 and later | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.4.1 |
Fixed
-
A panic issue that occurred when no nodes existed on the cloud.
December 2024
| Version | Applicable cluster version | Image address |
|---|---|---|
| v2.3.1 | 1.30.1-aliyun.1 and later | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.3.1 |
| v2.2.1 | 1.28.9-aliyun.1 and later | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v2.2.1 |
v2.3.1
Changed
-
Updated supported cluster versions.
Removed
-
The
nodelifecyclecontroller.
v2.2.1
Added
-
The CloudServiceMirroring controller.
-
Support for configuring the node autonomy period.
Changed
-
Updated supported cluster versions.
November 2023
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.26.3-aliyun.1 | v1.26.3-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.26.3-aliyun.1 |
Added
-
The pod toleration management controller.
Changed
-
Updated supported cluster versions.
Removed
-
The IPAM controller.
-
The enhanced network controller.
February 2023
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.24.6-aliyunedge.1 | v1.24.6-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.24.6-aliyunedge.1 |
| v1.22.15-aliyunedge.1 | v1.22.15-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.22.15-aliyunedge.1 |
Changed
-
Updated supported cluster versions.
July 2022
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.20.11-aliyunedge.2 | v1.20.11-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.20.11-aliyunedge.2 |
| v1.18.8-aliyunedge.2 | v1.18.8-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.18.8-aliyunedge.2 |
v1.20.11-aliyunedge.2
Added
-
Support for upgrading or downgrading the bandwidth of enhanced node pools in ACK Edge v1.20.11.
v1.18.8-aliyunedge.2
Added
-
Support for upgrading or downgrading the bandwidth of enhanced node pools in ACK Edge v1.18.8.
February 2022
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.20.11-aliyunedge.1 | v1.20.11-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.20.11-aliyunedge.1 |
Changed
-
Updated supported cluster versions.
June 2021
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.18.8-aliyunedge.1 | v1.18.8-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.18.8-aliyunedge.1 |
Changed
-
Updated supported cluster versions.
January 2021
| Version | Applicable cluster version | Image address |
|---|---|---|
| v1.16.9-aliyunedge.1 | v1.16.9-aliyunedge.1 | registry.cn-hangzhou.aliyuncs.com/acs/edge-controller-manager:v1.16.9-aliyunedge.1 |
Changed
-
Updated supported cluster versions.