Spring BootベースのESB Microserviceへのルートをビルド - 7.3

Talend Data Fabric Studio ユーザーガイド

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

このタスクについて

Spring BootベースのESB Microserviceへのルートをビルドするには、以下のようにします:

手順

  1. Studioのツールバーでをクリックするか、メニューバーから[File] (ファイル) > [Edit Project Properties] (プロジェクトプロパティの編集)を選択して、[Project Settings] (プロジェクト設定)ダイアログボックスを開きます。
  2. ダイアログボックスの左にあるツリーダイアグラムで[Log4j]を選択し、該当するビューを表示します。
  3. 必要に応じてLog4j設定をカスタマイズします。デフォルトのLog4j XML命令は、WARNログのみをコンソールに出力します。log4jパラメーターの詳細は、http://wiki.apache.org/logging-log4j/Log4jXmlFormatを参照してください。
    Log4j設定の一例は次のとおりです。これもESB Microserviceの開始時にtesb.logファイルを提供します。Log4j設定は、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>
  4. ルートにcSOAPまたはcRESTコンポーネントが含まれている場合は、絶対URLの代わりに相対エンドポイントURLを使用する必要があります。Microserviceが実行されている場合、デフォルトの8065ポートを持つ埋め込みTomcatコンテナーは、スプリングブートによって開始されます。RESTとSoapサービスもこのポートで実行されます。デフォルトのポートをオーバーライドする場合は、コマンドで--server.portオプションを使用するか、Microservice jarで/configフォルダーのapplication.propertiesファイルで設定します。
    ルートにcSOAPまたはcRESTコンポーネントが含まれていて、ESBインフラ構造サービスが1つ以上使用されている場合は、ルートをビルドする前に、以下の手順に従う必要があります:
    • サービスアクティビティモニターが有効の場合は、必要に応じて<Studio_Home>/esb/agent.propertiesファイルを編集し、サービスアクティビティモニタリングエージェントを設定します。agent.propetiesのプロパティについては、『Talend ESBインフラ構造サービス設定ガイド』でサービスアクティビティモニタリングエージェントの設定に関するセクションを参照してください。

    • Service Locatorが有効な場合は、必要に応じて<Studio_Home>/esb/locator.propertiesファイルを編集し、Service Locatorを設定します。locator.propertiesのプロパティについては、『Talend ESBインフラ構造サービス設定ガイド』でService Locatorの設定に関するセクションを参照してください。

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

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

      cd <TalendRuntimePath>/add-ons/maven-repo
      mvn clean package -s <Studio_Home>/configuration/maven_user_settings.xml
  5. デザインワークスペースにルートを開きます。[Route] (ルート)タブの[Deployment] (デプロイ)ビューで、[Build Type] (ビルドタイプ)リストからRouteMicroserviceを選択します。ルートを保存します。
  6. [Repository] (リポジトリー)ツリービューでビルドするルートを右クリックし、[Build Route] (ルートのビルド)を選択して[Build Route] (ルートのビルド)ダイアログボックスを開きます。
  7. [To archive file] (ファイルのアーカイブ先)フィールドで、ビルドしたルートを保存するディレクトリーまで移動します。
  8. 複数バージョンのルートが作成されている場合、[Route Version] (ルートバージョン)エリアでビルドするルートのバージョン番号を選択します。
  9. [Build Type] (ビルドタイプ)エリアで[ESB Microservice (Spring Boot)]を選択します。
  10. オプションエリアで:
    • ルートで使用するデフォルトコンテキストのみをエクスポートするには、[Only export the default context] (デフォルトコンテキストのみをエクスポート)オプションを選択します。

    • ルートを.zipファイルにエクスポートするには、[Export as ZIP] (ZIPとしてエクスポート)オプションを選択します。これにより、外部設定フォルダーと開始スクリプトが提供され、Linux (.sh)用とWindows (.bat)用の外部設定フォルダーでMicroserviceを開始できます。このオプションを選択していないと、ルートはデフォルトで.jarファイルとしてエクスポートされます。

    • [Enable Prometheus metrics endpoint] (Prometheusメトリクスエンドポイントを有効化)チェックボックスをオンにしてPrometheusメトリクスエンドポイントをマイクロサービスに構築し、ルートの実行、JVMメモリ、CPU消費量などを監視します。デフォルトでは、この機能はすべてのJMX属性と値をPrometheusにブリッジします。Prometheusの詳細は、https://prometheus.io/を参照してください。
      注: このオプションは、Talendが提供するR2020-08以降のStudio月次アップデートをインストールしている場合にのみ使用できます。詳細は管理者にお問い合わせください。
  11. [Finish] (終了)をクリックして変更を確定し、エクスポート操作を完了してダイアログボックスを閉じます。ESB MicroserviceをビルドするにはMavenをオンラインに設定する必要があることを知らせるポップアップウィンドウが表示されます。一部のライブラリーはリモートMavenリポジトリーからダウンロードする必要があるためです。ESB Microservice機能を使用する際には、Talend Studioにはインターネットアクセスが必要です。Talend Studioには、ESB Microserviceのビルド操作用に純粋なオフラインモードは提供されていません。[Yes] (はい)をクリックしてMavenをオンラインモードに変更します。
    [Finish] (終了)操作エラーになる場合は、Studioのログファイル<Studio_Home>\workspace\.metadata\.logで詳しい情報を参照できます。

タスクの結果

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