すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:ALB Ingress Controller

最終更新日:Feb 14, 2026

ALB Ingress は、Alibaba Cloud Application Load Balancer (ALB) を使用して、クラスター内のサービスに統一されたエントリポイントを提供します。このトピックでは、ALB Ingress Controller の使用方法と、その変更履歴について説明します。

注意事項

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

  • ALB Ingress Controller コンポーネントのインストール方法の詳細については、「ALB Ingress Controller コンポーネントの管理」および「サービスを公開するための ALB Ingress の作成と使用」をご参照ください。

  • ACK マネージドクラスター のセキュリティ上の制限により、2024年5月以降に作成された ACK マネージドクラスター は、ALB Ingress Controller コンポーネントの v2.12.0-aliyun.1 以前のバージョンのインストールをサポートしていません。エクスペリエンスと安定性を向上させるため、できるだけ早く最新バージョンのコンポーネントをインストールしてください。

変更履歴

2026年1月

バージョン

更新時間

変更内容

変更による影響

v2.19.1

2026年2月12日

最適化:

  • OpenAPI 呼び出しが速度制限されるシナリオの処理を最適化しました。特定のエラーコードに対して自動リトライメカニズムを追加しました。

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

バグ修正:

  • Ingress イベントによってバックエンドサーバーグループが作成されたときに、システムが Pod への ReadinessGate の追加をリトライしなかった問題を修正しました。

  • リスナーログ構成が更新された後、リスナーの状態のクエリに失敗した問題を修正しました。

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

2026年1月

バージョン

更新時間

変更内容

影響

v2.19.0

2026年1月7日

新機能:

  • シークレットを使用して defaultCertificate を指定する際に、シークレットのホットリロードのサポートを追加しました。

  • Ingress の設定で、rate limiting + fixed response/redirection + forwarding の操作を同時に構成できるようになりました。

最適化:

  • 期限切れの証明書が原因でリスナーの作成に失敗した場合に表示されるエラーメッセージを最適化しました。

  • コントローラーのチューニングパフォーマンスを最適化できます。

  • Webhook の検証機能を強化しました。以下のシナリオの検証を追加しました。

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

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

    • Ingress の backend では、service.name のみが指定され、service.port は指定されません。

  • Ingress が ALB タイプであるかどうかを判断するためのチェックを Webhook に追加しました。

バグ修正:

  • AlbConfigtags フィールドが完全に削除されたときに、ALB インスタンスの対応するタグを削除できなかった問題を修正しました。

  • 極端なケースでサービスを削除すると、コントローラープロセスがパニック状態になる可能性がある問題を修正しました。

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

2025年7月

バージョン

更新時間

変更内容

影響

v2.18.0-aliyun.1

2025年7月4日

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

  • AlbConfig で defaultCertificate を使用してデフォルト証明書を手動で指定するサポートを追加しました。

  • 転送ルールの優先度ソートロジックを最適化し、order のグローバルな一意性制約を削除しました。

  • ECS メタデータ強化専用モードのサポートを追加しました。

  • 非同期タスク API 操作のクエリ時に速度制限によりコントローラーがパニック状態になる可能性がある問題を修正しました。

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

  • readinessGate が未準備の Pod を待機する際に、固定待機間隔を使用するようにしました。

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

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

2025年3月

バージョン

更新時間

変更内容

影響

v2.17.2-aliyun.1

2025年3月31日

  • 複数の名前空間の Ingress ルールが同じ名前だが異なるポートを持つサービスを指していた場合に、「ポートが存在しません」というエラーでサーバーグループの調整に失敗した問題を修正しました。

  • IPv6 デュアルスタッククラスターで IPv4 アドレスをクエリする際に発生したパラメーターエラーを修正しました。

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

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

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

v2.17.1-aliyun.1

2025年3月18日

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

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

v2.16.0-aliyun.1

2025年3月4日

重要

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

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

  • リスナーのカスタムタグ設定のサポートを追加しました。

  • サーバーグループのクロスゾーン機能を無効にするサポートを追加しました。

  • サービスの全体的なチューニングパフォーマンスを最適化できます。

  • ReadinessGate 機能の Pod ステータス更新タイミングを最適化しました。Pod ステータスは、すべてのサーバーグループが正常に更新された後にのみ更新されるようになりました。

  • カナリア段階的リリースは、2つの Ingress に分割するか、カスタム転送アクションを使用することで実装する必要があります。Canary アノテーションが Ingress に直接誤って追加された場合、システムはエラーを報告し、元の転送ルールを保持します。

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

