# CIビルダー関連のMavenパラメーター 以下のパラメーターはプラグインに組み込まれているヘルプで説明されており(generate-mojo.htmlファイルを参照)、お使いのCIビルド定義のmavenOpts (Jenkins)/mavenOptions(Azure DevOps)コマンドとmvn (Jenkins)/options (Azure DevOps)コマンドのいずれかで使用できます。 ビルド時にMavenパラメーターのリストをインラインヘルプとして取得するためには、次のコマンドを実行します。 ``` mvn org.talend.ci:builder-maven-plugin::help -Ddetail=true -s F://configuration\maven_user_settings.xml ``` 情報メモヒント: また、次のコマンドで特定の目標を設定すると、その目標に関連するパラメーターのみ返されるようにすることができます。 ``` mvn org.talend.ci:builder-maven-plugin::help -Dgoal=generateAllPoms -Ddetail=true -s F://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の例:

```
-Dtalend.studio.p2.base=https://update.talend.com/Studio/8/base
```

Talend Studioフィーチャーパッケージ用アーカイブの解凍済みフォルダーへのパス例:

```
-Dtalend.studio.p2.base=D:/Talend/v80/StudioP2Base
```

詳細は、[Talend Studioと継続的インテグレーションのアップデートリポジトリーを設定](https://help.qlik.com/talend/r/ja-JP/8.0/installation-guide-windows/setting-up-update-repositories-for-studio-and-ci)をご覧ください。

バージョン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の例

```
-Dtalend.studio.p2.update=https://update.talend.com/Studio/8/updates/latest
```

Talend Studioマンスリーアップデート用アーカイブの解凍済みフォルダーへのパス例:

```
-Dtalend.studio.p2.update=D:/Talend/v80/StudioR202201
```

詳細は、[Talend Studioと継続的インテグレーションのアップデートリポジトリーを設定](https://help.qlik.com/talend/r/ja-JP/8.0/installation-guide-windows/setting-up-update-repositories-for-studio-and-ci)をご覧ください。 | | | -Dhttp.proxy\*パラメーターと-Dhttps.proxy\*パラメーター

+ -Djdk.http.auth.tunneling.disabledSchemes | 使用したいプロキシサーバーのURL。

この機能は8.0 R2023-12以降で利用できます。

例:

```
-Dhttp.proxyHost=
-Dhttp.proxyPort=
-Dhttp.proxyUser=
-Dhttp.proxyPassword=
-Dhttp.nonProxyHosts=localhost
-Dhttps.proxyHost=
-Dhttps.proxyPort=
-Dhttps.proxyUser=
-Dhttps.proxyPassword=
-Dhttps.nonProxyHosts=localhost
-Djdk.http.auth.tunneling.disabledSchemes=
```

詳細は、[Talend CommandLineのプロキシ設定](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/proxy-configuration-for-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以降で利用できます。

例:

```
-Dtalend.studio.p2.base=http://localhost:8081/Studio/8/base
-Dtalend.studio.p2.update=http://nexus.company.com:8081/Studio/8/updates/R2022-07v2/
-Declipse.keyring=/mykeyring
-Declipse.password=/mymaster
-Dtalend.studio.p2.base.user=admin
-Dtalend.studio.p2.base.pwd=admin123
-Dtalend.studio.p2.update.user=admin
-Dtalend.studio.p2.update.pwd=admin123
```

Talend Studio設定ファイルで認証情報を暗号化する方法は、[Talend Studioでのアップデートリポジトリーの基本認証](https://help.qlik.com/talend/r/ja-JP/8.0/installation-guide-windows/basic-authentication-for-update-repositories-in-studio)をご覧ください。 | | | (オプション)

-Dproduct.path | Talend CommandLineインストールディレクトリーへのパス。


例:

```
-Dproduct.path=/opt/Talend/commandline8
```

Talend CI Builderのバージョン8.0.4(R2022-04から利用可能)以降、Talend CommandLine CommandLineはビルド時に自動的にダウンロードしてインストールできます。 | | | (オプション)

-Dp2Installer.path | インストーラーファイルのパスです。

-Dprduct.pathが指定されている場合(非推奨)、Talend CommandLineはこのパラメーターで指定されている値でインストールされます。

例:

```
-Dproduct.path=/home/.installation/.commandline_8
-Dp2Installer.path=/home/.installation/.p2Installer_8
```


これにより、製品のバージョンごとに別々のパスを使用できるようになります。 | | | (オプション)

-DexecuteRawScriptと-DscriptFile | mvn org.talend.ci:builder-maven-plugin:8.0.X:executeScriptコマンドと共に使用され、実行するCIパラメーターがすべて含まれるカスタムスクリプトを実行します。デフォルトでは、このパラメーターはfalseに設定されます。

例:

```
mvn org.talend.ci:builder-maven-plugin:8.0.X:executeScript
-DexecuteRawScript=false
-DscriptFile=/script.txt
```

-DexecuteRawScript=trueと-DexecuteRawScript=falseの違いについては、[https://help.talend.com/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/executing-a-custom-scriptプロジェクトでカスタムスクリプトを実行](https://help.qlik.com/talend/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ミリ秒です。

例:

```
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.connectTimeout=12000
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.retrieve.readTimeout=12000
-Dinstall.org.eclipse.ecf.provider.filetransfer.httpclient4.browse.connectTimeout=12000
-Dinstall.org.eclipse.equinox.p2.transport.ecf.retry=5
``` | | | (オプション)

-Dsun.net.client.defaultConnectTimeoutおよび-Dsun.net.client.defaultReadTimeout | CI BuilderがEclipse以外のp2リモートファイル(ライセンス、patch.properties、.eclipseproductファイルなど)をダウンロードする際、デフォルトの接続および読み取りタイムアウト値は0ミリ秒に設定されています。これは、接続が確立されるかデータが受信されるまで、プロセスが無期限に待機することを意味します。

カスタムタイムアウト値を設定するには、次のJDKシステムプロパティをMavenコマンドに追加してください。

  • -Dsun.net.client.defaultConnectTimeout=<value_in_ms>: 接続を確立する際の最大待機時間をミリ秒単位で設定します。
  • -Dsun.net.client.defaultReadTimeout=<value_in_ms>: 確立された接続からデータを読み取る際の最大待機時間をミリ秒単位で設定します。


例:

```
-Dsun.net.client.defaultConnectTimeout=30000
-Dsun.net.client.defaultReadTimeout=60000
```

詳細については、[Java Networking Properties](https://docs.oracle.com/javase/8/docs/technotes/guides/net/properties.html)を参照してください。 | | | (オプション)

-Dgeneration.type | アーティファクトのソースを生成する値としてlocalと入力すると、ビルドの実行中にTalend CommandLineを実行していなくてもテストをローカルに行うことができます。

例:

```
-Dgeneration.type=local
```

server生成タイプはサポート対象ではなくなりました。 | | | (オプション)

-DcveReportFilePath | 修正済み脆弱性のリストが含まれているレポートをアーティファクトに保存するパスを定義できます。

このパラメーターは、org.talend.ci:builder-maven-plugin:<version>:detectCVEというMavenコマンドでのみ使用できます。

詳細は、[ビルド中にアーティファクトの修正済み脆弱性 (CVE)を検出](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/detecting-cve-while-building)をご覧ください。

例:

```
-DcveReportFilePath=/home/talend/cvereport.csv
``` | | | (オプション)

-Dcommandline.skip | アーティファクトのソースコード生成をスキップするための値として、trueと入力します。

このパラメーターは、以前にTalend CommandLineを使用してアーティファクトを生成したことがある場合のみ使用できます。

例:

```
-Dcommandline.skip=true
``` | | | (オプション)

-Dtalend.profile.module | この値をtrueまたはfalseにすることで、POMファイルを生成する際にプロファイルを有効または無効にできます。

Talendが提供する8.0 R2022-06以降のTalend Studioマンスリーアップデートがインストールされておらず、メインプロジェクトに参照プロジェクトが重複している場合は、メインプロジェクトでPOMファイルを生成する際にこのパラメーターを追加して値をtrueに設定し、POMファイルでのプロジェクトのモジュール定義の重複を回避してから、Mavenパッケージコマンドでプロジェクトおよびアーティファクトをビルドする際に-Pパラメーターでプロファイルを指定する必要があります。詳細は、[プロジェクトでPOMファイルを生成](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/regenerate-pom-files)をご覧ください。

プロジェクトがバージョン7.1、7.2、7.3から移行された場合は、Talend Studioの[Project Settings] (プロジェクト設定)ダイアログボックスの [Build] (ビルド) > Mavenビューの下にある[Set reference project modules in profile] (プロファイルで参照プロジェクトモジュールを設定)チェックボックスをオンにするか、選択を解除することによって、プロファイルが有効または無効にされます。CIでPOMファイルを生成する際に、-Dtalend.profile.moduleパラメーターを使ってTalend Studioでプロファイル設定を上書きできます。

プロファイルを有効化する例:

```
-Dtalend.profile.module=true
``` | | | (オプション)

-Dtalend.exclude.deleted | プロジェクトでPOMファイルを生成する際に、この値をtrueに設定すると、削除された項目のモジュールをPOMファイルから除外できます。

例:

```
-Dtalend.exclude.deleted=true
``` | | | (オプション)

-DprojectFilter | 特定のプロジェクトをビルドできます。正規表現がサポートされています。

CIで始まる名前を持つすべてのプロジェクトに対するフィルタリングの例:

```
-DprojectFilter="CI.*"
```

projectAとprojectBという2つの特定プロジェクトをフィルタリングする例:

```
-DprojectFilter="projectA\|projectB"
``` | | | (オプション)

-DitemFilterと-Dfilter.include.dependencies=true | 特定のプロジェクト項目をビルドできます。正規表現がサポートされています。

追加の-Dfilter.include.dependencies=trueパラメーターを使えば、フィルタリングされたプロジェクト項目の依存項目がすべて含まれ、POMがさらに速く生成できます。

-DitemFilterを-DprojectFilterと共に使用した場合、-DitemFilterは-DprojectFilterでフィルタリングされたプロジェクトにのみ適用されるのでご注意ください。フィルタリングされたプロジェクトに-DprojectFilterでフィルタリングされていない参照プロジェクトがある場合、これらの参照プロジェクトの全項目についてPOMファイルが生成されます。

このパラメーターの使用例は、[プロジェクト項目をフィルタリング](https://help.qlik.com/talend/r/ja-JP/8.0/software-dev-lifecycle-best-practices-guide/filter-project-items)をご覧ください。 | | | (オプション)

-Dstudio.forceMavenOnline=true | オフラインモードでジョブのビルドや実行のスケジューリングを行う際に依存項目のエラーが発生した場合は、Maven設定ファイルで定義されている内容に従って、Talend Studioが依存項目をダウンロードできるようになります。

次のエラーが表示されることがあります:

Plugin X.Y.Z or one of its dependencies could not be resolved: Cannot access central

また、ビルド前に[プロジェクトでPOMファイルを生成](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/regenerate-pom-files)ことでこの問題を回避することもできます。これは、POMファイルにジョブ実行に必要なすべての依存項目が含まれるようになるからです。 | | | (オプション)

-Dworkspace | アーティファクトをビルドする現在のワークスペースプロジェクトを定義できます。

さまざまなMavenビルダーコマンド(org.talend.ci:builder-maven-plugin:8.0.X:detectCVEやorg.talend.ci:builder-maven-plugin:8.0.X:generateAllPomsなど)で使用可能です。

例:

```
-Dworkspace=/home/talend/talend_studio/CI/workspace
``` | | | Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

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

-Dpatch.path | インストールしたパッチ、またはインストールしたいパッチ(手動パッチ、カスタムコンポーネントパッチ、ホットフィックスなど)へのパス。

なお、このパラメーターは8.0 R2022-04以降に非推奨となっています。代わりに、-Dtalend.studio.p2.updateパラメーターを使用できます。

パッチをローカルにインストールした場合の例:

```
-Dpatch.path=D:/patches/Patch_TPS-2222.zip,D:/patches/Patch_TPS-3333.zip
```

ダウンロードするパッチの例:

```
-Dpatch.path=http://localhost:8085/nexus/content/repositories/releases/Patch_TPS-2222.zip,http://localhost:8085/nexus/content/repositories/releases/Patch_TPS-3333.zip
```

Nexusアカウントをまだお持ちでない場合は、Talend Supportにお問い合わせください。リモートパッチがある場所へのアクセスで認証情報が必要となる場合は、-Dpatch.remote.userパラメーターと-Dpatch.remote.passwordパラメーターを使用します。patch.remote.passwordパラメーターによって、Mavenで暗号化されるパスワードを設定できます。 | | | Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

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

-DforceUpdate | ローカルインストールが存在する場合も、このアップデートサイトからのTalend CommandLineのインストールを強制します。

なお、このパラメーターは8.0 R2022-04以降に非推奨となっています。代わりに、-Dinstaller.cleanパラメーターを使用できます。

例: -DforceUpdate=true | | | カスタムコンポーネントのパラメーター | -Dcomponents.\* | カスタムコンポーネントを使用するジョブをアーティファクトリポジトリーにデプロイする時は、コンポーネントライブラリーが保存されているリポジトリーを指定します。

これは、Talend Component Kitを使って作成されたカスタムコンポーネントにのみ必要です。

詳細は、[このドキュメンテーション](https://help.qlik.com/talend/r/ja-JP/8.0/develop-component-using-kit/develop-component-tacokit)をお読みください。

例1 (JFrog Artifactoryリポジトリーへのベアラートークン認証) :

```
-Dcomponents.nexus.url=http://localhost:8082/artifactory
-Dcomponents.artifact.token=
-Dcomponents.nexus.repository=component-updates
-Dcomponents.nexus.repository.snapshot=component-updates-snapshot
```

例2 (ユーザーパスワード認証) :

```
-Dcomponents.nexus.url=http://localhost:8081/
-Dcomponents.nexus.user=
-Dcomponents.nexus.password=
-Dcomponents.nexus.repository=component-updates
-Dcomponents.nexus.repository.snapshot=component-updates-snapshot
```

情報メモ注: 古いjavajetベースのコンポーネントについては、[How to share a custom component in Talend Studio](https://help.qlik.com/talend/r/ja-JP/8.0/share-custom-component-in-studio)をご覧ください。 | | (オプション)

-Djvm.arguments | 必要に応じて(Talend CommandLineで利用できるメモリを増加させる場合など)、JVMの引数を指定します。

Talendが提供する8.0 R2022-07以降のTalend Studioマンスリーアップデートをインストールしている場合、Talend CommandLineのインストールに使われるEclipse p2ディレ クターアプリケーションにもこのJVM引数が適用されます。詳細は、[Installing software using the p2 director application](https://help.eclipse.org/latest/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/p2_director.html)をご覧ください。

例:

```
-Djvm.arguments=-Xms512m -Xmx4000m
``` | | | (オプション)

-Dstudio.allow.java.internal.access | ビルド時にJavaクラスのアクセスエラーを防ぐためには、このパラメーターをtrueの値で追加します。

例:

```
-Dstudio.allow.java.internal.access=true
```

情報メモ警告: この方法でビルドされたジョブをJava 8で実行することはできません。

このオプションの詳細、およびTalend Studioプロジェクト設定で有効にする方法は、[Talend Studioのドキュメンテーション](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/setting-compiler-compliance-level)をお読みください。 | | | (オプション)

-Dcodes.compile.failOnError | ビルドしているアーティファクトで使用されない、コンパイルエラーを持ったルーチンが発生する時にCIビルドが失敗することを防止するには、このパラメーターをfalse値で追加し、それらをスキップしてコンパイルを続行します。

例:

```
-Dcodes.compile.failOnError=false
``` | |