ALB Ingress Controller のリリースノート - Container Service for Kubernetes

ALB イングレスは、Alibaba Cloud の Application Load Balancer (ALB) を使用して、クラスター内のサービスに統一された Ingress を提供します。以下の使用方法とリリースノートは、互換性のあるバージョンを選択し、トラフィックを中断することなくアップグレードを計画するのに役立ちます。

使用方法

ALB Ingress コントローラーの詳細については、「ALB イングレスの管理」をご参照ください。
ALB Ingress コントローラーアドオンをインストールするには、「ALB Ingress コントローラーの管理」および「ALB Ingress を使用してサービスを公開する」をご参照ください。
ACK マネージドクラスターのセキュリティ上の制限により、2024 年 5 月以降に作成された ACK マネージドクラスターでは、ALB Ingress コントローラーアドオンの v2.12.0-aliyun.1 以前のバージョンはインストールできなくなりました。より良いエクスペリエンスと安定性の向上のために、最新バージョンのアドオンを速やかにインストールしてください。

リリースノート

2026 年 9 月

バージョン

更新日時

変更内容

影響

v3.1.1

2026 年 9 月 3 日

バグ修正：

ALB の OpenAPI がパブリックネットワークエンドポイントを誤って使用していたため、非パブリック VPC や一部のリージョンでコントローラーが失敗するバグを修正しました。

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

2026 年 8 月

バージョン番号

更新日時

変更内容

影響

v3.1.0

2026 年 8 月 10 日

新機能：

AlbServiceExtension リソースを使用して、ALB Extended Edition のサービス拡張を宣言的に管理するための Gateway API サポートを追加しました。これらの拡張は、転送ルールまたはバックエンドサーバーグループで参照できます。
AlbService リソースを使用して、ALB Extended Edition の Fqdn および IpSegment タイプのバックエンドを構成する機能を追加しました。これらのバックエンドは HTTPRoute で参照できます。

最適化：

バックエンドサーバーグループからの戻り値の順序の不一致によってトリガーされる無効な更新を防ぐために、転送ルールの更新ロジックを最適化しました。この問題は、以前はドライランの失敗を引き起こしていました。
一部のシナリオで、ヘルスチェックのステータスコードがヘルスチェックプロトコルに従って正しく解析または配信されず、ドライランが失敗する問題を修正しました。

バグ修正：

externalTrafficPolicy が Local モードに設定されている場合に、ノードの変更後に Service が速やかに調整されない問題を修正しました。

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

2026 年 7 月

バージョン番号

変更時間

変更内容

影響

v3.0.0

2026 年 7 月 6 日

新機能：

Gateway API を使用して ALB Extended Edition インスタンスを作成および管理する機能を追加しました。
AlbRule を使用して、ALB Extended Edition インスタンスの転送ルールにサービス拡張 ID を関連付ける機能を追加しました。
AlbServerGroup を使用して、ALB Extended Edition インスタンスのサーバーグループにサービス拡張 ID を関連付ける機能を追加しました。
AlbInstance カスタム CRD のサポートを追加しました。これにより、Gateway リソースの infrastructure.parametersRef を参照することで、アドレスタイプ、アベイラビリティゾーン、ログ、帯域幅パッケージなどの ALB インスタンス構成を定義できます。一部のプロパティはインスタンス作成時にのみ有効になります。
Gateway API を使用して作成された ALB Standard Edition インスタンスでは、デフォルトでインスタンスマネージドモードが有効になります。これらのインスタンスでは、リスナーと転送ルールの構成を ALB コンソールで手動で変更することはできません。この制限は、このバージョンにアップグレードした後に作成された ALB インスタンスにのみ適用されます。既存のインスタンスは影響を受けません。

最適化：

Gateway API を使用してサーバーグループを作成する際、デフォルトでバックエンドの接続保持が有効になります。既存のサーバーグループは影響を受けません。アップグレードする前に、この動作の変更がサービスに影響するかどうかを確認してください。
Gateway API は、デフォルトでエンドポイント検出に Endpoints の代わりに EndpointSlice を使用するようになりました。
Gateway API でマルチポート Service を使用する機能を追加しました。
Gateway API で ReadinessGate を使用する機能を追加しました。この機能は Terway ネットワークプラグインでのみサポートされます。Flannel ネットワークプラグインはまだサポートされていません。

