マイクロサービスルートの実行 - 7.3

Talend Data Fabric Studio ユーザーガイド

Version
7.3
Language
日本語 (日本)
Product
Talend Data Fabric
Module
Talend Studio
Content
ジョブデザインと開発

このセクションでは、Spring Bootベースのマイクロサービスとしてビルドされたルートを実行する方法について説明します。

.jarファイルとしてエクスポートされたルートを実行するには、コンソールウィンドウで以下の操作を行います。

  1. マイクロサービスの.jarファイルがあるディレクトリーに切り替えます。

  2. 次のコマンドを入力します。Spring Bootのプロパティの詳細は、http://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.htmlを参照してください。WebページにリストされているプロパティをESBマイクロサービスにすべて適用できるわけではありませんので、ご注意ください。主にTalendに含まれている機能、そしてビルドするルートによって異なります。

    java -jar <ArchiveFileName> --<SpringBootProperty>

    たとえば、次のコマンドは、ファイルProd内で設定した環境プロパティを使用して、demoRoute.0.1.jarという名前のマイクロサービスを実行します。このProdTalendのコンテキスト名でもあります。このパラメーターは複数のコンテキストプロパティの間で切り替えができるように指定する必要があります。

    java -jar demoRoute.0.1.jar --spring.config.location=classpath:config/contexts/ --spring.config.name=Prod

    デフォルトでは、マイクロサービスルートの実行中に、マイクロサービスのjarの/configフォルダーにある設定ファイルを呼び出す設定になっています。spring.config.additional-locationプロパティを使って、設定ファイルがある外部の設定フォルダーに切り替えることができます。たとえば、次のコマンドは、マイクロサービスのjarがあるディレクトリーのconfigフォルダーに入っている設定ファイルを使って、demoRoute.0.1.jarという名前のマイクロサービスを実行します。

    java -jar demoRoute.0.1.jar --spring.config.additional-location=./config

Spring Bootには、マイクロサービスの監視と対話のための組み込みエンドポイントが多数含まれています。mappingsエンドポイントを使えば、利用できる全エンドポイントのリストが表示されます。詳細は、Spring Bootのドキュメンテーションを参照してください。

.zipファイルとしてエクスポートされたルートを実行するには、以下の操作を行います。

  1. 任意のディレクトリーで.zipファイルを展開します。

  2. <RouteName>フォルダーに移動します。ここには、外部のconfigフォルダー、Microservice.jarファイル、および開始スクリプトが含まれています。このフォルダーで、Linux (.sh)およびWindows (.bat)用のMicroserviceを開始します。

  3. configフォルダー内の設定ファイルを必要に応じて編集し、Linux上では.shファイル、Windows上では.batファイルを実行し、外部設定でマイクロサービスを開始します。

ルートにcSOAPまたはcRESTコンポーネントが含まれており、1つ以上のESB運用サービスが使用されている場合、マイクロサービスルートの実行中に次の手順を実行する必要があります。

  • サービスアクティビティモニタリングが有効の場合は、Microserviceルートを実行する前にランタイムコンテナーでサービスアクティビティモニタリングサーバーを起動します。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

  • Service Locatorが有効の場合は、Microserviceルートを実行する前にRuntimeコンテナーでService Locator Serverを起動します。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

  • ルートがサービスプロバイダーでHTTP BASIC認証が有効の場合は、マイクロサービスルートの実行時にユーザー認証情報を指定します。

    java -jar <ArchiveFileName>.jar --security.user.name=<USERNAME> -- security.user.password=<PASSWORD>
  • SAMLトークン認証が有効の場合は、Microserviceルートを実行する前にランタイムコンテナーでSTSサービスを開始する必要があります。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

  • SAMLトークン認証と認証サービスが有効である場合は、マイクロサービスルートを実行する前に、次の手順を行う必要があります。

    • Talend Identity Management Serviceをインストールして開始し、そこでユーザーとロールを作成します。詳細は、 Talendインストール&アップグレードガイドTalend ESBインフラ構造サービス設定ガイドを参照してください。

    • ランタイムコンテナーでSTSサービスを開始します。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

    • ランタイムコンテナーで認証サービスを開始します。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

    • Talend Administration Centerを起動し、[Authorization] (承認)ページでXACMLポリシーを設定します。詳細は、Talend Administration Centerユーザーガイドで関連セクションを参照してください。

  • サービスレジストリーを使用している場合は、次の手順を実行する必要があります。

    • 使用中のWS-Policyに従って、関連するインフラ構造サービスを開始します。詳細は、Talend ESBインフラ構造サービス設定ガイドで関連セクションを参照してください。

    • Talend Administration Centerを開始し、Service RegistryページからWSDLサービスとWS-Policyをサービスレジストリーのページに追加します。詳細は、『Talend Administration Center User Guide』で関連するセクションを参照してください。