API Gateway:HTTP API を使用して ACK のアプリケーションにアクセスする

前提条件

1. ACK クラスタが作成されていること。詳細については、「ACK マネージドクラスターを作成する」をご参照ください。

2. マイクロサービス デモが ACK にデプロイされていること。

   マイクロサービス デモをデプロイする

   ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスタ] を選択します。

   [クラスタ] ページで、管理するクラスタをクリックします。クラスタ詳細ページの左側のナビゲーションツリーで、[ワークロード] > [デプロイメント] を選択します。

   [デプロイメント] ページで、[YAML から作成] をクリックします。[テンプレート] フィールドに、次の YAML 形式のコードを入力して、httpbin という名前の deployment と httpbin という名前の service を作成します。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin

   [デプロイメント] ページで、作成した httpbin デプロイメントをクリックします。デプロイメントのステータスが [実行中] の場合、マイクロサービス アプリケーションは正常にデプロイされています（次の図を参照）。

   

プロセスの概要

最初にクラウドネイティブ API Gateway インスタンスを作成します。次に、ACK からサービスを関連付けます。その後、クラウドネイティブ API Gateway で関連付けられたサービスのルーティング ポリシーを作成し、ルーティング ポリシーに基づいてサービスにアクセスできるようにします。

1. クラウドネイティブ API Gateway インスタンスを作成する。

   この手順では、マイクロサービス環境に基づいてクラウドネイティブ API Gateway インスタンスを作成します。

2. HTTP API を作成する。

   この手順では、ゲートウェイ インスタンスに HTTP API を作成します。

3. ルートを作成する。

   この手順では、サービスのルーティング ポリシーを設定し、ルーティング ポリシーを公開します。

   1. サービス ソースを追加する。

      このサブステップでは、クラウドネイティブ API Gateway にサービス ソースを追加します。この例では、ACK をサービス ソースとして使用します。

   2. サービスを追加する。

      このサブステップでは、サービスを追加します。クラウドネイティブ API Gateway は ACK から名前空間を取得し、既存のサービスを候補サービスとして追加できます。

4. ルートをデバッグする。

   この手順では、作成されたルートが期待どおりに機能するかどうかを確認し、必要に応じてルートを調整します。

手順 1：クラウドネイティブ API Gateway インスタンスを作成する

1. クラウドネイティブ API Gateway コンソール にログインします。初めてクラウドネイティブ API Gateway を使用する場合は、次の操作を実行する必要があります。

   説明

   初めてクラウドネイティブ API Gateway にアクセスする場合、サービスロールを作成するための承認を求めるメッセージが表示されます。

   1. 表示されたページで、[今すぐ承認] をクリックします。表示されたダイアログボックスで、[OK] をクリックしてサービスロールを作成します。

   2. [クラウドネイティブ API Gateway を今すぐ体験] をクリックして、コンソールに移動します。

2. 左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のナビゲーションバーで、リージョンを選択します。次に、[インスタンスの作成] をクリックします。

   重要

   インスタンスが ACK クラスタと同じリージョンに作成されていることを確認してください。

3. 購入ページで、パラメータを設定し、[今すぐ購入] をクリックします。

   

4. [注文の確認] ページで、サービス規約を読み、[今すぐアクティブ化] をクリックします。

   説明

   インスタンスの作成には 2 ～ 3 分かかる場合があります。

5. [インスタンス] ページに戻り、作成されたインスタンスの情報とステータスを確認します。

   インスタンス情報が期待どおりで、[ステータス] が [実行中] の場合、インスタンスは正常に作成されています。

手順 2：HTTP API を作成する

1. クラウドネイティブ API Gateway コンソールの API ページで、[API の作成] をクリックします。

2. 表示されるダイアログボックスで、[HTTP API] セクションの [作成] をクリックします。[API 名] パラメーターを、[HTTP API の作成] パネルで指示に従って構成します。

手順 3：ルートを作成する

1. クラウドネイティブ API Gateway コンソールの API ページで、管理する API をクリックします。

   [ルートの作成] をクリックします。[ルートの作成] パネルで、パラメータを設定します。

基本的なルート情報を設定する

• ドメイン名：右側の [ドメイン名の追加] をクリックして、[ドメイン名の追加] パネルでドメイン名を作成できます。

• パス：ドロップダウンリストから [プレフィックス] を選択し、フィールドにスラッシュ (/) を入力して、/ で始まる HTTP リクエストと一致させます。

インスタンスを選択し、バックエンド サービスを設定する

1. [インスタンス] ドロップダウンリストから、手順 1 で作成したインスタンスを選択します。

   

2. シナリオ：[シナリオ] ドロップダウンリストから [単一サービス] を選択します。

3. [バックエンド サービス] パラメータで、[サービス名] の下の [サービスの作成] をクリックします。

4. サービス ソースとサービスを作成します。

   1. [ソース タイプ] ドロップダウンリストから [ACK] を選択します。

   2. [ソースの追加] をクリックし、前提条件 セクションで作成したクラスタを選択します。

   3. [サービス リスト] から httpbin を選択し、[OK] をクリックします。

      

   4. [バックエンド サービス] 設定項目で、[サービス名] ドロップダウンリストから前の手順で作成したサービスを選択します。

      

5. [保存して公開] をクリックします。

手順 4：ルートをデバッグする

1. クラウドネイティブ API Gateway コンソールの API ページで、管理する API をクリックします。

2. ルート リストで httpbin-demo を見つけ、[アクション] 列の [デバッグ] をクリックします。

3. 表示されたページで、バージョンを入力し、[送信] をクリックします。次の図は、返される結果を示しています。

   

関連情報

• 複数の ACK クラスタを管理する方法の詳細については、「クラウドネイティブ API Gateway を使用して複数の ACK クラスタを管理する」をご参照ください。

• クラウドネイティブ API Gateway の使用に関するよくある質問（FAQ）については、「FAQ」をご参照ください。