バグ修正：

サービス検出エラーの後、Gateway API が自動的にリトライしない問題を修正しました。
HTTPRoute に関連付けられた Gateway リソースの削除がブロックされる問題を修正しました。
証明書エラーが発生するとリスナーが即座に削除される問題を修正しました。代わりに、証明書エラーが発生した場合は操作がブロックされ、エラーが報告されます。
Gateway API のシナリオで Service が削除された後、サーバーグループが速やかにクリアされない問題を修正しました。

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

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 にワイルドカード * を含めることができないように、Webhook に検証チェックが追加されました。

機能強化：

コントローラーのメモリフットプリントを削減しました。
コントローラーは、デフォルトでエンドポイント検出に 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 で指定されたシークレットのホットリロードをサポートします。
レート制限 + 固定レスポンス/リダイレクト + 転送アクションを持つ Ingress の構成をサポートします。

機能強化：

証明書の期限切れによりリスナーの作成が失敗した場合のエラーメッセージを改善しました。
コントローラーの調整パフォーマンスを改善しました。
Webhook の検証を強化し、以下をチェックするようにしました：
- カスタム転送条件の SourceIP フィールドのフォーマット。
- AclType フィールドが black または white であるかどうか。
- service.port なしで service.name を指定する Ingress backend。
Ingress が ALB Ingress であるかどうかを判断するための Webhook チェックを追加しました。

バグ修正：

AlbConfig から tags フィールドを削除したときに、ALB インスタンスからタグが削除されない問題を修正しました。
サービスの削除時にまれに発生するコントローラーのパニックを修正しました。

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

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 を待機する際に固定間隔を使用するようになりました。終了アクションを含まない転送ルールに対するアドミッション 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 ステータス更新のタイミングを改善しました。Pod のステータスは、関連するすべてのサーバーグループの更新が成功した後にのみ更新されます。カナリアリリースには、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-redirect とレート制限の同時使用をサポートしました。
サーバーグループのセッション維持にカスタム 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 フォーマットが原因で コントローラーがクラッシュする問題を修正しました。
Flannel ネットワークモードで ECS と ECI の エンドポイントを両方使用する場合の誤った重み設定を修正しました。

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

2024 年 5 月

バージョン

リリース日

変更内容

影響

v2.13.1-aliyun.1

2024 年 5 月 10 日

AlbConfig が Ingress に関連付けられていない場合のイベントを追加しました。
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 フィールドが 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 Ingress を使用してサービスを公開する」をご参照ください。ソース 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 の調整を最適化しました。公開サービスのリコンシリエーションイベント。 `ssl-redirect` アノテーションの使用法を最適化しました。自動証明書検出中に SM (国密) 証明書を除外しました。カスタム転送ルールの cookieConfig 調整を修正しました。 `http` フィールドが構成されていない Ingress が原因でコントローラーがクラッシュする問題を修正しました。 Ingress に複数のアクションが構成されている場合の設定更新の失敗を修正しました。	このアップグレードはワークロードに影響しません。

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 にファイナライザーを追加しないことで、ブロックされた Ingress の削除を修正します。 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 日	CORS のサポートを追加しました。バックエンドサーバーへの接続保持をサポートしました。リスナーの削除ロジックを最適化しました。	このアップグレードはワークロードに影響しません。

2022 年 6 月

バージョン	リリース日	説明	影響
v2.3.0-aliyun.1	2022 年 6 月 23 日	アノテーションを使用してサーバーグループの負荷分散アルゴリズムを構成する機能を追加しました。詳細については、「サーバーグループの負荷分散アルゴリズムを指定する」をご参照ください。リスナープロトコルに関する問題を修正しました。	サービスへの影響はありません。

2022 年 4 月

バージョン	リリース日	説明	影響
v2.2.0-aliyun.1	2022 年 4 月 13 日	アノテーションを使用して構成可能な書き換えをサポートします。詳細については、「書き換えを構成する」をご参照ください。 SYN パケットを使用してサーバーポートがアクティブであることを確認する TCP ヘルスチェックをサポートします。詳細については、「ヘルスチェックを構成する」をご参照ください。 AlbConfig で HTTPS リスナーの TLS セキュリティポリシーを指定できるようになりました。詳細については、「TLS セキュリティポリシーを指定する」をご参照ください。	このアップグレードはサービスに影響しません。