メイン コンテンツをスキップする

Spring Bootマイクロサービスとしてビルドされたルートを実行(非推奨)

Availability-note非推奨

このセクションでは、Spring Bootベースのマイクロサービスとしてビルドされたルートを実行する方法について説明します。8.0 R2024-02以降、Spring Bootベースのマイクロサービスは非推奨となっています。

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

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

  2. 次のコマンドを入力します。Spring Bootのプロパティの詳細は、ドキュメンテーション (英語のみ)をご覧ください。WebページにリストされているプロパティをESBマイクロサービスにすべて適用できるわけではありませんので、ご注意ください。主にTalendに含まれている機能、そしてビルドするルートによって異なります。

    java -jar <ArchiveFileName> --<SpringBootProperty>

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

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

    デフォルトでは、マイクロサービスルートの実行中に、Microservicejar内の/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フォルダー、マイクロサービスの.jarファイル、開始スクリプトが含まれています。このフォルダーで、Linux (.sh)およびWindows (.bat)用のマイクロサービスを開始します。

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

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

  • サービスアクティビティモニターが有効の場合は、Microserviceルートを実行する前にランタイムコンテナーでサービスアクティビティ監視サーバーを起動します。詳細は、Installing the Service Activity Monitoring Server in a Runtime containerをご覧ください。

  • Service Locatorが有効の場合は、Microserviceルートを実行する前にRuntimeコンテナーでService Locatorサーバーを起動します。詳細は、Installing and running the Service Locator Server in a Runtime containerをご覧ください。

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

    java -jar <ArchiveFileName>.jar --security.user.name=<USERNAME> -- security.user.password=<PASSWORD>

  • SAMLトークン認証が有効の場合は、Microserviceルートを実行する前にランタイムコンテナーでSTSサービスを開始する必要があります。詳細は、Using STS with the Talend Runtimeをご覧ください。

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

  • Service Registryが使用されている場合、次のようにする必要があります:

    • 使用中のWS-Policyに従って、関連するインフラストラクチャーサービスを開始します。詳細は、Service Registryをご覧ください。

    • Talend Administration Centerを開始し、Service RegistryページからWSDLサービスとWS-Policyをサービスレジストリーのページに追加します。詳細は、Accessing the Service Registry pageをご覧ください。

Talend StudioでビルドされたMicroserviceによって、Spring Bootアクチュエーターエンドポイントへのアクセスが可能になります。

Talendが提供するR2020-04以降のTalend Studioマンスリーアップデートをインストールしている場合、デフォルトの監視エンドポイントはinfo、health、jolokiaに限定されます。

Talendが提供するR2020-09以降のTalend Studioマンスリーアップデートをインストールしている場合は、Microservice管理エンドポイントエンドポイント(info、health、jolokia)に到達するよう基本認証が常に有効になっています。

Microserviceの実行マシンでSPRING_BOOT_SECURITY_USER_NAME環境変数とSPRING_BOOT_SECURITY_USER_PASSWORDの環境変数を設定する必要があります。

Microserviceの起動時に、認証情報が検出されたことを示すログエントリーが1件表示されます。
認証情報が検出されたことを示すログエントリーの例。
実行時に環境変数が利用できない場合、フォールバックメカニズムがMicroserviceの起動時にランダムなパスワードを生成し、該当する警告を記録します。
認証情報が見つからず、警告が生成されたことを示すログエントリーの例。

Microserviceの管理エンドポイントにアクセスする場合は、セキュリティ認証情報を使ってサインインするよう求められます。

MicroserviceのDockerイメージを起動する際に、コマンドラインでSPRING_BOOT_SECURITY_USER_NAME環境変数とSPRING_BOOT_SECURITY_USER_PASSWORD環境変数を指定する必要があります。例:
docker run -p 8065:8065 -t --env SPRING_BOOT_SECURITY_USER_NAME='user' --env SPRING_BOOT_SECURITY_USER_PASSWORD='password'  p1/docker_ms_demorestroute
--envパラメーターはイメージ名の前に指定されることが必要です。

このセクション内

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください