The cloud-controller-manager (CCM) component in a Kubernetes cluster manages load balancing and enables cross-node communication. This topic describes the CCM component, its usage notes, and its release notes.
Component introduction
The cloud-controller-manager (CCM) integrates Kubernetes with Alibaba Cloud infrastructure products, such as Classic Load Balancer (CLB), which was formerly Server Load Balancer (SLB), Network Load Balancer (NLB), and Virtual Private Cloud (VPC). CCM provides the following features:
Manage load balancing
When you set the type of a service to
Type=LoadBalancer, the CCM component creates and configures a Classic Load Balancer (CLB) or a Network Load Balancer (NLB) for the service. This includes resources such as the CLB or NLB instance, listeners, and backend server groups. When the backend endpoints of the service or the cluster nodes change, CCM automatically updates the backend vServer groups of the CLB or NLB instance.Enable cross-node communication
When Flannel is the network component of the cluster, the CCM component enables cross-node container communication by writing the pod CIDR block of each node to the VPC route table. This feature requires no configuration and is ready to use after installation.
Usage notes
The CCM component creates and configures a Classic Load Balancer (CLB) or a Network Load Balancer (NLB) for a service. This includes resources such as the CLB or NLB instance, listeners, and backend server groups. For more information, see Considerations for configuring service load balancers.
The CCM component provides many annotations to support a wide range of load balancing capabilities on the cloud. For detailed instructions, see Configure a Classic Load Balancer (CLB) using annotations and Configure a Network Load Balancer (NLB) using annotations.
For solutions to cloud-controller-manager (CCM) component upgrade check failures, see Troubleshoot CCM upgrade check failures.
Release notes
December 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.12.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.4 | December 11, 2025 | New feature:
Fixed issue:
| This upgrade does not affect your services. |
November 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.12.3 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.3 | November 19, 2025 | New feature:
Optimization:
Fixed issue:
| This upgrade does not affect your services. |
September 2025
Version | Registry Address | Modification Time | Changes | Impact |
v2.12.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1 | September 11, 2025 | Important Starting from this version, the default billing method for new CLB instances changes from pay-by-specification (PayBySpec) to pay-by-CLCU (PayByCLCU). Existing CLB instances are not affected. For more information about this change, see [Product Change] Announcement on the change of the default load balancer type and billing method for new services and Nginx Ingress controllers.
| This upgrade does not affect your services. |
July 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.11.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.4 | July 17, 2025 |
| This upgrade does not affect your services. |
June 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.11.3 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.3 | June 27, 2025 |
| This upgrade does not affect your services. |
May 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.11.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.2 | May 29, 2025 |
| This upgrade does not affect your services. |
v2.11.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.1 | May 15, 2025 |
| This upgrade does not affect your services. |
March 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.10.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.10.4 | March 24, 2025 |
| This upgrade does not affect your services. |
January 2025
Version | Registry address | Modification Time | Changes | Impact |
v2.10.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.10.2 | January 20, 2025 |
| This upgrade does not affect your services. |
October 2024
Version | Registry address | Modification Time | Changes | Impact |
v2.10.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.10.0 | October 21, 2024 | Important Starting from this version, changes to the value of the
| This upgrade does not affect your services. |
May 2024
Version | Registry address | Modification time | Changes | Impact |
v2.9.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.9.1 | May 10, 2024 | Important Starting from this version, new CLB and NLB instances and their associated resources, such as server groups, belong to the resource group of the cluster by default. Existing CLB and NLB instances are not affected.
| This upgrade does not affect your services. |
October 2023
Version | Registry address | Modification Time | Changes | Impact |
v2.8.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.8.1 | October 16, 2023 |
| This upgrade does not affect your services. |
June 2023
Version | Registry address | Modification Time | Changes | Impact of the change |
v2.7.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.7.0 | June 21, 2023 |
| This upgrade does not affect your services. |
March 2023
Version | Registry address | Modification Time | Changes | Impact of Changes |
v2.6.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.6.0 | March 2, 2023 |
| This upgrade does not affect your services. |
October 2022, March 2023, August 2023, and June 2024
Version | Registry Address | Modification Time | Changes | Impact |
v2.5.1 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.5.1 | October 12, 2022 |
| This upgrade does not affect your services. |
v2.4.5 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.5 | June 27, 2024 | Optimization:
| This upgrade does not affect your services. |
v2.4.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.4 | August 7, 2023 | Optimizations:
| This upgrade does not affect your services. |
v2.4.3 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.3 | March 2, 2023 | Fixed an occasional issue where a node was misidentified as NotReady. | This upgrade does not affect your services. |
v2.4.2 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.2 | October 12, 2022 | Optimizations:
| This upgrade does not affect your services. |
June 2022
Version | Registry address | Modified Time | Changes | Impact |
v2.4.0 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.0 | June 20, 2022 |
| This upgrade does not affect your services. |
March 2022
Version | Registry address | Modification Time | Changes | Impact |
v2.3.0 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.3.0 | March 21, 2022 |
| This upgrade does not affect your services. |
November 2021
Version | Registry address | Modification Time | Changes | Impact |
v2.1.0 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.1.0 | November 22, 2021 |
| This upgrade does not affect your services. |
September 2021
Version | Registry address | Modification time | Changes | Impact |
v2.0.1 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.0.1 | September 2, 2021 |
| This upgrade does not affect your services. |
April 2021
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.380-gd6d0962-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.380-gd6d0962-aliyun | April 20, 2021 |
| This upgrade does not affect your services. |
March 2021
Version | Registry address | Modification Time | Changes | Impact of changes |
v1.9.3.378-g42eac35-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.378-g42eac35-aliyun | March 8, 2021 | New features:
Optimizations:
Fixed issues:
| This upgrade does not affect your services. |
December 2020
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.339-g9830b58-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.339-g9830b58-aliyun | December 18, 2020 |
| This upgrade does not affect your services. |
September 2020
Version | Registry address | Modification Time | Changes | Change impact |
v1.9.3.316-g8daf1a9-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.316-g8daf1a9-aliyun | September 29, 2020 |
| This upgrade does not affect your services. |
August 2020
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.313-g748f81e-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.313-g748f81e-aliyun | August 10, 2020 |
| This upgrade does not affect your services. |
June 2020
Version | Registry address | Modification Time | Changes | Impact of changes |
v1.9.3.276-g372aa98-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64: v1.9.3.276-g372aa98-aliyun | June 11, 2020 |
| This upgrade does not affect your services. |
March 2020
Version | Registry Address | Modification Time | Changes | Impact |
v1.9.3.239-g40d97e1-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64: v1.9.3.239-g40d97e1-aliyun | March 5, 2020 |
| This upgrade does not affect your services. |
December 2019
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.220-g24b1885-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64: v1.9.3.220-g24b1885-aliyun | December 31, 2019 |
| This upgrade does not affect your services. |
November 2019
Version | Registry address | Modification Time | Changes | Impact of the change |
v1.9.3.193-g6cddde4-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.193-g6cddde4-aliyun | November 19, 2019 |
| This upgrade does not affect your services. |
September 2019
Version | Registry address | Change time | Changes | Impact |
v1.9.3.164-g2105d2e-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3-164-g2105d2e-aliyun | September 11, 2019 |
| This upgrade does not affect your services. |
April 2019
Version | Registry address | Change time | Changes | Impact |
v1.9.3.105-gfd4e547-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.105-gfd4e547-aliyun | April 15, 2019 |
| This upgrade does not affect your services. |
March 2019
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.81-gca19cd4-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.81-gca19cd4-aliyun | March 20, 2019 |
| This upgrade does not affect your services. |
December 2018
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.59-ge3bc999-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.59-ge3bc999-aliyun | December 26, 2018 |
| This upgrade does not affect your services. |
August 2018
Version | Registry address | Modification Time | Changes | Impact |
v1.9.3.10-gfb99107-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.10-gfb99107-aliyun | August 15, 2018 |
| This upgrade does not affect your services. |
June 2018
Version | Registry address | Modification Time | Changes | Impact of the change |
v1.9.3 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3 | June 25, 2018 |
| This upgrade does not affect your services. |