ステップ 10: API プロキシをデプロイする

Google Cloud と Apigee UI を構成し、ランタイムのインストールと構成が完了しました。それでは、問題なく機能するかどうか確認してみましょう。

1. Apigee UI を使用して新しい API プロキシを作成する

このセクションでは、API プロキシ ウィザードを使用して UI で新しい API プロキシを作成する方法について説明します。

API プロキシ ウィザードを使用してシンプルな API プロキシを作成するには、次のようにします。

  1. ブラウザで Apigee UI を開きます。
  2. 左上隅のプルダウン メニューから組織を選択します。
  3. メインビューで [Develop] > [API Proxies] を選択します。
  4. [Create New] をクリックします。API プロキシ ウィザードが起動します。
  5. [Reverse proxy] を選択します(最も一般的)。

    プロキシの詳細ビューが表示されます。

  6. 以下の設定でプロキシを構成します。
    • Proxy Name: 「myproxy」と入力します。このセクションの残りの手順では、これがプロキシ ID であることを前提としています。
    • Proxy Base Path: 自動的に「/ myproxy」に設定されます。Proxy Base Path は、API に対するリクエストを行うために使用される URL の一部です。Edge では、URL を使用して受信リクエストを照合し、適切な API プロキシにルーティングします。
    • (省略可)Description: 新しい API プロキシの説明を入力します(「単純なプロキシによる Apigee ハイブリッドのテスト」など)。
    • Target (Existing API): 「https://mocktarget.apigee.net」と入力します。API プロキシへのリクエストに応じて Apigee が呼び出すターゲット URL を定義します。mocktarget サービスは Apigee でホストされ、単純なデータを返します。API キーやアクセス トークンは必要ありません。

    API プロキシの詳細は、次のようになります。

  7. [Next] をクリックします。
  8. [Policies] 画面で、セキュリティ オプションとして [Pass through (no authorization)] を選択します。
  9. [Next] をクリックします。
  10. [Summary] 画面で、プロキシをデプロイする環境を選択し、[Create and Deploy] をクリックします。

    ハイブリッドでプロキシが生成されます(プロキシ バンドルと呼ばれることもあります)。

  11. [Go to proxy list] をクリックします。

    [Proxies] ビューが表示されます。このビューには、API プロキシの一覧が表示されます。新しいプロキシが、デプロイされたことを示す緑色のステータス インジケーターとともに表示されます。

2. API プロキシを呼び出す

プロキシがデプロイされたことが UI で示されたら、cURL または任意の REST クライアントを使用して呼び出しを試すことができます。次に例を示します。

  1. DOMAIN 環境変数が、プロジェクトと組織の設定 - ステップ 3: 環境グループを作成するで、環境グループのホスト名に使用したドメイン名に設定されていることを確認します。
    echo $DOMAIN
  2. 次のコマンドを使用して、Apigee Ingress ゲートウェイの外部 IP アドレスとポートを確認します。

    kubectl get svc -n apigee -l app=apigee-ingressgateway

    出力は次のようになります。

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
    apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. 外部 IP とポートを変数にエクスポートします。
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
    export INGRESS_PORT=PORT_NUMBER
  4. API プロキシを呼び出します。
    curl  -H Host:$DOMAIN --resolve \
      $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
      https://$DOMAIN:$INGRESS_PORT/myproxy -k

    次に例を示します。

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

API プロキシの構築とデプロイの詳細については、最初のプロキシの概要を構築するをご覧ください。