2025年1月

バージョン

更新時間

変更内容

影響

v2.15.2-aliyun.1

2025年1月24日

  • リスナーの XForwardedForConfigXForwardedForProcessingMode を構成して、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-redirect をレート制限機能と互換性があるようにしました。

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

  • 2025年2月25日 00:00:00 (UTC+8) 以降に作成された ALB インスタンスのセキュリティグループの構成のサポートを追加しました。

  • リスナー競合のエラーメッセージを最適化しました。

  • TLS 証明書構成と転送ルール証明書の間の不整合に対するイベント通知を追加しました。

  • インターネット共有帯域幅などの関連リソースの有効性の検証を追加しました。

  • AlbConfig を使用して gRPC プロトコルの証明書を構成できます。

  • 作成者タグ機能が有効になった後、AlbConfig のタグ機能を使用できなかった問題を修正しました。

  • 一部のシナリオでサービス調整が継続的にエラーを報告した問題を修正しました。

  • 不適切な AlbConfig 構成によりコンポーネントがクラッシュした問題を修正しました。

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

2024年10月

バージョン

更新時間

変更内容

影響

v2.14.1-aliyun.1

2024年10月12日

  • HTTPS ヘルスチェックの構成に失敗した問題を修正しました。

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

2024年9月

バージョン

更新時間

変更内容

影響

v2.14.0-aliyun.1

2024年9月10日

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

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

  • 接続ドレインの構成のサポートを追加しました。

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

  • 一部のケースで ReadinessGate ステータスが正しく更新されなかった問題を修正しました。

  • シークレットのエラーメッセージを最適化しました。

  • 構成状態のサーバーグループの調整ロジックを最適化しました。

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

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

2024年7月

バージョン

更新時間

変更内容

影響

v2.13.2-aliyun.1

2024年7月23日

  • 不適切な AlbConfig フォーマットによりコントローラーがクラッシュした問題を修正しました。

  • Flannel ネットワークモードで ECS および ECI エンドポイントが一緒にマウントされたときに、重みが正しく設定されなかった問題を修正しました。

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

2024年5月

バージョン

更新時間

変更内容

影響

v2.13.1-aliyun.1

2024年5月10日

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

  • Flannel ネットワークプラグインを使用している場合に、エンドポイントの更新後に重みが正しく設定されない可能性がある問題を修正しました。

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

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

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 アドレス割り当てタイプ (`addressAllocateMode`) を指定しないようにしました。

  • X-Forwarded-For ヘッダーの信頼された IP アドレスを構成するサポートを追加しました。

  • AlbConfig の一部のフィールドを空の値から 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 Controller は AlbConfig のポート情報を自動的に更新しなくなります。AlbConfig を作成する際は、使用するポートを手動で指定してください。AlbConfig の作成例については、「サービスを公開するための ALB Ingress の作成と使用」をご参照ください。

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

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

  • アクセスログにカスタムヘッダーを記録するサポートを追加しました。

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

  • Ingress ルールを更新する際に AlbConfig を自動的に更新しないようにしました。

  • リスナー上に Ingress ルールがまだ存在する場合、AlbConfig からリスナーを削除することを禁止しました。

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

  • マルチページ証明書をサポートするために、証明書関連付けロジックを最適化しました。

  • 不適切な HTTP/2 構成に関する問題を修正しました。

  • 不適切な転送アクション構成によりコントローラーがクラッシュする可能性がある問題を修正しました。

  • コントローラーが再起動したときに、バックエンドサーバーグループが迅速に更新されない可能性がある問題を修正しました。

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

2023年8月

バージョン

更新時間

変更内容

影響

v2.10.0-aliyun.1

2023年8月15日

  • ALB Ingress Controller が再起動したときに予期せぬ変更を防ぐために、Ingress と AlbConfig にハッシュ値を追加するサポートを追加しました。

  • 異常なアクティビティの公開を最適化しました。

  • 予約語が使用されている場合の調整動作を最適化しました。

  • Ingress リソースが削除された後、キャッシュが同期されなかった問題を修正しました。

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

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

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

2023年7月

バージョン番号

更新時間

変更内容

影響

v2.9.0-aliyun.1

2023年7月11日

  • サービスが複数のサーバーグループを同時に調整する際の API 速度制限を回避しました。

  • サービス調整イベントを公開しました。

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

  • 自動証明書検出中に SM シリーズ証明書を除外しました。

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

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

  • Ingress に複数のアクションを構成すると、アップグレード/ダウングレードが失敗した問題を修正しました。

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

2023年6月

バージョン

更新時間

変更内容

影響

v2.8.3-aliyun.1

2023年6月5日

  • サーバー調整がリトライしなかった問題を修正しました。

  • カスタム転送ルールのキー設定が効果がなかった問題を修正しました。

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

2023年5月

バージョン

更新時間

変更内容

影響

v2.8.2-aliyun.1

2023年5月25日

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

  • インターネット共有帯域幅パッケージをデタッチする際の削除ロジックを削除しました。

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

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

v2.8.1-aliyun.1

2023年5月9日

  • マネージドコンポーネントは、複数のレプリカを使用するため、デフォルトで高可用性です。

  • ALB インスタンスの作成時にリソースグループを指定するサポートを追加しました。

  • ヘルスチェックの複数の状態コードのサポートを追加しました。

  • バックエンドサーバーグループの一貫したハッシュのサポートを追加しました。

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

  • シングルゾーンを指定するサポートを追加しました。

  • インスタンスネットワークタイプの更新のサポートを追加しました。

  • インターネット共有帯域幅のアタッチのサポートを追加しました。

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

  • エラーメッセージを最適化しました。

  • コンソールと比較して、デフォルト証明書の不整合と重複設定を修正しました。

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

2023年3月

バージョン

更新時間

変更内容

影響

v2.7.0-aliyun.1

2023年3月14日

  • Reconcile フローとルール優先度を最適化し、ルール同期速度を向上させました。

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

  • サービスをバックエンドサーバーグループに直接バインドできます。

  • ACL リソース ID の直接関連付けのサポートを追加しました。

  • HTTPS と QUIC を同じポートにデプロイするサポートを追加しました。

  • 複数のサーバーグループとカスタムアクションの再書き込みのサポートを追加しました。カスタムアクションの大文字と小文字を区別しないようにしました。

  • シークレットによって構成された証明書は AlbConfig の証明書よりも優先度が高いようにしました。

  • タイムアウト期間のハードコーディングを削除しました。

  • 不適切な Gzip 圧縮構成に関する問題を修正しました。

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

2022年12月

バージョン

更新時間

変更内容

影響

v2.6.0-aliyun.1

2022年12月23日

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

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

  • Ingress の削除がブロックされた問題を修正しました。非ブロッキング削除をサポートするために Finalizer を削除しました。

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

  • 重複する Ingress 証明書検出に関する問題を修正しました。

  • カナリアグレースケールバックエンドサーバーグループの不適切なタグに関する問題を修正しました。

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

2022年11月

バージョン

更新時間

変更内容

影響

v2.5.0-aliyun.1

2022年11月23日

  • シークレット証明書のアップロードのサポートを追加しました。

  • カスタムヘッダーと Cookie のサポートを追加しました。

  • ACL ホワイトリストを設定できます。

  • リスナー処理ロジックを最適化しました。リスナーエラーを調整から分離しました。リスナー 443 のエラーはリスナー 80 の調整に影響しません。

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

2022年8月

バージョン

更新時間

変更内容

影響

v2.4.0-aliyun.1

2022年8月10日

  • クロスドメインリクエストのサポートを追加しました。

  • バックエンドサーバーへの持続的接続のサポートを追加しました。

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

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

2022年6月

バージョン

更新時間

変更内容

影響

v2.3.0-aliyun.1

2022年6月23日

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

2022年4月

バージョン

更新時間

変更内容

影響

v2.2.0-aliyun.1

2022年4月13日

  • 再書き込みのサポートを追加しました。アノテーションで再書き込み機能を構成できます。詳細については、「再書き込みの構成」をご参照ください。

  • TCP ヘルスチェックプロトコルのサポートを追加しました。このプロトコルは SYN ハンドシェイクメッセージを送信して、サーバーポートが稼働しているかどうかを検出します。詳細については、「ヘルスチェックの構成」をご参照ください。

  • TLS セキュリティポリシーを指定するサポートを追加しました。AlbConfig で HTTPS リスナーを構成する際に TLS セキュリティポリシーを指定できます。詳細については、「TLS セキュリティポリシーの指定」をご参照ください。

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