Cloud Controller Manager: 概要と変更履歴 - Container Compute Service

Cloud Controller Manager (CCM) は、Kubernetes クラスターの負荷分散サービスを管理するために使用されます。このトピックでは、CCM の概要、注意事項、およびリリースノートについて説明します。

概要

CCM を使用すると、Kubernetes を Alibaba Cloud のインフラストラクチャサービスと連携させ、ACS クラスター内の負荷分散サービス (クラシックロードバランサー (CLB) や Network Load Balancer (NLB) など) を管理できます。

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

注意事項

CCM を使用した負荷分散サービスの管理方法の詳細については、次のトピックをご参照ください。
- 負荷分散を設定する前に、考慮事項にご注意ください。詳細については、「LoadBalancer サービスを設定する際の考慮事項」をご参照ください。
- 負荷分散の設定方法の詳細については、「自動作成された SLB インスタンスを使用したアプリケーションの公開」および「既存の SLB インスタンスを使用したアプリケーションの公開」をご参照ください。
- また、サービス設定にアノテーションを追加することで、負荷分散をカスタマイズすることもできます。CCM はカスタム設定をサポートしています。詳細については、「Service の YAML ファイルへのアノテーション追加による CLB インスタンスの設定」をご参照ください。
CCM が更新の事前チェックに失敗した場合の対処方法の詳細については、「CCM が更新の事前チェックに失敗した場合の対処方法」をご参照ください。

リリースノート

2026年4月

バージョン

イメージアドレス

更新時間

変更

影響

v2.14.0

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

2026年4月13日

このバージョンは段階的に展開されています。

新機能：

アノテーション service.beta.kubernetes.io/alibaba-cloud-loadbalancer-ip-version: "DualStack" を使用して、IPv4 と IPv6 の両方のバックエンドをサーバーグループにアタッチし、IP バージョンのアフィニティを自動的に有効にできるようになりました。
spec.loadBalancerSourceRanges フィールドを使用して、許可されるクライアントアドレス範囲を指定できるようになりました。
アノテーション service.beta.kubernetes.io/alibaba-cloud-loadbalancer-default-weight を使用して、サーバーグループのデフォルトの重みを設定または更新できるようになりました。

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

2026年1月

バージョン

イメージ URL

変更時間

説明

影響

v2.13.0

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

2026年1月30日

新機能：

CLB で、service.beta.kubernetes.io/alibaba-cloud-loadbalancer-domain-extensions アノテーションを使用して HTTPS リスナーに追加のドメイン証明書を設定できるようになりました。
NLB で、service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-cert-ids アノテーションを使用して TCPSSL リスナーに追加の証明書を設定できるようになりました。
NLB で、service.beta.kubernetes.io/alibaba-cloud-loadbalancer-cross-zone-enabled アノテーションを使用してクロスゾーン転送 (デフォルトで有効) を設定できるようになりました。

改善点：

Elastic Network Interface (ENI) アタッチメントのロジックを最適化し、失敗した ENI アタッチメントが他のアタッチメントに影響を与えないようにしました。
vSwitch を指定せずにプライベート CLB を作成する際に、利用可能なクラスターの vSwitch がランダムに選択されるようになりました。

このアップグレードはワークロードに影響しません。

2025年12月

バージョン

イメージアドレス

リリース日

説明

影響

v2.12.4

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

2025年12月11日

新機能：

Pod readiness gate 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 のエラーログが改善されました。CLB インスタンスがバックエンド Pod の IP アドレスに対応する ENI を見つけられない場合、エラーログに Pod 名 (targetRef) とそのノード情報が含まれるようになりました。

修正された問題：

NLB 情報のクエリ中、または非同期 API 呼び出しの失敗後に発生する可能性があった、サービスの同期中のパニックを修正しました。

このアップデートはご利用のサービスに影響しません。

2025年9月

