5.5. API プロバイダークイックスタートインテグレーションの例のインポートおよびパブリッシュ
Fuse Online は、Fuse Online 環境にインポートできる API プロバイダークイックスタートインテグレーションを提供します。このクイックスタートには、タスク管理 API の OpenAPI ドキュメントが含まれています。クイックスタートインテグレーションをインポートした後、フローを確認し、インテグレーションをパブリッシュします。以下の手順の完了後、Task API インテグレーションは稼働状態になり、実行される準備が整います。
API プロバイダークイックスタートは、API プロバイダーインテグレーションを設定、パブリッシュ、およびテストする方法を短時間で理解するのに役立ちます。しかし、API プロバイダーインテグレーションが便利であることを実証する実際の例ではありません。実例として、Fuse Online をすでに使用して、複数のシンプルなインテグレーションをパブリッシュしている場合に、このようなインテグレーションの実行をトリガーするために、OpenAPI ドキュメントを定義できます。これには、パブリッシュ済みのシンプルなインテグレーションとほぼ同じになるように、各 OpenAPI オペレーションのフローを編集します。
前提条件
- Fuse Online がブラウザーで開かれている必要があります。
-
OCP で稼働している Fuse Online 環境へのサンプルアプリケーションの追加 で説明されているように、Fuse Online 環境には
Todoサンプルアプリケーションが含まれている 必要があります。
手順
Task API クイックスタートインテグレーションをインポートします。
-
https://github.com/syndesisio/syndesis-quickstarts/tree/1.11/api-provider にアクセスし、
TaskAPI-export.zipをダウンロードします。 - Fuse Online の左側のナビゲーションパネルで Integrations をクリックします。
- 右上の Import をクリックします。
-
ダウンロードした
TaskAPI-export.zipファイルを Import ページにドラッグします。Fuse Online は、ファイルが正常にインポートされたことを示します。 - 左側のナビゲーションパネルで Integrations をクリックし、先ほどインポートした Task API インテグレーションのエントリーを表示します。設定が必要であるとエントリーに表示されますが、このインテグレーションをパブリッシュする準備は整っています。
-
https://github.com/syndesisio/syndesis-quickstarts/tree/1.11/api-provider にアクセスし、
- Edit Integration をクリックして、この API が提供するオペレーションのリストを表示します。
各オペレーションのフローを確認するには、以下を行います。
Edit flow ボタンをクリックし、そのフローのビジュアライゼーションを表示します。
各フローにはすでに 1 つのデータベースコネクション、1 つ以上のデータマッパーステップ、およびフローを終了する 1 つの Provided API Return Path ステップが存在します。
- Invoke SQL ステップでは Configure をクリックし、コネクションが実行する SQL ステートメントを表示します。その後、Cancel をクリックし、オペレーションのビジュアライゼーションフローに戻ります。
- データマッパーステップでは、Configure をクリックし、マッピングを表示します。その後、Cancel をクリックしてビジュアライゼーションに戻ります。
- 各オペレーションのフローの最終ステップである Provided API Return Path ステップでは、Configure をクリックし、オペレーションによって呼び出し元に送信された可能性がある HTTP リターンコードを表示します。Cancel をクリックしてビジュアライゼーションに戻ります。
- オペレーションのフローの確認後、ドロップダウンメニューで Integrations> Task API> Operation の順にクリックし、別のオペレーションを選択します。
- この手順を繰り返し、各フローを確認します。
- 必要に応じて、Save をクリックし、インテグレーションの名前を編集します。
Save and Publish をクリックします。
インテグレーションの概要ページには、インテグレーションのアセンブル、ビルド、デプロイ、および開始時のパブリッシュの進捗が表示されます。
Task API インテグレーション概要ページに Running が表示されると、Fuse Online は Task API サービスの外部 URL を表示します。以下のような URL が表示されます。
https://i-task-api-fuseonline.apps.openshift.com/これは、Task API サービスを利用できる場所を示しています。REST API 呼び出しは、このベース URL で始まる URL を指定します。
Fuse Online を OpenShift Container Platform で使用し、外部 URL がインテグレーションの概要ページにない場合、Red Hat 3scale の検出は有効になっています。これは、Red Hat 3scale によってインテグレーションの API へのアクセスが制御され、API プロバイダーインテグレーションもパブリッシュされることを意味します。インテグレーションをテストするには、3scale ダッシュボードを開き、インテグレーションの URL を取得します。
インテグレーションの API へのアクセスを 3scale が制御しないようにするには、検出を無効にします。これは、Fuse Online でインテグレーションの概要ページを表示して行います。このページの Disable discovery をクリックします。インテグレーションが Fuse Online によって再パブリッシュされ、インテグレーションの実行を呼び出すための外部 URL が提供されます。
各 API プロバイダーインテグレーションの検出を有効または無効にすることができます。
