ACK サービスを公開するための APIG Ingress Controller のデプロイ - API Gateway

APIG Ingress は、クラウドネイティブ API Gateway を使用して、内部クラスターサービスをユーザーアクセス用に公開します。

重要

セキュリティ上の理由から、APIG Ingress は kube-system 名前空間のサービスを公開しません。

前提条件

Kubernetes V1.18 以降を実行する ACK マネージドクラスターを作成済みであること。
APIG Controller に権限を付与済みであること。

APIG Controller のインストール

「ACS コンソール」にログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。
「クラスターリスト」ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、「アドオン管理」をクリックします。
表示されたページで、検索ボックスに APIG と入力し、[APIG コントローラー] コンポーネントカードの [インストール] をクリックします。
［Install Component APIG Controller］ダイアログボックスで、パラメーターを設定し、［OK］をクリックします。
- 作成：
  apig.small.x1 仕様の従量課金クラウドネイティブ API Gateway インスタンスが自動的に作成されます。
  重要
  - [作成] を選択すると、コンポーネントはデフォルトで新しい ApigConfig リソースとクラウドネイティブ API ゲートウェイインスタンスを作成します。 ApigConfig リソースのライフサイクルは、クラウドネイティブ API ゲートウェイインスタンスのライフサイクルに関連付けられます。 ApigConfig リソースを削除すると、対応するクラウドネイティブ API ゲートウェイインスタンスのカスケード削除もトリガーされます。したがって、必要な場合を除き、ApigConfig リソースを削除しないでください。
  - クラスター内に apig という名前の IngressClass リソースがすでに存在する場合、ApigConfig リソースとクラウドネイティブ API Gateway インスタンスは自動的に作成されません。
- 既存 VPC の選択:
  リストから従量課金クラウドネイティブ API Gateway インスタンスを選択します。インスタンスはコンテナークラスターと同じ VPC にあり、他のクラスターに関連付けられていない必要があります。
コンポーネントのインストール中に前提条件チェックの失敗を示すメッセージが表示された場合は、APIG Controller に権限を付与してください。
コンポーネントのインストール後、apig-controller-pro-{clusterid} という名前の ApigConfig リソースがクラスターに表示されます。Cloud-native API Gateway console にログインします。対応するリージョンに、apig-controller-pro-{clusterid} という名前のクラウドネイティブゲートウェイインスタンスが表示されます。

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

クラスターリスト ページでクラスターの名前をクリックし、左側のナビゲーションウィンドウでワークロード > デプロイメント をクリックします。

[デプロイメント] ページで、[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

表示されるダイアログボックスで、[表示] をクリックし、Pod のステータスが Running であることを確認します。

APIG Ingress の構成

「Ingress」ページで、[Ingress の作成] をクリックします。
「Create Ingress」ダイアログボックスで、[ゲートウェイタイプ] を APIG Ingress に、[ルール] を [プレフィックス（プレフィックスベースのマッチ）] に設定します。[パス] を / に設定して、リクエストを httpbin サービスに転送します。その後、[OK] をクリックします。
[Ingresses] ページで、新しい Ingress のエンドポイントを [エンドポイント] 列で確認します。ブラウザ、CMD、またはその他のコマンドラインインターフェイスを使用して、ENDPOINT_DOMAIN_NAME/version または GATEWAY_PUBLIC_IP/version にアクセスし、サービスをテストします。応答が version: v1 の場合、Ingress は正しく構成されています。
または Cloud-native API Gateway console にログインします。対応するクラウドネイティブ API Gateway インスタンスに、{gwid}-ingress を含む名前の API が表示されます。

参照

APIG Ingress の概要と仕組みについては、「APIG Ingress 管理」をご参照ください。