バージョン	イメージアドレス	リリース日	説明	影響
v2.12.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1	2025年9月11日	重要このバージョンから、新しい CLB インスタンスのデフォルトの課金方法がスペック課金から CLCU 課金に変更されます。既存の CLB インスタンスは影響を受けません。詳細については、「[製品変更] 新規サービスおよび Nginx Ingress Controller のデフォルトのロードバランサータイプと課金方法の変更」をご参照ください。新機能新しい CLB インスタンスのデフォルトの課金方法をスペック課金から CLCU 課金に変更。改善点 CLB と NLB の処理パフォーマンスを向上。レート制限の対象となる NLB の OpenAPI 呼び出しにリトライメカニズムを追加。サービス、ルート、ノードの同期遅延に関連するメトリクスを最適化。 `readinessGate` のリトライ待機時間を指数関数的な値から固定値に変更。修正された問題リスナーポート範囲と手動ヘルスチェックで設定した場合に、NLB がバックエンドの `targetPort` をヘルスチェックポートとして自動的に使用できない問題を修正。	このアップデートはご利用のサービスに影響しません。

2025年7月

バージョン	イメージアドレス	リリース日	説明	影響
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 リスナーポート範囲の作成が失敗する問題を修正しました。	このアップグレードはワークロードに影響しません。

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 設定のサポートが追加されました。 NLB は `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range` を使用してリスナーポート範囲の設定をサポートします。 `NLB_ENDPOINT` 環境変数を使用して、カスタム NLB OpenAPI エンドポイントを設定できます。最適化：ノードの参加とルートの追加の処理速度を最適化し、OpenAPI 呼び出しの数を削減しました。サービスの同期中にリスナーとサーバーグループの操作を並列化し、各サービスの同期時間を短縮しました。 OpenAPI を呼び出して NLB インスタンスを作成する際、EIP インスタンス ID またはプライベート IPv4 アドレスが指定されていない場合、CCM は空の文字列の代わりにヌルポインタを渡します。 DescribeNetworkInterfaces API を呼び出す際、ページネーションに `PageSize` の代わりに `NextToken` を使用します。バグ修正： Pod が準備できていない場合に、ReadinessGate を使用するサービスに対して NLB がリトライしないバグを修正しました。	このアップグレードはワークロードに影響しません。

2025年1月

バージョン番号	リリース日	説明	影響
v2.10.2	2024-01-20	新機能： `node.alibabacloud.com/spot-strategy` ラベルをノードに追加して、プリエンプティブルインスタンスとして識別するサポートが追加されました。最適化：サービスの複数のリスナーが同じサーバーグループに関連付けられている場合、サーバーグループの同期は一度だけ行われます。修正された問題：サービスが `LoadBalancer` タイプから別のタイプに変更され、その後再び `LoadBalancer` タイプに戻された場合に、ロードバランサーインスタンスが作成できない問題を修正しました。 Pod の readiness 状態を更新しようとしたときに Pod を見つけられない問題を修正しました。ロードバランサーインスタンスのタグを更新する際、`acs:` プレフィックスを持つシステムタグは無視されます。	ワークロードへの影響はありません。

2024年12月

バージョン番号	リリース日	説明	影響
v2.10.0	2024-12-02	重要このバージョン以降、`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags` アノテーションの値の変更は、作成済みおよび再利用されたロードバランサーインスタンスに影響します。このアノテーションを使用する場合、コンソールでロードバランサーのタグを変更しないでください。このバージョンにアップグレードする前に、ロードバランサーインスタンスのタグがアノテーションと一致していることを確認してください。新機能： readiness feature gate がサポートされます。 `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags` アノテーションを使用して、インスタンス作成後にタグを変更するサポートが追加されました。 `node.alibabacloud.com/node-pool-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-06-30	新機能： Addon Token 認証モードがサポートされます。 NLB は、`service.beta.kubernetes.io/alibaba-cloud-loadbalancer-server-group-type` アノテーションを使用して IP ベースのサーバーグループを作成できるようになりました。NLB サーバーグループの詳細については、「NLB サーバーグループ」をご参照ください。最適化：データキャッシュによる古いデータの生成を防ぐため、クライアントから Kubernetes API サーバーへの直接アクセスがサポートされます。 NLB サーバーグループの作成ロジックが最適化され、システムが繰り返しサーバーグループを作成するのを防ぎます。 Pod に割り当てられた ENI の IP アドレスを CLB インスタンスに追加する際に、IP アドレスの検証が実行されます。この検証は、IP アドレスがクラスターが存在する VPC の CIDR ブロック内に収まっていることを確認するために行われます。	ワークロードへの影響はありません。