すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ALB Ingress Controller

    ドキュメントセンター

    Container Service for Kubernetes:ALB Ingress Controller

    最終更新日:Jun 16, 2026

    ALB イングレスは、 Alibaba Cloud Application Load Balancer (ALB) を使用して、クラスター内の Service に対する統合された Ingress を提供します。このトピックでは、 ALB Ingress Controller の使用方法とリリースノートについて説明します。

    使用方法

    • ALB Ingress Controller の詳細については、「ALB イングレス管理」をご参照ください。

    • ALB Ingress Controller コンポーネントをインストールするには、「ALB Ingress Controller の管理」および「ALB イングレスでサービスを公開」をご参照ください。

    • ACK マネージドクラスターのセキュリティ制限により、2024 年 5 月より後に作成された ACK マネージドクラスターでは、ALB Ingress Controller コンポーネント v2.12.0-aliyun.1 以前のバージョンはサポートされなくなりました。継続的なサポートと安定性を確保するため、速やかに最新バージョンのコンポーネントにアップグレードしてください。

    リリースノート

    2026年6月

    バージョン

    日付

    変更点

    影響

    v2.20.1

    2026年6月8日

    【最適化】

    • 非同期タスクの待機時間とリトライ回数を増やしました。

    【バグ修正】

    • バージョン 1.20 以前のクラスターで、エンドポイント検出のために EndpointSlice から Endpoints へのフォールバックに失敗する不具合を修正しました。

    サービスへの影響はありません。

    2026 年 4 月

    バージョン

    リリース日

    変更

    影響

    v2.20.0

    2026 年 4 月 16 日

    新機能：

    • ListenerSpec の logConfig で accessLogRecordCustomizedHeadersAllowDisable: true を指定すると、accessLogRecordCustomizedHeadersEnabled を false に設定できるようになりました。

    • webhook が、ALB Ingress で使用されている Service または Secret の削除を防止するようになりました。

    • path タイプが Prefix の場合に path にワイルドカード文字 * を含めることができないように、ウェブフックに検証チェックが追加されました。

    機能強化：

    • コントローラーのメモリフットプリントを削減しました。

    • コントローラーは、エンドポイントの検出に、デフォルトで Endpoints ではなく EndpointSlice を使用するようになりました。

    • 非同期サーバーグループタスクの待機時間を短縮しました。

    バグ修正：

    • AlbConfig の ALB リソースグループ ID の変更が反映されない問題を修正しました。

    • カスタム転送ルールの無効な転送設定により、コントローラーがパニックを起こす可能性がある問題を修正しました。

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

    2026年2月

    バージョン

    リリース日

    変更点

    影響

    v2.19.1

    2026年2月12日

    機能強化：

    • OpenAPI 呼び出しがスロットリングされた場合に、特定の エラーコード に対する自動リトライを追加しました。

    • 空の タグ値 のサポートと、重複する タグキー の検証を追加しました。

    バグ修正：

    • Ingress によってトリガーされる バックエンドサーバーグループ の作成中に、Pod に ReadinessGate を追加する際にリトライが失敗する問題を修正しました。

    • リスナー の ログ設定 が更新された後に、リスナー のステータス照会が失敗する問題を修正しました。

    このアップグレードによる、お使いのワークロードへの影響はありません。

    2026年1月

    バージョン

    リリース日

    変更

    影響

    v2.19.0

    2026年1月7日

    新機能：

    • defaultCertificate で指定した Secret のホットリロードをサポートしました。

    • レート制限、固定レスポンス/リダイレクト、転送 のアクションを組み合わせた Ingress の設定をサポートしました。

    改善：

    • 証明書の有効期限切れでリスナーの作成に失敗した際のエラーメッセージを改善しました。

    • コントローラーの調整パフォーマンスを改善しました。

    • Webhook 検証を強化し、以下の項目をチェックするようにしました：

      • カスタム転送条件の SourceIP フィールドのフォーマット。

      • AclType フィールドが black または white であるかどうか。

      • service.port を指定せずに service.name を指定している Ingress のバックエンド。

    • Webhook は、Ingress が ALB Ingress であるかどうかをチェックするようになりました。

    バグ修正：

    • AlbConfig から tags フィールドを削除しても、ALB インスタンスからタグが削除されない問題を修正しました。

    • Service の削除時にコントローラーが稀にパニックする問題を修正しました。

    このアップグレードは、お使いのワークロードに影響はありません。

    2025年7月

    バージョン

    リリース日

    説明

    影響

    v2.18.0-aliyun.1

    2025年7月4日

    • インスタンスマネージドモードがデフォルトで有効になりました。AlbConfig を介して自動的に作成された ALB インスタンスのリスナーおよび転送ルールの設定は、ALB コンソールで手動で変更できなくなりました。この制限は、このアップグレード後に作成された新しい ALB インスタンスにのみ適用されます。既存のインスタンスと再利用されたインスタンスは影響を受けません。

    • defaultCertificate フィールドを使用して、AlbConfig でデフォルト証明書を指定できるようになりました。

    • 転送ルールの優先順位ソートロジックを最適化し、order フィールドのグローバルな一意性要件を削除しました。

    • 強化専用モードで ECS メタデータを使用できるようになりました。

    • 非同期タスク API のクエリ時にフロー制御が原因でコントローラーがパニックに陥る問題を修正しました。

    • HTTPS リスナーと QUIC リスナーが同じポートを共有している場合に、ACL が 1 つのリスナーにしか適用されない問題を修正しました。

    • readinessGate は、準備ができていない Pod を待機する際に固定間隔を使用するようになりました。

    • 終端アクションを含まない転送ルールに対する Admission Webhook の検証ロジックを最適化しました。

    このアップグレードは、お使いのサービスに影響を与えません。

    2025 年 3 月

    バージョン

    リリース日

    変更

    影響

    v2.17.2-aliyun.1

    2025 年 3 月 31 日

    • 複数の名前空間にある Ingress ルールが、同じ名前でポートが異なる Service を参照している場合に、ポートが見つからないエラーが発生してサーバーグループの調整に失敗する問題を修正しました。

    • IPv6 デュアルスタッククラスターで IPv4 アドレスを照会する際に、無効なパラメーターエラーが発生する問題を修正しました。

    • 1 回のバッチ API 呼び出しで追加または削除できるセキュリティグループの最大数を 4 から 9 に増やしました。

    • 追加のタグが不要な場合、API 呼び出しをスキップするようにしました。

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

    v2.17.1-aliyun.1

    2025 年 3 月 18 日

    • Gateway API v1.1.0 以降のサポートを追加しました。

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

    v2.16.0-aliyun.1

    2025 年 3 月 4 日

    重要

    このバージョン以降、新しいサーバーグループでは永続的な接続がデフォルトで有効になります。既存のサーバーグループには影響しません。アップグレードする前に、この変更がお客様のサービスに影響するかどうかをご確認ください。

    • 新しいサーバーグループで、永続的な接続をデフォルトで有効にしました。

    • リスナーでカスタムタグをサポートしました。

    • サーバーグループのアベイラビリティーゾーン間機能を無効にするオプションを追加しました。

    • Service の調整パフォーマンスを全体的に改善しました。

    • Pod の ReadinessGate ステータス更新のタイミングを改善しました。ステータスは、関連付けられたすべてのサーバーグループが正常に更新された後にのみ更新されるようになりました。

    • カナリアリリースでは、2 つの異なる Ingress、またはカスタム転送アクションが必要になりました。カナリアアノテーションが誤って Ingress に追加された場合、システムはエラーを報告し、元の転送ルールを保持します。

    このアップグレードはサービスに影響する可能性があります。詳細については、上記の注記をご参照ください。

    2025年1月

    バージョン

    リリース日

    変更内容

    影響

    v2.15.2-aliyun.1

    2025年1月24日

    • リスナーの XForwardedForConfig で、 XForwardedForProcessingMode を設定して X-Forwarded-For ヘッダーの処理モードを指定し、 XForwardedForHostEnabled を設定して X-Forwarded-Host リクエストヘッダーを有効化できるようになりました。

    • ValidatingWebhookConfiguration が存在しない場合に、コンポーネントが起動に失敗する問題を修正しました。

    • alb.ingress.kubernetes.io/healthcheck-httpcode に複数の値を設定した場合に Webhook 検証が失敗する問題を修正しました。

    • 転送アクションにタイプ FinalType が含まれていない場合のチェックを追加しました。

    • ALB インスタンス作成時の clientToken の計算方法を最適化しました。

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

    v2.15.0-aliyun.1

    2025年1月6日

    • AlbConfig と Ingress の設定を検証するため、 ValidatingWebhook をデフォルトで有効にしました。

    • AScript のサポートを追加しました。

    • レート制限に固定レスポンスを設定するオプションを追加しました。

    • SSL リダイレクトとレート制限を同時に使用する機能を追加しました。

    • サーバーグループのセッション維持でカスタム Cookie をサポートしました。

    • 2025年2月25日 00:00:00 (UTC+8) 以降に作成された ALB インスタンスにセキュリティグループを設定する機能を追加しました。

    • リスナーの競合に関するエラーメッセージを改善しました。

    • 転送ルールでの TLS 証明書の不一致に関するイベント通知を追加しました。

    • 帯域幅パッケージなどの関連リソースの検証を追加しました。

    • AlbConfig で gRPC プロトコルの証明書を設定する機能を追加しました。

    • createdby タグ機能の有効化後、 AlbConfig のタグ機能を使用できない問題を修正しました。

    • 特定のシナリオで Service の調整エラーが継続的に発生する問題を修正しました。

    • 無効な AlbConfig 設定が原因で発生するコンポーネントのクラッシュを修正しました。

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

    2024年10月

    バージョン

    リリース日

    説明

    影響

    v2.14.1-aliyun.1

    2024年10月12日

    • HTTPS ヘルスチェック設定が失敗する問題を修正しました。

    ワークロードへの影響はありません。

    2024 年 9 月

    バージョン

    リリース日

    説明

    影響

    v2.14.0-aliyun.1

    2024年9月10日

    • サーバーグループのヘルスチェックに gRPC のサポートを追加しました。

    • スロースタートのサポートを追加しました。

    • コネクションドレイニングのサポートを追加しました。

    • サーバーグループ間のセッション維持のサポートを追加しました。

    • 一部のシナリオで ReadinessGate のステータスが正しく更新されない問題を修正しました。

    • Secret リソースのエラーメッセージを改善しました。

    • 構成中の状態にあるサーバーグループのリコンサイルロジックを最適化しました。

    • AlbConfig のフィールドを、大文字と小文字を区別しないようにしました。

    このアップグレードは、お使いのワークロードに影響を与えません。

    2024 年 7 月

    バージョン

    リリース日

    説明

    影響

    v2.13.2-aliyun.1

    2024年7月23日

    • 無効な AlbConfig フォーマットが原因で controller がクラッシュする不具合を修正しました。

    • Flannel ネットワークモードで ECS と ECI の endpoints を併用した場合に、重みの設定が誤る不具合を修正しました。

    ワークロードへの影響はありません。

    2024年5月

    バージョン

    リリース日

    変更

    影響

    v2.13.1-aliyun.1

    2024年5月10日

    • AlbConfig が Ingress に関連付けられていない場合のイベントを追加しました。

    • Flannel ネットワークプラグインでエンドポイントを更新した後に、重みが誤って割り当てられる可能性がある問題を修正しました。

    • namespace が数字で始まる場合、または namespace もしくはサービス名が長すぎる場合に、サーバーグループの作成が失敗する問題を修正しました。

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

    2024年2月

    バージョン

    リリース日

    説明

    影響

    v2.12.0-aliyun.1

    2024 年 2 月 5 日

    • alb.ingress.kubernetes.io/server-group-type: Ip アノテーションを使用して、IP タイプのサーバーグループをサポートするようになりました。

    • alb.ingress.kubernetes.io/server-group-resource-group-id アノテーションを使用してサーバーグループのリソースグループを指定できるようになりました。

    • Flannel プラグインが、ノード上で実行されている Pod の数に基づいて各ノードの重みを自動的に設定するようになりました。

    • カスタム転送ルールの QPS スロットリングをサポートするようになりました。

    • ALB インスタンスを作成する際に、IP アドレス割り当てモードの指定が不要になりました。

    • X-Forwarded-For ヘッダーに信頼できる IP アドレスを設定できるようになりました。

    • 一部の AlbConfig フィールドが null から false に変更された際に有効にならない問題を修正しました。

    このアップグレードによるワークロードへの影響はありません。

    2023 年 11 月

    バージョン

    リリース日

    説明

    影響

    v2.11.1-aliyun.1

    2023年11月20日

    IngressClass が指定されていない場合に、コントローラーがクラッシュする可能性がある問題を修正しました。

    このアップグレードは無停止です。

    2023年10月

    バージョン

    リリース日

    変更

    影響

    v2.11.0-aliyun.1

    2023 年 10 月 31 日

    重要

    v2.11.0-aliyun.1 以降、ALB Ingress コントローラー は AlbConfig のポート情報を自動更新しなくなりました。AlbConfig を作成する際は、ポートを手動で指定する必要があります。AlbConfig の作成例については、「ALB イングレスを使用したサービスの公開」をご参照ください。

    • ソース IP レート制限のサポートを追加しました。

    • トレーシングのサポートを追加しました。

    • アクセスログでカスタムヘッダーをサポートするようになりました。

    • 相互認証のサポートを追加しました。

    • Ingress ルールの更新時に AlbConfig を自動更新する機能を無効化しました。

    • Ingress ルールが参照している場合、AlbConfig からリスナーを削除できないようにしました。

    • ALB インスタンスを再利用する場合のリソース削除動作を最適化しました。

    • ページネーションされた証明書をサポートするため、証明書の関連付けロジックを最適化しました。

    • HTTP/2 設定が誤っている問題を修正しました。

    • 転送アクションが誤って設定されている場合に、コントローラーがクラッシュする可能性がある問題を修正しました。

    • 再起動後にコントローラーがバックエンドサーバーグループを迅速に更新しない問題を修正しました。

    このアップグレードによるサービスへの影響はありません。

    2023年8月

    バージョン

    日付

    説明

    影響

    v2.10.0-aliyun.1

    2023 年 8 月 15 日

    • ALB Ingress コントローラーの再起動時に予期しない変更が発生しないよう、Ingress および ALBConfig リソースにハッシュを追加しました。

    • 異常なイベントのレポート機能を改善しました。

    • 予約済みフィールドを使用するシナリオの調整処理を最適化しました。

    • Ingress リソース削除時のキャッシュ同期に関する問題を修正しました。

    • ノードイベント処理が中断する問題を修正しました。

    • サーバーグループの同期ロジックを最適化しました。

    このアップグレードは、ワークロードに影響を与えることはありません。

    2023年7月

    バージョン

    リリース日

    説明

    影響

    v2.9.0-aliyun.1

    2023年7月11日

    • 複数のサーバーグループを同時に処理する際に API スロットリングが発生しないように、Service の調整を最適化しました。

    • Service の調整イベントを公開しました。

    • ssl-redirect アノテーション使用の最適化。

    • 証明書の自動検出時に ShangMi 証明書を除外しました。

    • カスタム転送ルールにおける cookieConfig の調整を修正しました。

    • http フィールドが設定されていない Ingress が原因でコントローラーがクラッシュする問題を修正しました。

    • Ingress に複数の Action を設定した場合に、設定の更新が失敗する問題を修正しました。

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

    2023年6月

    バージョン

    日付

    説明

    影響

    v2.8.3-aliyun.1

    2023年6月5日

    • サーバーの調整が再試行されないバグを修正しました。

    • カスタム転送ルールのキーが無視されるバグを修正しました。

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

    2023 年 5 月

    バージョン

    リリース日

    変更点

    影響

    v2.8.2-aliyun.1

    2023 年 5 月 25 日

    • Pod の再起動時に転送ルールが削除される可能性がある問題を修正しました。

    • 調整時に Internet Shared Bandwidth を削除するロジックを削除しました。

    • インスタンスのネットワークタイプの更新を一時的に無効にしました。

    このアップグレードは、ワークロードに影響を与えることはありません。

    v2.8.1-aliyun.1

    2023 年 5 月 9 日

    • マネージドコンポーネントが、高可用性のためにデフォルトで複数のレプリカを使用するようになりました。

    • ALB インスタンスの作成時にリソースグループを指定できるようになりました。

    • ヘルスチェックに複数のステータスコードを指定できるようになりました。

    • バックエンドサーバーグループにコンシステントハッシュを導入しました。

    • use-regex アノテーションのサポートを追加しました。

    • 単一のアベイラビリティーゾーンを指定できるようになりました。

    • インスタンスのネットワークタイプの更新に対応しました。

    • Internet Shared Bandwidth の関連付けをサポートするようになりました。

    • 非同期 API 呼び出しを最適化しました。

    • エラーメッセージを改善しました。

    • デフォルトの証明書のコンソール表示における不整合を解消し、証明書の重複設定を防止しました。

    このアップグレードは、ワークロードに影響を与えることはありません。

    2023 年 3 月

    バージョン

    リリース日

    説明

    影響

    v2.7.0-aliyun.1

    2023 年 3 月 14 日

    • 調整プロセスとルールの優先度を効率化し、ルールの同期を高速化しました。

    • イベント通知を最適化しました。

    • Service からバックエンドサーバーグループへの直接調整機能を追加しました。

    • リソース ID による ACL の直接関連付け機能を追加しました。

    • 同じポートでの HTTPS と QUIC のデプロイをサポートしました。

    • カスタムアクションが大文字と小文字を区別しなくなり、複数のサーバーグループと書き換えをサポートするようになりました。

    • Secret に設定された証明書が、AlbConfig に設定された証明書をオーバーライドするようになりました。

    • ハードコーディングされたタイムアウト値を削除しました。

    • Gzip 圧縮の設定エラーを修正しました。

    このアップグレードによるサービスへの影響はありません。

    2022年12月

    バージョン

    リリース日

    説明

    影響

    v2.6.0-aliyun.1

    2022年12月23日

    • ALB リソースのカスタムタグをサポートしました。

    • イベント通知を強化しました。

    • Ingress に finalizer を追加しないようにすることで、Ingress の削除がブロックされる問題を修正しました。

    • IPv6 ネットワークタイプの変更に関する問題を修正しました。

    • Ingress 証明書が繰り返し検出される問題を修正しました。

    • カナリアリリース中にバックエンドサーバーグループに誤ったタグが付与される問題を修正しました。

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

    2022年11月

    バージョン

    リリース日

    説明

    影響

    v2.5.0-aliyun.1

    2022年11月23日

    • Secret 証明書のアップロード機能を追加しました。

    • カスタムヘッダーとクッキーの追加に対応しました。

    • ACL ホワイトリストの設定を有効にしました。

    • リスナーのエラーを調整プロセスから分離することで、リスナー処理を最適化しました。ポート 443 のリスナーでエラーが発生しても、ポート 80 の調整に影響しなくなりました。

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

    2022年8月

    バージョン

    リリース日

    説明

    影響

    v2.4.0-aliyun.1

    2022年8月10日

    • CORS に対応しました。

    • バックエンドサーバーへの永続的接続に対応しました。

    • リスナーの削除ロジックを最適化しました。

    このアップグレードによるワークロードへの影響はありません。

    2022 年 6 月

    バージョン

    リリース日

    説明

    影響

    v2.3.0-aliyun.1

    2022 年 6 月 23 日

    • アノテーションを使用してサーバーグループの負荷分散アルゴリズムを設定できるようになりました。詳細については、「サーバーグループの負荷分散アルゴリズムを指定」をご参照ください。

    • リスナープロトコルに関する問題を修正しました。

    サービスに影響はありません。

    2022 年 4 月

    バージョン

    リリース日

    説明

    影響

    v2.2.0-aliyun.1

    2022年4月13日

    • アノテーションを使用して設定できるリライトのサポートが追加されました。詳細については、「リライトの設定」をご参照ください。

    • TCP ヘルスチェックのサポートが追加されました。TCP ヘルスチェックは、SYN パケットを使用してサーバーポートがアクティブであることを確認します。詳細については、「ヘルスチェックの設定」をご参照ください。

    • ALBConfig の HTTPS リスナーに TLS セキュリティポリシーを指定できるようになりました。詳細については、「TLS セキュリティポリシーの指定」をご参照ください。

    このアップグレードは、お使いのサービスに影響を与えません。