Cloud Controller Manager的基本資料和變更記錄 - Container Compute Service

Cloud Controller Manager用於在Kubernetes叢集中管理負載平衡服務。本文介紹Cloud Controller Manager的功能、使用說明和變更記錄。

組件介紹

Cloud Controller Manager（簡稱CCM）提供了Kubernetes與阿里雲基礎產品的對接能力，用於在ACS叢集中管理阿里雲負載平衡服務，支援傳統型負載平衡CLB和網路型負載平衡NLB。具體功能如下：

當Service的類型設定為Type=LoadBalancer時，CCM會為該Service建立或配置CLB或NLB，包括CLB執行個體或NLB執行個體、監聽和後端伺服器等資源。
當Service對應的後端Endpoint或者叢集虛擬節點發生變化時，CCM會自動更新CLB或NLB的後端伺服器組。

關於如何使用CCM管理負載平衡服務，請參見以下文檔：
- 配置負載平衡前，請先瞭解相關注意事項。具體請參見Service的負載平衡配置注意事項。
- 關於如何配置負載平衡，請參見通過使用自動建立負載平衡的服務公開應用和通過使用已有負載平衡的服務公開應用。
- CCM提供了許多註解（Annotation），支援雲上豐富的負載平衡能力。詳細的使用方式，請參見通過Annotation配置傳統型負載平衡CLB。
關於如何解決CCM升級失敗的問題，請參見Cloud Controller Manager（CCM）組件升級檢查失敗。

版本號碼

鏡像地址

變更時間

變更內容

變更影響

v2.12.3

registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.3

2025年11月19日

該版本正在灰階中。

最佳化：

修複缺陷：

此次升級不會對業務造成影響。

版本號碼	鏡像地址	變更時間	變更內容	變更影響
v2.12.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1	2025年09月11日	重要自該版本起，建立CLB執行個體預設計費類型將由按規格計費（PayBySpec）變更為按使用量計費（PayByCLCU），已有CLB執行個體不受影響。關於該變更的詳細資料，請見【產品變更】關於建立Service與Nginx Ingress Controller預設負載平衡類型與計費方式變更的公告。新功能：預設建立的CLB執行個體計費類型由按規格計費變更為按使用量計費。最佳化：提升CLB/NLB處理速度，最佳化效能。 NLB調用OpenAPI產生限流時，會進行一定次數的等待重試。最佳化Service、路由及節點的同步耗時相關指標。 `readinessGate`重試等待時間由指數級改為固定值。修複缺陷：修複了NLB配置使用監聽連接埠段且手動設定了健全狀態檢查時，無法自動使用後端`targetPort`作為健全狀態檢查連接埠的問題。	此次升級不會對業務造成影響。

版本號碼	鏡像地址	變更時間	變更內容	變更影響
v2.11.4	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.4	2025年07月17日	修複缺陷修複使用`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range`建立NLB監聽連接埠段失敗的問題。	此次升級不會對業務造成影響。

版本號碼	鏡像地址	變更時間	變更內容	變更影響
v2.11.3	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.3	2025年06月27日	最佳化：當建立伺服器組時伺服器組為空白，跳過添加伺服器的OpenAPI調用。修複缺陷修複Service配置中targetPort使用連接埠名稱且僅選擇部分Pod時，伺服器添加失敗的問題。	此次升級不會對業務造成影響。

版本號碼	鏡像地址	變更時間	變更內容	變更影響
v2.11.2	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.2	2025年05月29日	最佳化：最佳化伺服器組同步邏輯，減少OpenAPI調用。	此次升級不會對業務造成影響。
v2.11.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.1	2025年05月15日	新功能：支援通過`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-ignore-weight-update`忽略更新後端伺服器權重。 CLB支援配置多ACL ID，配置多個存取控制策略組。 NLB支援配置通過`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range`配置監聽連接埠段。支援通過`NLB_ENDPOINT`環境變數配置自訂NLB OpenAPI端點。最佳化：最佳化節點加入和添加路由時的處理速度，減少OpenAPI調用次數。 Service同步監聽和伺服器組操作並行化，降低單次Service同步時間。調用OpenAPI建立NLB執行個體時若未指定EIP執行個體ID或IPv4私網地址，則傳遞null 指標，而非Null 字元串。調用DescribeNetworkInterfaces介面時，使用`NextToken`替代`PageSize`方式進行分頁。修複缺陷： NLB修複Service在使用ReadinessGate時，Pod未就緒時不進行重試的問題。	此次升級不會對業務造成影響。

版本號碼	變更時間	變更內容	變更影響
v2.10.2	2024年01月20日	新功能：支援為節點添加`node.alibabacloud.com/spot-strategy`標籤，標識節點是否為Spot執行個體。最佳化：同一Service的多個監聽關聯同一伺服器組時，伺服器組只同步一次。修複缺陷：修複當`LoadBalancer`類型的Service改為其他類型後又修改回`LoadBalancer`類型時，LB執行個體無法正常建立的問題。修複更新Pod Readiness狀態時，報錯Pod無法找到的問題。更新LB執行個體標籤時，忽略以`acs:`開頭的系統標籤。	此次升級不會對業務造成影響。

版本號碼	變更時間	變更內容	變更影響
v2.10.0	2024年12月02日	重要自此版本起，對Annotation `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags`值的更改將對已建立和複用的LB執行個體生效。使用該Annotation時，請勿在控制台上對LB標籤進行任何修改操作，並在升級到此版本前確認LB上標籤與Annotation是否一致。新功能：支援readinessGate能力。支援執行個體建立後通過Annotation `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags`修改標籤。支援通過Annotation `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-preserve-lb-on-delete`在Service刪除後保留LB。支援為節點添加`node.alibabacloud.com/nodepool-id`和`node.alibabacloud.com/instance-charge-type`標籤。 NLB支援通過Annotation `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn`和`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn-policy`指定`TCPSSL`類型監聽的ALPN策略。最佳化：升級基礎鏡像版本至Alpine 3.18。最佳化日誌輸出，添加`reconcileID`。修複缺陷：修複NLB執行個體中Service可能會被CLB Controller錯誤接管的問題。	此次升級不會對業務造成影響。

版本號碼	變更時間	變更內容	變更影響
v2.8.3	2024年6月30日	新功能：支援Addon Token授權模式。 NLB支援通過`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-server-group-type`的Annotation來建立IP類型伺服器組。關於NLB伺服器組分類及說明，請參見NLB伺服器組。最佳化： Client直接存取API Server，避免因為緩衝機制導致的髒資料。 NLB：最佳化伺服器組建立邏輯，避免偶發重複建立伺服器組的問題。 CLB：CLB掛載Pod ENI時新增IP地址校正，IP地址需處於叢集VPC內。	此次升級不會對業務造成影響。