Container Service for Kubernetes:APIG Ingress を介した ACK マネージドクラスターへのアクセス

前提条件

APIG Controller は ACK マネージドクラスターにのみインストールできます。

• バージョン 1.18 以降の ACK マネージドクラスターが作成されていること。クラスターをアップグレードするには、「クラスターの手動アップグレード」をご参照ください。

• APIG Controller に権限が付与されていること。ACK マネージドクラスターの場合、権限付与リンク をクリックして、必要な権限を付与できます。

手順 1：APIG Controller のインストール

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

2. クラスター ページで、管理するクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、アドオン管理 をクリックします。

3. [コンポーネント管理] ページで、検索ボックスに APIG と入力します。[APIG Controller] カードで、[インストール] をクリックします。

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

   • 作成：

     apig.small.x1 仕様の従量課金制クラウドネイティブ API ゲートウェイインスタンスが自動的に作成されます。

   • 既存のインスタンスを使用：

     リストから従量課金制のクラウドネイティブ API ゲートウェイインスタンスを選択します。インスタンスはコンテナークラスターと同じ VPC 内にあり、他のクラスターに関連付けられていない必要があります。

   コンポーネントのインストールが [前提条件チェックに失敗しました] エラーで失敗した場合は、APIG Controller に権限を付与する必要があります。

5. コンポーネントがインストールされているか確認します。

   コンポーネントがインストールされると、デフォルトで ApigConfig リソースとゲートウェイインスタンスが作成されます。どちらも apig-controller-pro-{clusterid} という名前です。

   [ワークロード] > [カスタムリソース] に移動します。[リソースオブジェクトブラウザー] タブをクリックします。[API グループ] 検索ボックスに apig と入力します。ApigConfig の [アクション] 列で、[YAML の編集] をクリックして ApigConfig のステータスを表示します。3〜5 分待って、phase フィールドの値が [Listening] になっていることを確認します。これは、クラウドネイティブ API ゲートウェイが作成、実行され、IngressClass が apig に設定されているクラスター内の Ingress リソースを自動的にリッスンしていることを示します。

   ApigConfig のステータスは、Pending > Running > Listening の順に変化します。各ステータスの説明は次のとおりです。

   • Pending：クラウドネイティブ API ゲートウェイが作成中です。このプロセスには約 3 分かかります。

   • Running：クラウドネイティブ API ゲートウェイが作成され、実行中です。

   • Listening：クラウドネイティブ API ゲートウェイが実行中で、クラスター内の Ingress リソースをリッスンしています。

   • Failed：クラウドネイティブ API ゲートウェイが無効な状態です。詳細については、Status セクションの Message フィールドをご参照ください。

   重要

   • 作成モードでは、APIG Controller をインストールすると、デフォルトで ApigConfig リソースが作成されます。このリソースのライフサイクルは、クラウドネイティブ API ゲートウェイインスタンスにバインドされます。ApigConfig リソースを削除すると、対応するクラウドネイティブ API ゲートウェイインスタンスも削除されます。ApigConfig リソースは削除しないでください。

   • APIG Controller をインストールする前に、apig という名前の IngressClass リソースがクラスターにすでに存在する場合、インストールしても ApigConfig リソースやクラウドネイティブ API ゲートウェイインスタンスは自動的に作成されません。

6. クラウドネイティブ API ゲートウェイコンソールにログインします。対応するリージョンで、apig-controller-pro-{clusterid} という名前のクラウドネイティブゲートウェイインスタンスが見つかります。

手順 2：バックエンドサービスのデプロイ

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

2. クラスター ページで、管理するクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > 展開 を選択します。

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

4. Deployment と Service がデプロイされていることを確認します。

   1. 左側のナビゲーションウィンドウで、[ワークロード] > [デプロイメント] を選択します。httpbin という名前の Deployment が作成されます。Pods フィールドに 1/1 と表示されると、Deployment はデプロイされています。

   2. 左側のナビゲーションウィンドウで、[ネットワーク] > [サービス] を選択します。httpbin という名前の Service が作成されている場合、Service はデプロイされています。

手順 3：APIG Ingress の設定

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

2. クラスター ページで、目的のクラスターを見つけてその名前をクリックします。左側のペインで、[ネットワーク] > [Ingress] を選択します。

3. [Ingress] ページで、[Ingress の作成] をクリックします。

4. [Ingress の作成] ダイアログボックスで、[ゲートウェイタイプ] を [APIG Ingress] に設定し、関連するバックエンドサービスとアノテーションを設定してから、[OK] をクリックします。

   説明

   [Ingress クラス] を apig に設定します。ルーティングルールで、[プレフィックスマッチ] を選択し、[パス] を / に設定し、リクエストを httpbin サービスに転送するようにルールを設定します。

5. クラウドネイティブ API ゲートウェイコンソールにログインします。対応するクラウドネイティブ API ゲートウェイインスタンスに、名前に {gwid}-ingress を含む API が見つかります。

手順 4：サービスへのアクセス

1. Ingress エンドポイントから Network Load Balancer (NLB) のドメイン名を取得するか、ゲートウェイからパブリック IP アドレスを取得します。

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

   2. クラスター ページで、目的のクラスターを見つけてその名前をクリックします。左側のペインで、[ネットワーク] > [Ingress] を選択します。

   3. [Ingress] ページで、Ingress のエンドポイントを表示します。

2. サービスをテストするには、ブラウザまたはコマンドラインツールを使用して <Endpoint>/version または <ゲートウェイのパブリック IP アドレス>/version にアクセスします。たとえば、ブラウザに env-******-cn-hangzhou.alicloudapi.com/version と入力します。

関連ドキュメント

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