CIビルダー関連のMavenパラメーター
以下のパラメーターはプラグインに組み込まれているヘルプで説明されており(generate-mojo.htmlファイルを参照)、お使いのCIビルド定義のmavenOpts (Jenkins)/mavenOptions(Azure DevOps)コマンドとmvn (Jenkins)/options (Azure DevOps)コマンドのいずれかで使用できます。
mvn org.talend.ci:builder-maven-plugin:<version>:help
-Ddetail=true
-s F:/<your_studio>/configuration\maven_user_settings.xmlmvn org.talend.ci:builder-maven-plugin:<version>:help
-Dgoal=generateAllPoms
-Ddetail=true
-s F:/<your_studio>/configuration\maven_user_settings.xml| Mavenパラメーター | 値 | |
|---|---|---|
| Talend CommandLineパラメーター | -Dlicense.path | Talend製品のライセンスへのパスです。 ライセンスパスの値がURLで、アクセスに認証情報が必要な場合は、パラメーター-Dlicense.remote.userと-Dlicense.remote.passwordを使います。 ビルド時にこのパラメーターを使えば、期限切れのライセンスをアップデートできます。ライセンスを変更する際、mvn org.talend.ci:builder-maven-plugin:8.0.4:installコマンドを使用していない場合はこのパラメーターを使って-Dinstaller.clean=trueパラメーターを追加します。 |
| (Talend Studio 8.0.1 R2024-04以前のユーザーのみサポート) -Dtalend.studio.p2.base |
Talend Studioフィーチャーパッケージ用リポジトリーの URL、またはTalend Studioフィーチャーパッケージ用のTalend_Full_Studio_p2_repository-YYYYMMDD_HHmm-VA.B.C.zipアーカイブの解凍済みフォルダーへのパスです。 Talend Studioフィーチャーパッケージ用公式TalendリポジトリーのURLの例: Talend Studioフィーチャーパッケージ用アーカイブの解凍済みフォルダーへのパス例: 詳細は、Talend Studioと継続的インテグレーションのアップデートリポジトリーを設定をご覧ください。 バージョン8.0.1 R2024-05より、CI Builderのパラメーターである-Dtalend.studio.p2.baseはサポートされなくなり、必要でもなくなりました。 |
|
| -Dtalend.studio.p2.update |
Talend Studioアップデート用リポジトリーのURL、お客様に割り当てられたパッチZIPの解凍済みフォルダーへのパス、Talend Studioアップデート用アーカイブのいずれかです。 プロジェクトを新しいバージョンに移行したい場合は、ビルド時にこのパラメーターを使用してパッチ(Talend Studioマンスリーアップデート、マニュアルパッチおよびコンポーネントパッチ)をインストールする必要があります。このパラメーターの主な利点は、パッチをTalend Studioに適用する前に、CIを使って1つ(または複数)の既存プロジェクトでパッチをテストしたり、プロジェクトにパッチを適用したりできることです。 最新のTalend Studioマンスリーアップデート用公式TalendリポジトリーのURLの例 Talend Studioマンスリーアップデート用アーカイブの解凍済みフォルダーへのパス例: 詳細は、Talend Studioと継続的インテグレーションのアップデートリポジトリーを設定をご覧ください。 |
|
|
-Dhttp.proxy*パラメーターと-Dhttps.proxy*パラメーター + -Djdk.http.auth.tunneling.disabledSchemes |
使用したいプロキシサーバーのURL。 この機能は8.0 R2023-12以降で利用できます。 例: 詳細は、Talend CommandLineのプロキシ設定をご覧ください。 |
|
| (オプション) -Declipse.keyringと-Declipse.password -Dtalend.studio.p2.base.userと-Dtalend.studio.p2.base.pwd -Dtalend.studio.p2.update.userと-Dtalend.studio.p2.update.pwd |
Talend Studioアップデートリポジトリーで基本認証が有効になっている場合は、これらのパラメーターを使い、Eclipseセキュアストレージで暗号化された認証情報を入力します。 この機能は8.0 R2022-09以降で利用できます。 例: Talend Studio設定ファイルで認証情報を暗号化する方法は、Talend Studioでのアップデートリポジトリーの基本認証をご覧ください。 |
|
| (オプション) -Dproduct.path |
Talend CommandLineインストールディレクトリーへのパス。 例:Talend CI Builderのバージョン8.0.4(R2022-04から利用可能)以降、Talend CommandLine CommandLineはビルド時に自動的にダウンロードしてインストールできます。 |
|
| (オプション) -Dp2Installer.path |
Installerファイルのパスです。 -Dprduct.pathが指定されている場合(非推奨)、Talend CommandLineはこのパラメーターで指定されている値でインストールされます。 例:
これにより、製品のバージョンごとに別々のパスを使用できるようになります。 |
|
| (オプション) -DexecuteRawScriptと-DscriptFile |
mvn org.talend.ci:builder-maven-plugin:8.0.X:executeScriptコマンドと共に使用され、実行するCIパラメーターがすべて含まれるカスタムスクリプトを実行します。デフォルトでは、このパラメーターはfalseに設定されます。 例:
-DexecuteRawScript=trueと-DexecuteRawScript=falseの違いについては、https://help.talend.com/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/executing-a-custom-scriptプロジェクトでカスタムスクリプトを実行をご覧ください。 |
|
| (オプション) -Dinstaller.clean |
クリーンインストールを行い、CIワークスペースディレクトリーの下にある.metadataフォルダーを削除してからTalend CommandLineを再インストールします。 例: -Dinstaller.clean=true |
|
| (オプション) -Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.connectTimeout -Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.readTimeout -Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.browse.connectTimeout -Dinstall.org.eclipse.equinox.p2.transport.ecf.retry | エラーが返されるまで接続が開くのを待つタイムアウト時間(ミリ秒)と接続試行の回数。これらのパラメーターは、CIサーバーがすぐに応答を受け取れない場合にブロックされるのを防ぐのに役立ちます。デフォルト値はすべて12000ミリ秒です。 例: |
|
| (オプション) -Dgeneration.type |
アーティファクトのソースを生成する値としてlocalと入力すると、ビルドの実行中にTalend CommandLineを実行していなくてもテストをローカルに行うことができます。 例:
server生成タイプはサポート対象ではなくなりました。 |
|
| (オプション) -DcveReportFilePath |
修正済み脆弱性のリストが含まれているレポートをアーティファクトに保存するパスを定義できます。 このパラメーターは、org.talend.ci:builder-maven-plugin:<version>:detectCVEというMavenコマンドでのみ使用できます。 詳細は、ビルド中にアーティファクトの修正済み脆弱性 (CVE)を検出をご覧ください。 例:
|
|
| (オプション) -Dcommandline.skip |
アーティファクトのソースコード生成をスキップするための値として、trueと入力します。 このパラメーターは、以前にTalend CommandLineを使用してアーティファクトを生成したことがある場合のみ使用できます。 例:
|
|
| (オプション) -Dtalend.profile.module |
この値をtrueまたはfalseにすることで、POMファイルを生成する際にプロファイルを有効または無効にできます。 Talendが提供する8.0 R2022-06以降のTalend Studioマンスリーアップデートがインストールされておらず、メインプロジェクトに参照プロジェクトが重複している場合は、メインプロジェクトでPOMファイルを生成する際にこのパラメーターを追加して値をtrueに設定し、POMファイルでのプロジェクトのモジュール定義の重複を回避してから、Mavenパッケージコマンドでプロジェクトおよびアーティファクトをビルドする際に-Pパラメーターでプロファイルを指定する必要があります。詳細は、プロジェクトでPOMファイルを生成をご覧ください。 プロジェクトがバージョン7.1、7.2、7.3から移行された場合は、Talend Studioの[Project Settings] (プロジェクト設定)ダイアログボックスの ビューの下にある[Set reference project modules in profile] (プロファイルで参照プロジェクトモジュールを設定)チェックボックスをオンにするか、選択を解除することによって、プロファイルが有効または無効にされます。CIでPOMファイルを生成する際に、-Dtalend.profile.moduleパラメーターを使ってTalend Studioでプロファイル設定を上書きできます。 プロファイルを有効化する例: |
|
| (オプション) -Dtalend.exclude.deleted |
プロジェクトでPOMファイルを生成する際に、この値をtrueに設定すると、削除された項目のモジュールをPOMファイルから除外できます。 例: |
|
| (オプション) -DprojectFilter |
特定のプロジェクトをビルドできます。正規表現がサポートされています。 CIで始まる名前を持つすべてのプロジェクトに対するフィルタリングの例: projectAとprojectBという2つの特定プロジェクトをフィルタリングする例:
|
|
| (オプション) -DitemFilterと-Dfilter.include.dependencies=true |
特定のプロジェクト項目をビルドできます。正規表現がサポートされています。 追加の-Dfilter.include.dependencies=trueパラメーターを使えば、フィルタリングされたプロジェクト項目の依存項目がすべて含まれ、POMがさらに速く生成できます。 -DitemFilterを-DprojectFilterと共に使用した場合、-DitemFilterは-DprojectFilterでフィルタリングされたプロジェクトにのみ適用されるのでご注意ください。フィルタリングされたプロジェクトに-DprojectFilterでフィルタリングされていない参照プロジェクトがある場合、これらの参照プロジェクトの全項目についてPOMファイルが生成されます。 このパラメーターの使用例は、プロジェクト項目をフィルタリングをご覧ください。 |
|
| (オプション) -Dstudio.forceMavenOnline=true |
オフラインモードでジョブのビルドや実行のスケジューリングを行う際に依存項目のエラーが発生した場合は、Maven設定ファイルで定義されている内容に従って、Talend Studioが依存項目をダウンロードできるようになります。 次のエラーが表示されることがあります: Plugin X.Y.Z or one of its dependencies could not be resolved: Cannot access central また、ビルド前にプロジェクトでPOMファイルを生成ことでこの問題を回避することもできます。これは、POMファイルにジョブ実行に必要なすべての依存項目が含まれるようになるからです。 |
|
| (オプション) -Dworkspace |
アーティファクトをビルドする現在のワークスペースプロジェクトを定義できます。 さまざまなMavenビルダーコマンド(org.talend.ci:builder-maven-plugin:8.0.X:detectCVEやorg.talend.ci:builder-maven-plugin:8.0.X:generateAllPomsなど)で使用可能です。 例:
|
|
| -Dpatch.path | インストールしたパッチ、またはインストールしたいパッチ(手動パッチ、カスタムコンポーネントパッチ、ホットフィックスなど)へのパス。 なお、このパラメーターは8.0 R2022-04以降に非推奨となっています。代わりに、-Dtalend.studio.p2.updateパラメーターを使用できます。 パッチをローカルにインストールした場合の例:
ダウンロードするパッチの例:
Nexusアカウントをまだお持ちでない場合は、Talend Supportにお問い合わせください。リモートパッチがある場所へのアクセスで認証情報が必要となる場合は、-Dpatch.remote.userパラメーターと-Dpatch.remote.passwordパラメーターを使用します。patch.remote.passwordパラメーターによって、Mavenで暗号化されるパスワードを設定できます。 |
|
| -DforceUpdate | ローカルインストールが存在する場合も、このアップデートサイトからのTalend CommandLineのインストールを強制します。 なお、このパラメーターは8.0 R2022-04以降に非推奨となっています。代わりに、-Dinstaller.cleanパラメーターを使用できます。 例: -DforceUpdate=true |
|
| カスタムコンポーネントのパラメーター | -Dcomponents.* | カスタムコンポーネントを使用するジョブをアーティファクトリポジトリーにデプロイする時は、コンポーネントライブラリーが保存されているリポジトリーを指定します。 これは、Talend Component Kitを使って作成されたカスタムコンポーネントにのみ必要です。 詳細は、このドキュメンテーションをお読みください。 例:
|
| (オプション) -Djvm.arguments |
必要に応じて(Talend CommandLineで利用できるメモリを増加させる場合など)、JVMの引数を指定します。 Talendが提供する8.0 R2022-07以降のTalend Studioマンスリーアップデートをインストールしている場合、Talend CommandLineのインストールに使われるEclipse p2ディレ クターアプリケーションにもこのJVM引数が適用されます。詳細は、Installing software using the p2 director applicationをご覧ください。 例:
|
|
| (オプション) -Dstudio.allow.java.internal.access |
ビルド時にJavaクラスのアクセスエラーを防ぐためには、このパラメーターをtrueの値で追加します。 例:
情報メモ警告: この方法でビルドされたジョブをJava 8で実行することはできません。
このオプションの詳細、およびTalend Studioプロジェクト設定で有効にする方法は、Talend Studioのドキュメンテーションをお読みください。 |
|
| (オプション) -Dcodes.compile.failOnError |
ビルドしているアーティファクトで使用されない、コンパイルエラーを持ったルーチンが発生する時にCIビルドが失敗することを防止するには、このパラメーターをfalse値で追加し、それらをスキップしてコンパイルを続行します。 例
|
|