salesforce
+
+

ラボ 5: HTTP プロキシを使用したレガシーサービスのプロキシ (オプション)

概要

API管理 は、3つのレイヤーすべてでAPIにガバナンスフレームワークを提供するため、API主導のアーキテクチャでは不可欠です。ラボ1では、MuleSoftがExchangeで公開されているAPIをAPI Gateway上でプロキシする方法を、ラボ4ではMuleSoftが実装したAPIを直接管理する方法を説明しました。

既存のサービスやレガシーサービスがある場合はどうすればいいのでしょうか。MuleSoftはこれらのサービスも管理することができます。これらの既存のサービスはHTTPプロキシを介して管理します。REST-JSONサービスやSOAP Webサービスをこの方法で管理することも可能です。

このラボで使用するAPIは、すでにデプロイされているモック実装を利用します。

クライアントは API ゲートウェイを介して API にアクセスし、実際のOmni Channel API モック実装にリクエストを転送します。APIゲートウェイにプロキシをデプロイすることで、Anypoint Platformはレガシーサービスの管理、アクセス制御、および使用状況の監視を行うことができます。

ステップ 1：API ManagerでAPI-HTTPプロキシを作成

  1. API Manager に移動します。

  2. Select Add API and select Add New API

    API Manager Icon

  3. Mule Gateway を選択し、Next ボタンをクリックします。

    Anypoint Exchange

  4. "Select API From Exchange"が規定値として選択されているはずです。では"Omni Channel Experience API"を検索してみましょう。

    Anypoint Exchange

    次のステップに続きます。

ステップ 2: API ManagerでHTTP-APIプロキシを設定

このラボでは、Mythical社 の Omni Channel API のモック実装に API-HTTP プロキシを設定します。 このAPIは、ベースURL http://workshop-omni-channel-mock-service-v40.cloudhub.io/api からアクセスできるHTTP Restful APIとして公開されています。

ここでは、HTTP GETが発行された際に商品情報を返すこのAPIのproductsリソースを見てみましょう。

このAPIの全てのリソースを見るには、URL http://workshop-omni-channel-mock-service-v40.cloudhub.io/console/ を使用してAPI Consoleを見ることができます。

  1. 以下の情報でAPIを設定します:

    1. Managing type: Endpoint with proxy を選択します。

    2. Proxy deployment target: CloudHub

    3. Mule Version: Mule 4

    4. Implementation URI: http://workshop-omni-channel-mock-service-v40.cloudhub.io/api

    5. Path: /

      module5 lab5 create api

  2. Advanced options　をクリックします。

    1. API instance label: <username>-http-proxy-omni-channel このパラメータは、API ManagerでAPIを識別するために使用する予定です。

      CloudHubにデプロイしているので、ポートを指定する必要はありません。デフォルトではhttpかhttpsかに応じて80番ポートか443番ポートになっています。
      module 5 lab 5 api manager configured

  3. Save　ボタンをクリックします。

    Save ボタンをクリックすると、プロキシをデプロイするためのデプロイ設定セクションが表示されます。

    module 5 lab5 api deployment config

  4. 以下の情報で構成します:

    1. Runtime version: 4.3.0　を選択します。

    2. Proxy application name: <username>-mythical-omni-channel-api-http-proxy

      このプロパティは、Runtime Manager　でプロキシ URL と Mule アプリケーションの名前を定義します。

  5. Deploy ボタンを押します。

  6. Click Here をクリックしてログデータを確認し、進捗状況を確認します。

    module 5 lab 1 proxy deploy clickhere

  7. 新しいブラウザタブが開き、このアプリケーションのCloudHubログが表示されます。

    もし、ログに誘導されていない場合は、アプリケーション名をクリックしてからログをクリックしてください。

    アプリケーション名の横に青い丸が表示され、アプリケーションがデプロイされていることを示しています。CloudHubは、新しいプロキシアプリケーションをホストするために0.1 vCoreのワーカーを割り当てています。青色 のアイコンが表示されれば完了です。それまでの間は、自由に見て回ってください（ログを見て何が起こっているのかを確認してください）。

    プロキシのデプロイには数秒から数分かかることがあります。 コーヒーを飲んだり、ドキュメントを見たりするには良い時間です。

    Your application is started と表示されたら、次に進んでください。

    module 5 lab 5 ap runtimemanager endpointdeploylogs

  8. APIを設定していた前のブラウザタブに戻ってください。 "Deploying" ポップアップがまだ開いている場合は、ステータスバーに緑色の Deploy Successful が表示されているはずです。.

  9. Close　ボタンをクリックして下さい。

    module 5 lab 1 ap apimanager deployment

  10. デプロイが完了すると、ページの上部にAPIのステータスが表示されます。下図のように、緑色 のボールが横に表示されているはずです。これは、APIが正常にデプロイされ、現在管理されていることを示しています(ブラウザを更新する必要があるかもしれません)。

    module 5 lab 5 ap apimanager proxypanel
先ほど作成したプロキシは Mule アプリケーション/プロジェクトです。プロキシをダウンロードして、Anypoint Studioにインポートしてください。Mashery、Layer 7、apigeeなどの「ピュアプレイ」API管理ツールのブラックボックスプロキシとは異なり、AnypointプロキシはMuleアプリケーションであり、ダウンロードして、残りのラボで学ぶMuleのすべての機能を使って拡張することができます。
必要に応じて、生成されたフローを追加ロジックで拡張することができます。
このプロキシを CloudHub 上の API Gateway にデプロイしましたが、このプロキシアプリケーションをオンプレミスの API Gateway にデプロイすることもできます。

ステップ 3：API-HTTPプロキシをテスト

CloudHubからプロキシAPIにアクセスできるようになりました。

module 5 lab 5 apimanager statuspanelstatus

ホストされているプロキシの正確なURLは、APIステータスで取得できます:

  1. URLを右クリックしてコピーします。

  2. ブラウザで別のタブを開きます。

  3. コピーしたものを新しいタブに貼り付けますが、まだEnterキーは押しません。

  4. “/products/search” を追加して、プロキシを使用して製品情報を取得します。

    次のようなURLが必要です: http://{your_domain_name}/products/search

  5. Enterキーを押すと、次のような応答が表示されます:

    module 5 lab 1 browser product search response

  6. PostManやARC（Advanced Rest Client）などのRESTクライアントを使用してAPIをテストすることもできます。

まとめ

のラボでは、次の手順を完了しました:

  • ExchangeでAPI-HTTPプロキシを作成

  • API ManagerでAPI-HTTPプロキシを設定

  • API-HTTPプロキシをテスト

既存のAPIをプロキシしてCloudHubベースのAPIゲートウェイにデプロイするのがいかに簡単かを確認しました。これにより、環境全体で既存のAPIを管理するための　柔軟性 があるアプローチが提供されます。オンプレミスでもクラウドでも利用できる ハイブリッド API Gatewayサービスを活用することができます。このラボでは、インフラストラクチャを管理・保守することなく、API GatewayをCloudHubにデプロイすることで、デプロイ を大幅に スピードアップ できることを確認しました。

APIゲートウェイのデプロイとAPIのプロキシの詳細については、次のドキュメントを参照してください:

module 5 lab 1 summary diagram

おめでとうございます! モジュール５の全てのラボが完了しました。

モジュール 6に進んで下さい。

TOPに戻る

Submit your feedback!
Share your thoughts to help us build the best workshop experience for you!
Take our latest survey!