Cloud Controller Manager の基本情報と変更履歴 - Container Compute Service

Cloud Controller Manager (CCM) は、Kubernetes クラスターのロードバランシングサービスを管理します。このトピックでは、CCM の特徴、利用方法、変更履歴について説明します。

コンポーネントの概要

CCM は Kubernetes と Alibaba Cloud のインフラストラクチャプロダクトを接続し、ACS クラスターのロードバランシングサービスを管理します。Classic Load Balancer (CLB) と Network Load Balancer (NLB) をサポートしています。その特徴は以下の通りです。

サービスタイプを Type=LoadBalancer に設定すると、CCM はサービスに対して CLB または NLB インスタンスを作成または設定します。これには、CLB または NLB インスタンス、リスナー、バックエンドサーバーなどのリソースが含まれます。
サービスのバックエンドエンドポイントまたはクラスターの仮想ノードが変更されると、CCM は CLB または NLB インスタンスのバックエンドサーバーグループを自動的に更新します。

利用方法

CCM を使用してロードバランシングサービスを管理する方法の詳細については、以下のドキュメントをご参照ください。
- ロードバランシングを設定する前に、関連する注意事項を確認してください。詳細については、「サービスの Server Load Balancer 設定に関する注意事項」をご参照ください。
- ロードバランシングの設定方法の詳細については、「Server Load Balancer インスタンスを自動的に作成するサービスを使用したアプリケーションの公開」および「既存の Server Load Balancer インスタンスを使用するサービスを使用したアプリケーションの公開」をご参照ください。
- CCM は、幅広いロードバランシング機能をサポートするために多くのアノテーションを提供しています。詳細な利用方法については、「アノテーションを使用した Classic Load Balancer (CLB) インスタンスの設定」をご参照ください。
CCM のアップグレード失敗を解決する方法の詳細については、「Cloud Controller Manager (CCM) コンポーネントのアップグレードチェックの失敗」をご参照ください。

変更履歴

2025 年 12 月

バージョン

レジストリアドレス

変更日時

変更内容

影響

v2.12.4

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

2025 年 12 月 11 日

新機能：

Pod ReadinessGate Webhook 機能が追加され、新規クラスターではデフォルトで有効になります。この機能の使用方法の詳細については、「Readiness Gate を設定してスムーズな Pod の更新を保証する」をご参照ください。

修正された問題：

NLB サービスが削除されたときに、関連付けられたサーバーグループが自動的にクリーンアップされない問題が修正されました。

このアップグレードはサービスに影響しません。

2025 年 11 月

バージョン

レジストリアドレス

変更日時

変更内容

影響

v2.12.3

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

2025 年 11 月 19 日

最適化：

CLB インスタンスがバックエンド Pod IP アドレスに対応する ENI を見つけられないためにエラーを報告した場合、新しいエラーログには特定の Pod 名 (targetRef) とそのノード情報が含まれます。

修正された問題：

NLB 情報のクエリ中または非同期タスクの呼び出しが失敗したときに、サービスの同期中に発生するパニックの問題が修正されました。

このアップグレードはサービスに影響しません。

2025 年 9 月

バージョン	レジストリアドレス	変更日時	変更内容	影響
v2.12.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1	2025 年 9 月 11 日	重要このバージョンから、新規 CLB インスタンスのデフォルトの課金方法は、仕様別の課金 (PayBySpec) から CLCU 単位の課金 (PayByCLCU) に変更されます。既存の CLB インスタンスは影響を受けません。この変更の詳細については、「[製品の変更] 新規サービスおよび Nginx Ingress コントローラーのデフォルトのロードバランサータイプと課金方法の変更に関するお知らせ」をご参照ください。新機能：新規作成された CLB インスタンスのデフォルトの課金方法が、仕様別の課金から CU 単位の課金に変更されました。最適化： CLB および NLB インスタンスの処理速度を向上させ、パフォーマンスを最適化しました。 NLB API 呼び出しがスロットリングされた場合、待機期間後に呼び出しをリトライします。サービス、ルート、ノードの同期時間に関連するメトリクスを最適化しました。 `readinessGate` のリトライ待機時間が、指数バックオフから固定値に変更されました。修正された問題： NLB インスタンスがリスナーポート範囲と手動ヘルスチェックで設定されている場合に、バックエンドの `targetPort` がヘルスチェックポートとして自動的に使用されない問題が修正されました。	このアップグレードはサービスに影響しません。

2025 年 7 月

バージョン	レジストリアドレス	変更日時	変更内容	影響
v2.11.4	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.4	2025 年 7 月 17 日	修正された問題 `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range` アノテーションを使用した NLB リスナーポート範囲の作成が失敗する問題が修正されました。	このアップグレードはサービスに影響しません。

