API Gateway:セルフマネージド NGINX Ingress ゲートウェイをクラウドネイティブ API Gateway に移行する

前提条件

• Container Service for Kubernetes (ACK) クラスター、Serverless Kubernetes クラスター、または ACS クラスターが作成され、クラスターに NGINX Ingress Controller がデプロイされています。

• クラウドネイティブ API Gateway インスタンスが作成されています。詳細については、「ゲートウェイインスタンスを作成する」をご参照ください。

注意事項

• このトピックでは、クラウドネイティブ API Gateway インスタンスは、移行中に Ingress の構成を再利用します。Ingress の構成はコピーされません。インスタンスは、既存の Ingress 構成の変更をリアルタイムでリッスンし、リッスンした構成を解析します。

• 移行中、NGINX Ingress Controller とクラウドネイティブ API Gateway インスタンスの両方が Ingress 構成の変更を認識できます。

• 移行が完了した後、使用中のオンライン NGINX Ingress 構成を削除しないでください。移行の目的は、クラウドネイティブ API Gateway インスタンスが既存および新規の Ingress 構成をリッスンして解析できるようにすることです。

• 移行が完了した後も、既存および新規の Ingress 構成は、NGINX Ingress ゲートウェイの Ingress クラスに関連付けられている必要があります。たとえば、NGINX Ingress ゲートウェイの spec の ingressClassName の値が nginx の場合、この設定は移行後も既存および新規の Ingress 構成で変更されません。

手順

クラウドネイティブ API Gateway は、プロンプトに従ってルート構成とトラフィックを移行するための移行ツールを提供します。

ステップ 1：ルーティングルールを移行する

1. クラウドネイティブ API Gateway コンソールにログインします。

2. 左側のナビゲーションウィンドウで、[クラウドに移行] をクリックします。

3. [クラウドに移行] ページで、[タスクの作成] をクリックします。

4. [移行構成の作成] パネルで、パラメーターを構成します。

   クラウドネイティブ API Gateway は、クラスター内のソース Ingress クラスに関連付けられているすべての Ingress リソースの変更を自動的にリッスンし、Ingress リソースのドメイン名とルートの構成を有効にします。

   重要

   宛先クラウドネイティブ API Gateway インスタンスがクラスターに関連付けられており、クラスターの既存の Ingress クラスがこのステップで構成された Ingress クラスと同じでない場合、移行は許可されません。このステップで構成された Ingress クラスが、関連付けられたクラスターに構成された Ingress クラスと同じであることを確認する必要があります。

   パラメーター	説明
   インスタンス	NGINX Ingress ゲートウェイを移行するインスタンス。
   ソースクラスター	NGINX Ingress ゲートウェイが属するクラスター。クラウドネイティブ API Gateway インスタンスとクラスターが同じ VPC にあることを確認する必要があります。
   API 名	NGINX Ingress ゲートウェイがインポートされる HTTP API の名前。
   リソースグループ	NGINX Ingress ゲートウェイを移行するリソースグループ。
   名前空間	移行する Ingress リソースが関連付けられている名前空間。
   IngressClass	移行する Ingress リソースが関連付けられている Ingress クラス。 説明 1 つの Ingress クラスのみがサポートされています。 このパラメーターを指定しない場合、クラウドネイティブ API Gateway インスタンスはクラスター内のすべての Ingress リソースをリッスンします。

5. [次へ] をクリックします。

   クラウドネイティブ API Gateway インスタンスは、クラスター内のソース Ingress クラスに関連付けられているすべての Ingress リソースの変更を自動的にリッスンし、Ingress リソースのドメイン名とルートの構成を有効にします。

   1. この例では、nginx-route という名前の Ingress がクラスターにデプロイされています。

   2. クラウドネイティブ API Gateway コンソールでは、クラスターの Ingress がクラウドネイティブ API Gateway インスタンスに自動的に同期され、Ingress のドメイン名とルートが生成されていることがわかります。

ステップ 2：ルートを確認する

クラウドネイティブ API Gateway インスタンスがリッスンする Ingress リソースの互換性を確認します。

• すべての Ingress アノテーションがクラウドネイティブ API Gateway インスタンスと互換性がある場合は、次のステップに進みます。

• Ingress アノテーションがクラウドネイティブ API Gateway インスタンスと互換性がない場合は、チケットを送信します。

  重要

  • 値が二重引用符 ("") のアノテーション nginx.ingress.kubernetes.io/service-weight は無視できます。このアノテーションは古い ACK コンソールにデフォルトで追加され、意味がありません。

  • 移行中は、使用中の互換性のないアノテーションを削除しないでください。これらの互換性のないアノテーションは、引き続き NGINX Ingress Controller によって解析され、ビジネストラフィックに影響を与えます。

ステップ 3：トラフィック切り替え方法を選択する

トラフィック切り替え前にテストトラフィック分散を行う

トラフィックを切り替える前に、次の操作を実行してローカルテストを実行することをお勧めします。ローカルホストファイルを修正し、DNS サービスのクラウドネイティブ API Gateway インスタンスに関連付けられた Server Load Balancer (SLB) インスタンスの IP アドレスのマッピングを追加してから、curl や Postman などのツールを使用して、トラフィック分散が期待どおりであるかどうかを確認します。

トラフィック切り替え方法を選択する