このトピックでは、Nginx Ingress Controller コンポーネントについて説明し、その使用方法を説明し、変更履歴をリストします。
コンポーネントについて
Ingress の概念
Kubernetes クラスターでは、Ingress はクラスター内のサービスを公開するアクセスポイントとして機能します。クラスター内のサービス宛てのネットワークトラフィックのほとんどを分散します。Ingress は、Kubernetes クラスター内のサービスへの外部アクセスを可能にするために使用される Kubernetes リソースオブジェクトです。Ingress のルーティングルールを構成して、ネットワークトラフィックをさまざまなサービスのバックエンド Pod にルーティングできます。ACK での Ingress の比較については、「Nginx Ingress、ALB Ingress、および MSE Ingress の比較」をご参照ください。
Nginx Ingress Controller の仕組み
Ingress が正常に機能するのは、クラスターに NGINX Ingress コントローラーをデプロイして Ingress のルーティングルールを解析する場合のみです。NGINX Ingress コントローラーがルーティングルールに一致するリクエストを受信すると、NGINX Ingress コントローラーはそのリクエストを対応するバックエンドサービスにルーティングします。その後、バックエンドサービスはリクエストを Pod に転送します。Kubernetes クラスターでは、サービス、Ingress、および NGINX Ingress コントローラーは次のプロセスで動作します。
サービスは、一連のレプリケートされた Pod で実行されるバックエンドアプリケーションの抽象化です。
Ingress にはリバースプロキシのルールが含まれています。HTTP または HTTPS リクエストがどのサービス Pod にルーティングされるかを制御します。たとえば、リクエストは、リクエスト内のホストと URL パスに基づいて、異なるサービス Pod にルーティングされます。
NGINX Ingress コントローラーは、Ingress ルールを解析するリバースプロキシプログラムです。Ingress ルールに変更が加えられると、NGINX Ingress コントローラーはそれに応じて Ingress ルールを更新します。NGINX Ingress コントローラーがリクエストを受信すると、Ingress ルールに基づいてリクエストをサービス Pod にリダイレクトします。
Nginx Ingress Controller とクラスターバージョンの互換性
ターゲットコンポーネントのバージョンが現在のクラスターバージョンと互換性がない場合は、コンポーネントをアップグレードする前にクラスターをアップグレードする必要があります。詳細については、「クラスターのアップグレード」をご参照ください。
Nginx Ingress Controller バージョン | 互換性のあるクラスターバージョン |
[v1.5.1-aliyun.1, v1.11.5-aliyun.1] | 1.22 以降 |
[v1.1.0-aliyun.1, v1.2.1-aliyun.1] | 1.20 以降 |
古いバージョンのリスク
Nginx Ingress Controller v1.2 以前のメンテナンスは終了しました。詳細については、「プロダクトのお知らせ」をご参照ください。古いコンポーネントバージョンは、新しいバージョンで利用可能な機能やバグ修正をサポートしていません。古いバージョンではタイムリーな技術サポートを受けることができず、パッチが適用されていないセキュリティ脆弱性が含まれている可能性があります。速やかにコンポーネントをアップグレードしてください。
使用上の注意
Nginx Ingress Controller のインストールまたはアップグレードについては、「Nginx Ingress Controller コンポーネントの管理」および「Nginx Ingress Controller コンポーネントのアップグレード」をご参照ください。
コンソールまたは kubectl を使用して Nginx Ingress を作成、表示、更新、削除するには、「Nginx Ingress を作成してサービスを公開する」をご参照ください。
Nginx Ingress Controller の使用方法の詳細については、「Nginx Ingress を使用した段階的およびブルーグリーンデプロイメント」、「Ingress コントローラー SLB インスタンスのネットワークタイプを構成する」、および「Nginx Ingress を使用してアプリケーショントラフィックを複製する」をご参照ください。
変更履歴
2025 年 9 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.11.5-release.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-release.2 | 2025 年 9 月 11 日 | 機能の最適化:
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2025 年 3 月
バージョン | イメージ URL | 変更日 | 変更 | 変更による影響 |
v1.11.5-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.5-aliyun.1 | 2025 年 3 月 26 日 | コミュニティバージョン v1.11.5 に更新され、CVE-2025-1097、CVE-2025-1098、CVE-2025-1974、CVE-2025-24513、および CVE-2025-24514 が修正されました。詳細については、「CVE-2025-1097、CVE-2025-1098、CVE-2025-1974、CVE-2025-24513、および CVE-2025-24514 に関するお知らせ」をご参照ください。 重要 CVE-2025-1974 脆弱性を修正するため、このバージョンから Nginx Ingress Controller コンポーネントで Validation Webhook が有効になりますが、ネイティブの NGINX 構成検証ロジックはデフォルトで無効になっています。ネイティブの NGINX 命令をカスタマイズするために使用されるスニペットアノテーションを有効にしている場合、これらの構成は Validation Webhook によって事前検証されなくなります。関連するエラーは、NGINX が構成を再読み込みするときにのみアラートをトリガーします。Ingress ルールを変更した後、Nginx Ingress Controller の Pod ログを確認してください。エラーログに基づいて Ingress 構成を修正してください。 注: 不正な構成は、実行中の Nginx Ingress Pod には影響しません。ただし、スケールアウトや再起動などの操作を実行すると、構成エラーが原因で新しい Pod の起動に失敗する可能性があります。本番環境で構成を変更する前に、テスト環境でスニペット命令を完全に検証してください。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
v1.11.4-aliyun.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.2 | 2025 年 3 月 19 日 | Pod が Lingjun ノードにスケジュールされるのを防ぐために、ノードスケジューリングアフィニティ構成を最適化しました。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2025 年 2 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.11.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.11.4-aliyun.1 | 2025 年 2 月 12 日 | コミュニティバージョン v1.11.4 に更新されました。コンソールでコンポーネントにカスタムトポロジースプレッド制約を追加できるようになりました。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2024 年 8 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.10.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.4-aliyun.1 | 2024 年 8 月 20 日 | コミュニティバージョン v1.10.4 に更新され、CVE-2024-7646 脆弱性が修正されました。脆弱性の詳細については、「セキュリティ問題」をご参照ください。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2024 年 7 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.10.2-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.10.2-aliyun.1 | 2024 年 7 月 24 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 10 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.9.3-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.9.3-aliyun.1 | 2023 年 10 月 24 日 | 重要 セキュリティ上の理由から、このバージョン以降、コンポーネントでは セキュリティと安定性のリスクがあるため、スニペットアノテーションを有効にすることはお勧めしません。この機能を使用するには、リスクを十分に評価してから、
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 9 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.8.2-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.2-aliyun.1 | 2023 年 9 月 20 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 6 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.8.0-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.8.0-aliyun.1 | 2023 年 6 月 20 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 5 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.7.0-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.7.0-aliyun.1 | 2023 年 5 月 5 日 | 重要 このバージョンでは、デフォルトで TLS 1.1 および TLS 1.0 暗号化方式がサポートされなくなりました。Nginx Ingress Controller をこのバージョンにアップグレードする場合は、サービスへの影響に注意してください。この問題の影響の詳細については、「v1.6.4 以降で ssl-protocols 設定が機能しない」をご参照ください。古い TLS 暗号化方式の使用を強制するには、構成手順について「以前の Nginx Ingress バージョンの既知の問題」をご参照ください。
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 3 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.6.4-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.6.4-aliyun.1 | 2023 年 3 月 17 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2023 年 2 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.5.1-aliyun.1 | registry-cn-hangzhou.ack.aliyuncs.com/acs/aliyun-ingress-controller:v1.5.1-aliyun.1 | 2023 年 2 月 10 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2022 年 6 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.2.1-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.1-aliyun.1 | 2022 年 6 月 28 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2022 年 5 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.2.0-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.2.0-aliyun.1 | 2022 年 5 月 10 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2022 年 4 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.12-27ae67262-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.12-27ae67262-aliyun | 2022 年 4 月 29 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2022 年 3 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.1.2-aliyun.2 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.2-aliyun.2 | 2022 年 3 月 21 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2022 年 1 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.1.0-aliyun.2 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.2 | 2022 年 1 月 12 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 12 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v1.1.0-aliyun.1 | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v1.1.0-aliyun.1 | 2021 年 12 月 17 日 |
詳細については、「コミュニティ変更履歴」をご参照ください。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 10 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.9-7b9e93e7e-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.9-7b9e93e7e-aliyun | 2021 年 10 月 28 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 9 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.5-e66e17ee3-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.5-e66e17ee3-aliyun | 2021 年 9 月 6 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 6 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.3-8e83e7dc6-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.3-8e83e7dc6-aliyun | 2021 年 6 月 1 日 | CVE-2021-23017 脆弱性を修正しました。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 4 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.2-abf1c6fe4-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.2-abf1c6fe4-aliyun | 2021 年 4 月 1 日 | log_format で構成された | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2021 年 3 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.44.0.1-5e842447b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.44.0.1-5e842447b-aliyun | 2021 年 3 月 8 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2020 年 4 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.30.0.1-5f89cb606-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.30.0.1-5f89cb606-aliyun | 2020 年 4 月 2 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2019 年 10 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.22.0.5-552e0db-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.5-552e0db-aliyun | 2019 年 10 月 24 日 | 動的サーバー更新が有効な場合に、ワイルドカードドメイン名、ホワイトリスト、およびリダイレクト構成のサポートが追加されました。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2019 年 7 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.22.0.4-5a14d4b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.4-5a14d4b-aliyun | 2019 年 7 月 18 日 | Perl 正規表現によるマッチングをサポートするために、段階的リリースルールが最適化されました。 | オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2019 年 4 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.22.0.3-da10b7f-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.22.0.3-da10b7f-aliyun | 2019 年 4 月 25 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2019 年 1 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.20.0.2-cc39f1b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.2-cc39f1b-aliyun | 2019 年 1 月 17 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |
2018 年 11 月
バージョン | イメージ URL | 変更日 | 変更 | 影響 |
v0.20.0.1-4597ce2-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/aliyun-ingress-controller:v0.20.0.1-4597ce2-aliyun | 2018 年 11 月 29 日 |
| オフピーク時にコンポーネントをアップグレードしてください。アップグレードプロセスにより、一時的な接続の中断が発生する可能性があります。 |