API Gateway:Cloud-native API Gateway を使用した ACK マイクロサービスの公開

前提条件

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

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

   マイクロサービスのデモのデプロイ

   ACK コンソールにログインします。 左側メニューで、 [クラスター] をクリックします。

   [クラスター] ページで、クラスターの名前をクリックします。 左側メニューで、 [ワークロード] > [デプロイメント] を選択します。

   「デプロイメント」ページで、[YAML から作成] をクリックします。deployment は httpbin という名前で、service は httpbin という名前でデプロイします。

   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」をクリックします。 次のステータスは、デプロイが成功したことを示します。

   

ソリューション概要

Cloud-native API Gateway インスタンスを作成し、コンテナサービスに関連付け、リクエストをターゲットサービスに転送するためのルーティングルールを定義します。

1. Cloud-native API Gateway インスタンスの作成。

   Cloud-native API Gateway インスタンスを作成します。

2. HTTP API の作成。

3. ルートの作成。

   1. サービスソースの作成。

      Cloud-native API Gateway で、サービスソースを追加し、ソースタイプに Container Service for Kubernetes (ACK) を選択します。

   2. サービスの追加。

      Cloud-native API Gateway は、指定された ACK サービスソースからサービスの名前空間を取得します。 既存のサービスをゲートウェイに追加して、バックエンドサービスとして使用します。

4. ルートのデバッグ。

   ルートが機能することを検証します。

手順1：Cloud-native API Gateway インスタンスの作成

1. Cloud-native API Gateway コンソールにログインします。 初めて使用する場合は、権限付与を完了してください。

   説明

   Cloud-native API Gateway コンソールに初めてアクセスすると、サービスリンクロールの作成を承認するように求められます。

   1. ページでAuthorize Nowをクリックします。表示されるダイアログボックスで、OKをクリックして承認を完了します。

   2. Experience Cloud-native API Gateway Now をクリックしてコンソールに入ります。

2. 左側のナビゲーションペインで、インスタンス を選択します。 上部のメニューバーでリージョンを選択し、Create Instance をクリックします。

   重要

   Cloud-native API Gateway インスタンスと ACK クラスターは、同じリージョンにある必要があります。

3. Cloud-native API Gateway の購入ページで、構成を選択し、今すぐ購入 をクリックします。

   

4. 注文確認 ページで、[クラウドネイティブ API ゲートウェイ (従量課金) サービス規約を読み、同意します] チェックボックスを選択し、Activate Now をクリックします。

   説明

   ゲートウェイインスタンスの作成には 2～3 分かかります。

5. [管理コンソール] をクリックすると、インスタンス ページが開きます。

   ゲートウェイインスタンスは、Status が Running になると使用可能になります。

手順2：HTTP API の作成

1. 左側のナビゲーションペインで、API ページに移動し、Create API をクリックします。

2. HTTP API カードで、Create をクリックします。HTTP API の作成 パネルで、API Name を設定し、[作成] をクリックします。

手順3：ルートの作成

1. 左側のナビゲーションペインで、API ページに移動し、目的の API 名をクリックします。

   Create Route をクリックします。Create Route パネルで、パラメーターを設定します。

基本的なルート情報の設定

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

• パス： / で始まるパスのリクエストに一致します。

インスタンスとバックエンドサービス

1. Instance には、ステップ 1 で作成したインスタンスを選択します。

   

2. シナリオ: Scenario リストから、Single Service を選択します。

3. Backend Services セクションで、Service Name ドロップダウンリストから Associated Service を選択します。

4. サービスソースとサービスの作成。

   1. Source Type を ACK に設定します。

   2. Add Source をクリックして、前提条件セクションで作成したクラスターを選択します。

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

      

   4. In the [Backend Services] section, select the service you just created from the [Service Name] drop-down list.

      

5. Save and Publish をクリックします。

手順4：ルートのデバッグ

1. 左側のナビゲーションペインで、[API] ページに移動し、目的の API の名前をクリックします。

2. ルートリストで、対象のルート httpbin-demo を見つけ、Actions 列の Debug をクリックします。

3. リクエストパラメーターとして version を入力して Send をクリックすると、以下の図のようにサービスレスポンスが表示されます。

   

関連ドキュメント

• Cloud-native API Gateway を使用した複数の ACK クラスターの管理

• トラブルシューティング：よくある質問