2025 年 6 月

バージョン	レジストリアドレス	変更日時	変更内容	影響
v2.11.3	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.3	2025 年 6 月 27 日	最適化：作成時にサーバーグループが空の場合、サーバーを追加する OpenAPI 呼び出しをスキップします。修正された問題サービス設定の targetPort がポート名を使用し、一部の Pod のみが選択された場合にサーバーの追加に失敗する問題が修正されました。	このアップグレードはサービスに影響しません。

2025 年 5 月

バージョン	レジストリアドレス	変更日時	変更内容	影響
v2.11.2	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.2	2025 年 5 月 29 日	最適化：サーバーグループの同期ロジックを最適化し、OpenAPI 呼び出しを削減しました。	このアップグレードはサービスに影響しません。
v2.11.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.1	2025 年 5 月 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 呼び出しの数を削減しました。リスナーとサーバーグループのサービス同期を並列化し、単一サービスの同期時間を短縮しました。 OpenAPI を呼び出して NLB インスタンスを作成する際、EIP インスタンス ID または IPv4 プライベート IP アドレスを指定しない場合、空の文字列の代わりにヌルポインタが渡されます。 DescribeNetworkInterfaces 操作を呼び出す際、ページネーションには `PageSize` の代わりに `NextToken` が使用されます。修正された問題： NLB で、ReadinessGate を使用するサービスが Pod の準備ができていない場合にリトライしない問題が修正されました。	このアップグレードはサービスに影響しません。

2025 年 1 月

バージョン	変更日時	変更内容	影響
v2.10.2	2024 年 1 月 20 日	新機能： `node.alibabacloud.com/spot-strategy` ラベルをノードに追加して、ノードがスポットインスタンスであるかどうかを識別することをサポートします。最適化：同じサービスの複数のリスナーが同じサーバーグループに関連付けられている場合、サーバーグループは一度だけ同期されます。バグ修正： `LoadBalancer` タイプのサービスが別のタイプに変更され、その後 `LoadBalancer` タイプに戻された場合に SLB インスタンスを作成できない問題が修正されました。 Pod の準備完了状態を更新する際に、Pod が見つからないというエラーが報告される問題が修正されました。 SLB インスタンスのタグを更新する際に、`acs:` で始まるシステムタグを無視します。	このアップグレードはサービスに影響しません。

2024 年 12 月

バージョン番号	変更日時	変更内容	影響
v2.10.0	2024 年 12 月 2 日	重要このバージョン以降、`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags` アノテーションの値の変更は、作成および再利用された SLB インスタンスに反映されます。このアノテーションを使用する場合、コンソールで SLB タグを変更しないでください。このバージョンにアップグレードする前に、SLB インスタンスのタグがアノテーションと一致していることを確認してください。新機能： readinessGate 機能をサポートします。 `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags` アノテーションを使用して、インスタンス作成後のタグ変更をサポートします。 `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-preserve-lb-on-delete` アノテーションを使用して、サービス削除後の SLB インスタンスの保持をサポートします。 `node.alibabacloud.com/nodepool-id` および `node.alibabacloud.com/instance-charge-type` ラベルをノードに追加することをサポートします。 NLB：`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn` および `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn-policy` アノテーションを使用して、`TCPSSL` リスナーの ALPN ポリシーを指定することをサポートします。最適化：ベースイメージのバージョンを Alpine 3.18 にアップグレードしました。 `reconcileID` を追加してログ出力を最適化しました。バグ修正： NLB インスタンス内のサービスが CLB コントローラーによって誤って引き継がれる可能性がある問題が修正されました。	このアップグレードはサービスに影響しません。

2024 年 6 月

バージョン番号	変更日時	変更内容	影響
v2.8.3	2024 年 6 月 30 日	新機能： Addon Token 権限付与モードをサポートします。 NLB：`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-server-group-type` アノテーションを使用して、IP ベースのサーバーグループの作成をサポートします。NLB サーバーグループの分類と説明の詳細については、「NLB サーバーグループ」をご参照ください。最適化：クライアントは API Server に直接アクセスして、キャッシュメカニズムによるダーティデータを防ぎます。 NLB：サーバーグループの作成ロジックを最適化し、サーバーグループが重複して作成されることがある問題を防止しました。 CLB：Pod ENI を CLB インスタンスにアタッチする際に IP アドレスチェックを追加しました。IP アドレスはクラスターの VPC 内にある必要があります。	このアップグレードはサービスに影響しません。