The Cloud Controller Manager (CCM) manages load balancing for cross-node communication within a Kubernetes cluster. This topic describes the CCM component, its usage instructions, and release notes.
Introduction
The cloud controller manager (CCM) integrates Kubernetes with Alibaba Cloud services, such as Classic Load Balancer (CLB), formerly known as Server Load Balancer (SLB), Network Load Balancer (NLB), and Virtual Private Cloud (VPC). CCM provides the following features:
Manage load balancers
When you set the type of a Service to
Type=LoadBalancer, CCM creates a Classic Load Balancer (CLB) or Network Load Balancer (NLB) instance for the Service and configures resources such as listeners and backend server groups. When the backend endpoints or cluster nodes of the Service change, CCM automatically updates the vServer groups of the associated CLB or NLB instance.Enable cross-node communication
If your cluster uses Flannel as its network component, CCM enables cross-node communication by adding the pod CIDR block of each node to the VPC route table. This allows containers on different nodes to communicate with each other. This feature requires no configuration and works automatically after installation.
Usage notes
The CCM component creates a Classic Load Balancer (CLB) or a Network Load Balancer (NLB) for a Service, configuring resources such as listeners and backend server groups. For more information, see Considerations for Service load balancing.
The CCM component offers extensive annotations to configure various load balancing capabilities. For detailed instructions, see Configure Classic Load Balancer (CLB) using annotations and Configure Network Load Balancer (NLB) using annotations.
If a CCM upgrade check fails, see Troubleshoot Cloud Controller Manager (CCM) component upgrade check failures.
Changelog
April 2026
Version | Image address | Date | Changes | Impact |
v2.14.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.14.0 | April 13, 2026 | New features:
| This upgrade does not affect your workloads. |
January 2026
Version | Image address | Date | Description | Impact |
v2.13.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.13.0 | January 30, 2026 | New features:
Optimizations:
| This update has no impact on your workloads. |
December 2025
Version | Image address | Release date | Description | 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 has no impact on workloads. |
November 2025
Version | Image address | Release date | Description | Impact |
v2.12.3 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.3 | November 19, 2025 | New feature:
Improvement:
Fixed issue:
| This upgrade does not impact your workloads. |
September 2025
Version | Image address | Release date | Description | Impact |
v2.12.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1 | September 11, 2025 | Important Starting with this version, the default billing method for newly created CLB instances changes from Pay-By-Spec to Pay-By-CLCU. Existing CLB instances are not affected. For details, see [Product Changes] Default load balancer type and billing method change for new Services and Nginx Ingress Controller.
| This upgrade has no impact on your workloads. |
July 2025
Version | Image address | Release date | Description | Impact |
v2.11.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.4 | July 17, 2025 |
| This update has no impact on existing services. |
June 2025
Version | Image address | Update time | Changes | Impact |
v2.11.3 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.3 | June 27, 2025 |
| This upgrade has no impact on your workloads. |
May 2025
Version | Image address | Date | Changes | Impact |
v2.11.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.2 | May 29, 2025 |
| This upgrade has no impact on your workloads. |
v2.11.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.1 | May 15, 2025 |
| This upgrade has no impact on your workloads. |
March 2025
Version | Image address | Date | Description | 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 workloads. |
January 2025
Version | Image address | Release date | Description | Impact |
v2.10.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.10.2 | January 20, 2025 |
| This upgrade has no impact on your workloads. |
October 2024
Version | Image address | Release date | Description | Impact |
v2.10.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.10.0 | October 21, 2024 | Important Starting with this version, changes to the value of the
| This upgrade does not impact your workloads. |
May 2024
Version | Image address | Release date | Description | 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, are created in the cluster's resource group by default. Existing CLB and NLB instances are not affected.
| This upgrade does not affect your workloads. |
October 2023
Version | Image address | Release date | Description | 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 existing services. |
June 2023
Version | Image address | Release date | Changes | Impact |
v2.7.0 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.7.0 | June 21, 2023 |
| This upgrade does not impact existing services. |
March 2023
Version | Image address | Release date | Description | Impact |
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 workloads. |
October 2022, March 2023, August 2023, and June 2024
Version | Image address | Release date | Description | Impact |
v2.5.1 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.5.1 | October 12, 2022 |
| This upgrade has no impact on your workloads. |
v2.4.5 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.5 | June 27, 2024 | Improvements:
| This upgrade has no impact on your workloads. |
v2.4.4 | registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.4 | August 7, 2023 | Improvements:
| This upgrade has no impact on your workloads. |
v2.4.3 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.3 | March 2, 2023 | Fixed an intermittent issue where ready nodes were incorrectly marked as NotReady. | This upgrade has no impact on your workloads. |
v2.4.2 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.2 | October 12, 2022 | Improvements:
| This upgrade has no impact on your workloads. |
June 2022
Version | Image address | Release date | Description | Impact |
v2.4.0 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.4.0 | June 20, 2022 |
| This upgrade has no impact on your workloads. |
March 2022
Version | Image address | Release date | Description | 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 workloads. |
November 2021
Version | Image address | Release date | Description | Impact |
v2.1.0 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.1.0 | November 22, 2021 |
| This update has no impact on existing services. |
September 2021
Version | Image address | Release date | Description | Impact |
v2.0.1 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v2.0.1 | 2021-09-02 |
| This upgrade has no impact on your workloads. |
April 2021
Version | Image address | Release date | Description | Impact |
v1.9.3.380-gd6d0962-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.380-gd6d0962-aliyun | 2021-04-20 |
| This upgrade does not impact your workloads. |
March 2021
Version | Image address | Release date | Description | Impact |
v1.9.3.378-g42eac35-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.378-g42eac35-aliyun | 2021-03-08 | New features:
Improvements:
Fixed issues:
| This upgrade has no impact on your workloads. |
December 2020
Version | Image address | Release date | Description | 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 has no impact on your workloads. |
September 2020
Version | Image address | Release date | Description | Impact |
v1.9.3.316-g8daf1a9-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3.316-g8daf1a9-aliyun | 2020-09-29 |
| This upgrade does not impact your workloads. |
August 2020
Version | Image address | Release date | Description | 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 update does not impact your services. |
June 2020
Version | Image address | Release date | Description | Impact |
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 update does not affect existing Services. |
March 2020
Version | Image address | Release date | Description | Impact |
v1.9.3.239-g40d97e1-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64: v1.9.3.239-g40d97e1-aliyun | 2020-03-05 |
| This upgrade has no impact on your workloads. |
December 2019
Version | Image address | Release date | Description | Impact |
v1.9.3.220-g24b1885-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64: v1.9.3.220-g24b1885-aliyun | 2019-12-31 |
| This upgrade has no impact on existing services. |
November 2019
Version | Image address | Release date | Description | Impact |
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 has no impact on your workloads. |
September 2019
Version | Image address | Release date | Description | 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 update has no impact on existing services. |
April 2019
Version | Image address | Release date | Description | 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 update does not affect your workloads. |
March 2019
Version | Image address | Release date | Description | 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 update has no impact on your workloads. |
December 2018
Version | Image address | Release date | Description | 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 workloads. |
August 2018
Version | Image address | Release date | Description | 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 has no impact on your workloads. |
June 2018
Version | Image address | Release date | Description | Impact |
v1.9.3 | registry.cn-hangzhou.aliyuncs.com/acs/cloud-controller-manager-amd64:v1.9.3 | June 25, 2018 |
| This update does not affect existing workloads. |