# データサービスジョブをSpring Bootマイクロサービスとしてビルド(非推奨)

Availability-note[非推奨](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

このコンテンツは非推奨になりました。

利用対象...

* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* MDM Platform
* Real-Time Big Data Platform

## このタスクについて

[Build Job] (ジョブをビルド)ダイアログボックスで、データサービスジョブをビルドするビルドタイプをSpring-BootベースのESB Microserviceに変更できます。

8.0 R2024-02以降、このビルドタイプは非推奨となっており、R2024-09に削除されます。新しいマイクロサービスビルドタイプでデータサービスジョブをビルドする場合は、次の操作が必要です:

* マイクロサービスの設定をチェックする
* データサービスジョブのビルドタイプをマイクロサービスに変更し、リビルド/テスト/再デプロイする

詳細は、[データサービスジョブをマイクロサービスとしてビルド](https://help.qlik.com/talend/ja-JP/studio-user-guide/8.0-R2024-06/building-a-job-to-a-microservice)をご覧ください。

情報メモ警告: マイクロサービスとしてビルドできるのは、tRESTRequestコンポーネントを含むジョブのみです。

## 手順

1. Talend Studioのツールバーで![\[Project properties\] (プロジェクトプロパティ)](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/projectsettings.svg)をクリックするか、メニューバーから[File] (ファイル) &gt; [Edit Project Properties] (プロジェクトプロパティを編集)を選択して、[Project Settings] (プロジェクト設定)ダイアログボックスを開きます。

   ![Spring Bootマイクロサービスのデフォルト設定](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/esb-spring-boot-microservice-default-configuratoin.png)
2. ダイアログボックスの左側にあるツリー図で、[Build] (ビルド) &gt; [Spring Boot microservices] (Spring Bootマイクロサービス) &gt; [Default configuration] (デフォルト設定)と選択して対応するビューを表示させ、必要に応じてSpring Bootマイクロサービスの設定をカスタマイズします。
3. ダイアログボックスの左にあるツリーダイアグラムで[Log4j]を選択し、該当するビューを表示します。

   ![Log4jの設定](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/esb-microservice-log4j_config.png)
4. 必要に応じてLog4j設定をカスタマイズします。デフォルトのLog4j XML命令は、WARNログのみをコンソールに出力します。

   Log4j設定の一例は次のとおりです。これもESB Microserviceの開始時にtesb.logファイルを提供します。Log4j設定は、Talend StudioでもESB Microserviceでも同じです。ただし、log4j.xmlファイルは実行時にMicroserviceの外部設定フォルダーに置けば、本番デプロイ用の特定のLog4j設定を提供することも可能です。
   ```
   <?xml version="1.0" encoding="UTF-8" ?>
   <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
   <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
       <appender name="stdout" class="org.apache.log4j.ConsoleAppender">
           <layout class="org.apache.log4j.PatternLayout">
               <param name="ConversionPattern" value="%d | %-5.5p | %-16.16t | %-32.32C %4L | %m%n"/>
           </layout>
       </appender>
       <appender name="rollingFile" class="org.apache.log4j.RollingFileAppender">
           <param name="file" value="tesb.log"/>
           <param name="MaxFileSize" value="1024KB"/>
           <param name="MaxBackupIndex" value="10"/>
           <layout class="org.apache.log4j.PatternLayout">
               <param name="ConversionPattern" value="%d | %-5.5p | %-16.16t | %-32.32C %4L | %m%n"/>
           </layout>
       </appender>
       <root>
           <priority value="info"/>
           <appender-ref ref="stdout"/>
           <appender-ref ref="rollingFile"/>
       </root>
   </log4j:configuration>
   ```
5. ジョブのtRESTRequestコンポーネントで、絶対URLの代わりに相対エンドポイントURLを使用する必要があります。Microserviceが実行されている場合、デフォルトの8065ポートを持つ埋め込みTomcatコンテナーは、スプリングブートによって開始されます。RESTサービスもこのポートで実行されます。デフォルトのポートをオーバーライドする場合は、コマンドで--server.portオプションを使用するか、Microservice jarで/configフォルダーのapplication.propertiesファイルで設定します。

   ESBインフラストラクチャーサービスが1つ以上使用されている場合は、ジョブをビルドする前に、以下を実行する必要があります。
   * サービスアクティビティモニターが有効の場合は、必要に応じて&lt;Studio\_Home&gt;/esb/agent.propertiesファイルを編集し、Service Activity Monitoringエージェントを設定します。agent.propertiesのプロパティについては、[Service Activity Monitoring Agent configuration](https://help.qlik.com/talend/r/en-US/8.0/esb-infra-services-configuration-guide/configuring-service-activity-monitoring-agent)をご覧ください。

   * Service Locatorが有効の場合は、必要に応じて&lt;Studio\_Home&gt;/esb/locator.propertiesファイルを編集し、Service Locatorを設定します。locator.propertiesのプロパティについては、[Configuring the Service Locator](https://help.qlik.com/talend/r/en-US/8.0/esb-infra-services-configuration-guide/configuring-service-locator)をご覧ください。

   * ジョブがサービスプロバイダーで、ユーザー名トークン認証が有効な場合は、Studio\_Home/esb/microservice/users.propertiesファイルを編集し、形式&lt;USERNAME&gt;=&lt;PASSWORD&gt;に従って、認証されたユーザー認証情報を指定します。たとえば、次の設定では2人のユーザーが定義されます。

     ```
     tadmin=tadmin
     tesb=tesb
     ```

   * SAMLトークン認証で、認証サービスが有効な場合は、コンソールウィンドウから次のコマンドを使用して、ESBエンタープライズアーティファクトをローカルMavenリポジトリーにインストールする必要があります。

     ```
     cd <TalendRuntimePath>/add-ons/maven-repo
     mvn clean package -s <Studio_Home>/configuration/maven_user_settings.xml
     ```
6. デザインワークスペースで、マイクロサービスとしてビルドするジョブを開きます。[Job] (ジョブ)タブの[Deployment] (デプロイメント)ビューで、[Build Type] (ビルドタイプ)リストから[Microservice (Spring Boot)] (マイクロサービス(Spring Boot))を選択します。ジョブを保存します。

   ![\[Job\] (ジョブ)タブの\[Deployment\] (デプロイメント)ビュー。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/job_build_type.png)
7. [Repository] (リポジトリー)ツリービューでビルドするジョブを右クリックし、[Build Job] (ジョブをビルド)を選択して[Build Job] (ジョブをビルド)ダイアログボックスを開きます。

   ![\[Build Job\] (ジョブをビルド)ダイアログボックス。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/build_job_microservice.png)
8. [To archive file] (ファイルのアーカイブ先)フィールドで、ビルドしたジョブを保存するディレクトリーまで移動します。
9. 複数バージョンのジョブが作成されている場合、[Job Version] (ジョブバージョン)エリアでビルドするジョブのバージョン番号を選択します。
10. [Build Type] (ビルドタイプ)エリアでMicroservice Spring Bootを選択します。
11. オプションエリアで:
    * ジョブを.zipファイルにエクスポートするには、[Export as ZIP] (ZIPとしてエクスポート)オプションを選択します。これにより、外部設定フォルダーと開始スクリプトが提供され、Linux (.sh)用とWindows (.bat)用の外部設定フォルダーでマイクロサービスを開始できます。このオプションを選択していないと、ジョブはデフォルトで.jarファイルとしてエクスポートされます。

    * [Enable Prometheus metrics endpoint] (Prometheusメトリクスエンドポイントを有効化)チェックボックスをオンにしてPrometheusメトリクスエンドポイントをマイクロサービスに構築し、ルートの実行、JVMメモリ、CPU消費量などを監視します。デフォルトでは、この機能はすべてのJMX属性と値をPrometheusにブリッジします。Prometheusの詳細は、[Prometheusのドキュメンテーション](https://prometheus.io/docs/introduction/overview/) (英語のみ)をご覧ください。
12. [Finish] (終了)をクリックして変更を確定し、エクスポート操作を完了してダイアログボックスを閉じます。ESB MicroserviceをビルドするにはMavenをオンラインに設定する必要があることを知らせるポップアップウィンドウが表示されます。一部のライブラリーはリモートMavenリポジトリーからダウンロードする必要があるためです。ESB Microservice機能を使用する際には、Talend Studioにはインターネットアクセスが必要です。Talend Studioには、ESB Microserviceのビルド操作用に純粋なオフラインモードは提供されていません。[Yes] (はい)をクリックしてMavenをオンラインモードに変更します。

    ![Maven Onlineを設定。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/build_route-microservice-finish.png)

    [Finish] (終了)操作がエラーになる場合は、Talend Studioのログファイル&lt;Studio\_Home&gt;\workspace\.metadata\.logで詳しい情報を参照できます。

## タスクの結果

定義された場所にジョブ用の.jarまたは.zipファイルが作成されます。スタンドアロンモードでTalend Studioとは独立に実行できます。マイクロサービスを実行する方法の詳細は、[Spring Bootマイクロサービスとしてビルドされたルートを実行(非推奨)](https://help.qlik.com/talend/ja-JP/studio-user-guide/8.0/running-microservice-route)をご覧ください。