データサービスジョブをマイクロサービスとしてビルド

このタスクについて

注: この機能は、Talendが提供するR2024-02以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

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

マイクロサービスにジョブをビルドするためには、次の操作を行います:

手順

Talend Studioのツールバーでをクリックするか、メニューバーから[File] (ファイル) > [Edit Project Properties] (プロジェクトプロパティを編集)を選択して[Project Settings] (プロジェクト設定)ダイアログボックスを開きます。
ダイアログボックスの左側にあるツリー図で、[Build] (ビルド) > [Standalone Boot microservices] (スタンドアロンマイクロサービス) > [Default configuration] (デフォルト設定)と選択して対応するビューを表示させ、必要に応じてマイクロサービスの設定をカスタマイズします。
Studioでマイクロサービスを実行する時に、設定が適用されません。たとえば、カスタムサーブレットコンテキストパスは使用されず、管理エンドポイントも利用できなくなります。
ダイアログボックスの左にあるツリーダイアグラムで[Log4j]を選択し、該当するビューを表示します。

必要に応じてLog4j設定をカスタマイズします。デフォルトのLog4j XML命令は、WARNログのみをコンソールに出力します。log4jパラメーターの詳細は、 Log4jXmlFormat (英語のみ)をご覧ください。

Log4j設定の一例は次のとおりです。これもESB Microserviceの開始時にtesb.logファイルを提供します。Log4j設定は、Talend Studioでもマイクロサービスでも同じです。ただし、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>

ジョブのtRESTRequestコンポーネントで、絶対URLの代わりに相対エンドポイントURLを使用する必要があります。RESTサービスは、デフォルト設定で定義されたデフォルトポートで実行されます。デフォルトのポートをオーバーライドする場合は、コマンドで--server.portオプションを使用するか、マイクロサービスで/configフォルダーのapplication.propertiesファイルで設定します。
基本認証で使用する環境変数は、MS_SECURITY_USER_NAMEとMS_SECURITY_USER_PASSWORDです。
デザインワークスペースでジョブを開きます。[Job] (ジョブ)タブの[Deployment] (デプロイメント)ビューで、[Build Type] (ビルドタイプ)リストから[Microservice] (マイクロサービス)を選択します。ジョブを保存します。
[Repository] (リポジトリー)ツリービューでビルドするジョブを右クリックし、[Build Job] (ジョブをビルド)を選択してダイアログボックスを開きます。
[To archive file] (ファイルのアーカイブ先)フィールドで、ビルドしたジョブを保存するディレクトリーまで移動します。
複数バージョンのジョブが作成されている場合、[Job Version] (ジョブバージョン)エリアでビルドするジョブのバージョン番号を選択します。
[Build type] (ビルドタイプ)エリアで[Microservice] (マイクロサービス)を選択します。
オプションエリアで次の項目を選択します。
- [Export as ZIP] (ZIPとしてエクスポート)オプション: ジョブを.zipファイルにエクスポートします。このファイルには外部設定フォルダーと開始スクリプト含まれており、Linux (.sh)用とWindows (.bat)用の外部設定フォルダーでMicroserviceを開始できます。このオプションを選択していないと、ジョブはデフォルトで.jarファイルとしてエクスポートされます。
- [Enable Prometheus metrics endpoint] (Prometheusメトリクスエンドポイントを有効化)チェックボックス:　Prometheusメトリクスエンドポイントをマイクロサービスに構築し、ジョブの実行、JVMメモリ、CPU消費量などを監視します。デフォルトでは、この機能はすべてのJMX属性と値をPrometheusにブリッジします。Prometheusの詳細は、Prometheusのドキュメンテーション (英語のみ)をご覧ください。このオプションは8.0.1-R2024-04から適用可能です。
[Finish] (終了)をクリックして変更を確定し、エクスポート操作を完了してダイアログボックスを閉じます。ESB MicroserviceをビルドするにはMavenをオンラインに設定する必要があることを知らせるポップアップウィンドウが表示されます。一部のライブラリーはリモートMavenリポジトリーからダウンロードする必要があるためです。ESB Microservice機能を使用する際には、Talend Studioにはインターネットアクセスが必要です。Talend Studioには、ESB Microserviceのビルド操作用に純粋なオフラインモードは提供されていません。[Yes] (はい)をクリックしてMavenをオンラインモードに変更します。

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

タスクの結果

定義された場所にジョブ用の.jarまたは.zipファイルが作成されます。スタンドアロンモードでTalend Studioとは独立に実行できます。

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

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

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