コンポーネント概要
ALB Ingress Controller は Alibaba Cloud Application Load Balancer (ALB) をベースとしており、強力な Ingress トラフィック管理機能を提供します。Nginx Ingress との互換性があり、複雑なビジネスルーティングや証明書の自動検出をサポートし、HTTP、HTTPS、QUIC プロトコルを処理できます。そのため、高スケーラビリティと大規模なレイヤー 7 トラフィック処理が求められるクラウドネイティブアプリケーションに最適です。
ALB Ingress Controller は API サーバーを監視し、Ingress リソースの変更を検出すると、動的に AlbConfig を生成し、必要な ALB インスタンス、リスナー、転送ルール、バックエンドサーバーグループを作成または更新します。Container Service for Kubernetes (ACK) クラスターにこのコンポーネントをデプロイし、ALB Ingress リソースを設定することで、Ingress トラフィックを管理できます。
使用方法
ALB Ingress Controller の使用方法については、「ALB イングレスの管理」をご参照ください。
リリースノート
2026 年 4 月
バージョン | リリース日 | 変更内容 | 影響 |
v2.20.0 | 2026 年 4 月 16 日 | 新機能： ListenerSpec の logConfig に accessLogRecordCustomizedHeadersAllowDisable: true を指定することで、accessLogRecordCustomizedHeadersEnabled を false に設定できるようになりました。
Webhook が ALB イングレスで使用中の Service または Secret リソースの削除を防止するようになりました。 Webhook に検証チェックが追加されました：path タイプが Prefix の場合、path にワイルドカード文字 * を含めることはできません。
機能強化： バグ修正： | 今回のアップグレードはご利用のワークロードに影響しません。 |
2026 年 1 月
バージョン | リリース日 | 変更内容 | 影響 |
v2.19.0 | 2026 年 1 月 7 日 | 新機能 機能強化 期限切れの証明書によりリスナー作成が失敗した場合のエラーメッセージを改善しました。 コントローラーの再調整パフォーマンスを向上させました。 検証 Webhook を強化し、以下の項目をチェックするようにしました： カスタム転送条件における SourceIP フィールドのフォーマット。 AclType フィールドの値が black または white であるかどうか。
backend で service.name は指定されているが service.port が指定されていない Ingress。
Ingress が ALB イングレスであるかどうかを確認する Webhook チェックを追加しました。
バグ修正 | 今回のアップグレードはご利用のサービスに影響しません。 |
2025 年 7 月
バージョン番号 | リリース日 | 説明 | 影響 |
v2.18.0-aliyun.1 | 2025 年 7 月 4 日 | インスタンス管理モードがデフォルトで有効になりました。AlbConfig によって自動作成された ALB インスタンスについては、ALB コンソールでリスナーや転送ルールを手動で変更できなくなります。この制限は、このバージョンへのアップグレード後に新たに作成された ALB インスタンスにのみ適用されます。既存および再利用されたインスタンスには影響しません。 AlbConfig オブジェクトで defaultCertificate フィールドを使用してデフォルト証明書を指定できるようになりました。 転送ルールの優先度ソートロジックを改善し、order フィールドのグローバル一意性要件を削除しました。 非同期タスク API クエリ時のフロー制御によって発生していたコントローラーパニックを修正しました。 HTTPS リスナーと QUIC リスナーが同じポートを共有している場合に、アクセス制御リスト (ACL) が 1 つのリスナーにしか適用されない問題を修正しました。 準備完了していない Pod に対する readinessGate チェックに固定待機間隔を実装しました。 終了操作を含まない転送アクションに対するアドミッション 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 日 | | 今回のアップグレードはご利用のサービスに影響しません。 |
v2.16.0-aliyun.1 | 2025 年 3 月 4 日 |
重要 このバージョン以降、新しく作成されるサーバーグループでは持続的接続がデフォルトで有効になります。既存のサーバーグループには影響しません。アップグレード前に、この動作変更がご利用のサービスに影響するかどうかをご確認ください。 新しいサーバーグループで持続的接続をデフォルトで有効にしました。 リスナーにカスタムタグを割り当てる機能を追加しました。 サーバーグループのアベイラビリティゾーン間通信機能を無効にする機能を追加しました。 Service 再調整の全体的なパフォーマンスを向上させました。 Pod の ReadinessGate ステータス更新タイミングを最適化しました。Pod のステータスは、関連するすべてのサーバーグループが正常に更新された後にのみ更新されるようになりました。 誤ったカナリア構成を防止するための検証を追加しました。Ingress に直接カナリアアノテーションを追加するとエラーが発生し、元の転送ルールが保持されるようになりました。カナリアリリースを行う場合は、別々の 2 つの 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-redirect 機能とレート制限機能の互換性を確保しました。 サーバーグループのセッション永続化でカスタム Cookie をサポートしました。 新しい ALB インスタンスのセキュリティグループ構成をサポートしました。（2025 年 2 月 25 日 00:00:00 UTC + 08:00 から有効） リスナー競合時のエラーメッセージを改善しました。 TLS 証明書構成と転送ルール証明書の不整合が発生した場合にイベント通知を送信するようになりました。 帯域幅プランなどの関連リソースを検証するようになりました。 gRPC プロトコルで AlbConfig による証明書構成をサポートしました。 作成者タグ機能を有効にした後、AlbConfig のタグ機能が使用できなくなる問題を修正しました。 一部のシナリオで Service 再調整が継続的にエラーを報告する問題を修正しました。 不正な AlbConfig 構成によりコンポーネントがクラッシュする問題を修正しました。
| 今回のアップグレードはご利用のサービスに影響しません。 |
2024 年 5 月
バージョン | リリース日 | 変更内容 | 影響 |
v2.13.1-aliyun.1 | 2024 年 5 月 10 日 | | 今回のアップグレードはご利用のサービスに影響しません。 |