CCM bridges Kubernetes Services with CLB/NLB load balancers and manages VPC routes for cross-node pod communication.
Overview
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).
-
Manage load balancers
When a Service type is set to
Type=LoadBalancer, CCM creates a CLB or NLB instance and configures listeners and backend server groups. When backend endpoints or cluster nodes change, CCM automatically updates the associated vServer groups. -
Enable cross-node communication
If your cluster uses Flannel as its network plugin, CCM adds the pod CIDR block of each node to the VPC route table for cross-node communication. This works automatically after installation.
Usage notes
-
CCM creates a CLB or NLB instance for a Service and configures listeners and backend server groups. See Considerations for Service load balancing.
-
CCM provides annotations to configure load balancing. See Configure CLB using annotations and Configure 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. 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 with 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. |