API Gateway:APIG Ingress を使用したサービスの公開

前提条件

• 作成した Container Service for Kubernetes (ACK) マネージドクラスターが、Kubernetes 1.18 以降を実行していること。

• APIG Controller に必要な権限を付与済みであること。

APIG Controller のインストール

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

2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、[操作] > [アドオン] を選択します。

3. アドオン管理 ページで、APIG を検索し、APIG Controller カードの インストール をクリックします。

4. インストール APIG Controller ダイアログボックスで、パラメーターを設定し、OK をクリックします。

   • Create：

     apig.small.x1 仕様の従量課金制 Cloud-native API Gateway インスタンスを自動的に作成します。

     重要

     • Create を選択すると、デフォルトで ApigConfig リソースと Cloud-native API Gateway インスタンスが作成されます。ApigConfig リソースを削除すると、関連付けられた Cloud-native API Gateway インスタンスも削除されます。ApigConfig リソースは削除しないでください。

     • クラスター内に apig という名前の IngressClass がすでに存在する場合、アドオンは ApigConfig リソースや Cloud-native API Gateway インスタンスを作成しません。

   • 既存を使用：

     既存の従量課金制 Cloud-native API Gateway インスタンスを選択します。インスタンスはクラスターと同じ VPC 内にあり、他のクラスターにバインドされていない必要があります。

   インストール中に [事前チェックに合格しませんでした。] エラーが発生した場合は、APIG Controller に必要な権限を付与してください。

5. インストール後、apig-controller-pro-{clusterid} という名前の ApigConfig リソースがクラスターに表示されます。Cloud-native API Gateway コンソールでは、対応するリージョンに apig-controller-pro-{clusterid} という名前のゲートウェイインスタンスが表示されます。

サンプルアプリケーションの作成

1. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のウィンドウで、[ワークロード] > [デプロイ] を選択します。

2. デプロイメント ページで、YAML のリソースの作成 をクリックします。次の YAML を使用して、httpbin という名前のデプロイメントと 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
     type: ClusterIP

3. [表示] をクリックし、Pod のステータスが Running であることを確認します。

APIG Ingress の設定

1. 左側メニューで、Ingress > Ingress を選択します。Ingress ページで、Ingress の作成 をクリックします。

2. Ingress の作成 ダイアログボックスで、ゲートウェイタイプ を [APIG Ingress] に、Ingress を [プレフィックス一致] に、パス を / に設定してリクエストを httpbin サービスに転送するようにし、OK をクリックします。

3. Ingress ページで、エンドポイント 列にある Ingress エンドポイントを見つけます。ブラウザまたは CLI から endpoint/version または gateway public IP/version にアクセスします。version: v1 という応答があれば、Ingress が機能していることを確認できます。

4. Cloud-native API Gateway コンソールにログインします。対応するゲートウェイインスタンスで、名前に {gwid}-ingress が含まれる API を見つけます。

関連ドキュメント

APIG Ingress の管理