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

Talend Studioユーザーガイド

Version
Cloud
7.3
Language
日本語
Product
Talend Big Data
Talend Big Data Platform
Talend Cloud
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発
Last publication date
2024-02-13
対象製品...

Cloud API Services Platform

Cloud Data Fabric

Data Fabric

Data Services Platform

ESB

MDM Platform

Real-Time Big Data Platform

このタスクについて

注: cConfigコンポーネントやcProcessorコンポーネントで使われるcontextオブジェクトのJavaメソッド( keySet()entrySet()values()size()など)は、Microserviceビルドタイプではサポートされていません。これらのメソッドはOSGiビルドタイプでのみサポートされています。Spring-bootではContextPropertiesはPOJOクラスでなければならず、java.util.Properties.ContextPropertiesを拡張できないためです。

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

手順

  1. Studioのツールバーでをクリックするか、メニューバーから[File] (ファイル) > [Edit Project Properties] (プロジェクトプロパティを編集)を選択して、[Project Settings] (プロジェクト設定)ダイアログボックスを開きます。
  2. ダイアログボックスの左にあるツリーダイアグラムで[Log4j]を選択し、該当するビューを表示します。
  3. 必要に応じてLog4j設定をカスタマイズします。デフォルトのLog4j XML命令は、WARNログのみをコンソールに出力します。Log4jパラメーターの詳細は、このドキュメンテーションをご覧ください。
    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ファイルで設定します。

    対象製品:

    Data Fabric

    Data Services Platform

    ESB

    MDM Platform

    Real-Time Big Data Platform

    ルートに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の詳細は、Prometheusのドキュメンテーションをご覧ください。
      注: このオプションは、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とは独立に実行できます。