新しい API プロキシを作成してデプロイする

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

このセクションでは、次の手順について説明します。

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

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

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

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

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

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

  4. 右上の [+ プロキシ] をクリックします。

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

  5. [Reverse プロキシ](最も一般的)を選択し、[次へ] をクリックします。

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

  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. [次へ] をクリックします。
  8. [ポリシー] 画面で、セキュリティ オプションとして [パススルー (なし)] を選択します。
  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!