新しい API プロキシの作成とデプロイ

GCP とハイブリッド UI を構成し、ランタイムのインストールと構成が完了しました。では、問題なく機能するかどうか確認してみましょう。

ここでは、次のことを行います。

  1. API プロキシ ウィザードを使用して、Apigee UI で 新しい API プロキシを作成する
  2. UI を使用してクラスタに新しいプロキシをデプロイする

1. ハイブリッド UI を使用して新しい API プロキシを作成する

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

API プロキシ ウィザードを使用して簡単な API プロキシを作成するには:

  1. ブラウザで Apigee hybrid UI を開きます。
  2. メインビューで [Develop] > [API Proxies] を選択します。
  3. [Environment] プルダウン リストから、新しい API プロキシを作成する環境を選択します。このセクションでは、環境名が「test」であることを前提としています。ステップ 5: 環境を追加するで、少なくとも 1 つの環境を作成しました。

    ハイブリッド UI に、その環境の API プロキシのリストが表示されます。まだプロキシを作成していない場合、リストは空です。

  4. 右上にある [+Proxy] をクリックします。

    API プロキシ ウィザードが起動します。

  5. [Reverse proxy](最も一般的)を選択し、[Next] をクリックします。

    プロキシの [Details] ビューが表示されます。

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

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

  7. [次へ] をクリックします。
  8. [Policies] 画面で、セキュリティ オプションとして [Pass through (none)] を選択します。

  9. [次へ] をクリックします。
  10. [Summary] 画面で、[Create] をクリックします。

    ハイブリッドがプロキシを生成します。(プロキシ バンドルということもあります)。

  11. [Exit] をクリックします。

    [Proxies] ビューが開き、API プロキシのリストが表示されます。新しいプロキシはリストの先頭に表示されます。ステータス インジケーターは灰色で、まだデプロイされていないことを示します。

2. ハイブリッド UI を使用してプロキシをクラスタにデプロイする

新しいプロキシを作成したら、それをデプロイし、テストで使用できるようにする必要があります。このセクションでは、ハイブリッド UI を使用して新しいプロキシをデプロイする方法について説明します。

API プロキシをハイブリッド UI でデプロイするには:

  1. ハイブリッド UI で [Develop] > [API Proxies] の順に選択します。

    「test」環境が選択されていることを確認します。

    UI のプロキシリストに新しいプロキシが表示されます。

  2. myproxy プロキシをクリックします。

    UI に、そのプロキシの [API Proxy Overview] タブが表示されます。

    [Deployments] の下の [Revision] 列に「Not deployed」が表示されます。

  3. [Revision] 列でプルダウン セレクタを展開し、デプロイするリビジョンを選択します。

    プルダウン リストには「1」と「Undeploy」のみが表示されます。

  4. プルダウン リストから「1」(デプロイするリビジョン)を選択します。

    デプロイの確定を求めるメッセージが表示されます。

  5. [デプロイ] をクリックします。

    UI で、新しいプロキシのリビジョン 1 をクラスタにデプロイするプロセスが開始します。

    デプロイは瞬間的なプロセスではありません。ハイブリッドの「結果整合性」デプロイモデルでは、新しいデプロイメントがすぐにではなく、少し間をおいてクラスタにロールアウトされます。

UI でプロキシのデプロイ状況を確認する方法はいくつかありますが、次の 2 つのステップでは、デプロイした API プロキシを呼び出す方法と、Apigee API の呼び出しでデプロイ状況を確認する方法について説明します。

3. API プロキシを呼び出します。

UI でプロキシがデプロイされていることが表示されている場合は、cURL または選択した REST クライアントを使用して呼び出せます。

curl -v -k https://your_host_alias/myproxy

ここで、your_host_alias は、オーバーライド ファイルの virtualhosts.hostAliases プロパティで構成されているように、API へのアクセスに使用される公開ドメインです。クラスタの設定をご覧ください。

例:

curl -v -k https://apitest.acme.com/myproxy

呼び出しが成功すると、次の出力が表示されます。

Hello, Guest!