4.3. Thorntail Maven プラグイン設定オプション
Thorntail Maven プラグインは以下の設定オプションを受け入れます。
- bundleDependencies
true
の場合、依存関係は-thorntail.jar
ファイルに含まれます。それ以外の場合は、ローカル Maven リポジトリーまたは実行時にネットワークから解決されます。プロパティー
thorntail.bundleDependencies
デフォルト
true
Used by (使用フィールド)
package
bundleDependencies
を false
に設定すると、ローカルの Maven リポジトリーがランタイム時に使用されます。Maven リポジトリーの場所は、settings.xml
ファイルまたはシステムプロパティーから取得されます。
settings.xml
ファイルがあり、ローカルリポジトリーを定義する場合、このリポジトリーが使用されます。以下の場所は、settings.xml
ファイルを検索します。最初に発生するファイルは、Maven リポジトリーの場所を取得するために使用されます。-
jboss.modules.settings.xml.url
システムプロパティーが定義されている場合、このプロパティーに定義されたsettings.xml
ファイルが使用されます。値は file://... である必要があります。
URL。 -
~/.m2/settings.xml
ファイルが存在する場合は、これが使用されます。 -
$M2_HOME/conf/settings.xml
ファイルが存在する場合は、それが使用されます。
-
Maven リポジトリーへのパスが
settings.xml
ファイルに定義されていない場合は、以下を行います。-
maven.repo.local
システムプロパティーが定義されている場合、このリポジトリーが使用されます。 -
そうでない場合は、
~/.m2/repository
が使用されます。
-
- debug
デバッグに使用するポート。設定すると、Thorntail プロセスが開始時に一時停止し、このポートでデバッガーを開きます。
プロパティー
thorntail.debug.port
デフォルト
Used by (使用フィールド)
run
,start
- environment
アプリケーションの実行時に使用する環境変数のプロパティースタイルの一覧。
プロパティー
none
デフォルト
Used by (使用フィールド)
複数開始
、実行
、開始
- environmentFile
アプリケーションの実行時に使用する環境変数が含まれる
.properties
ファイル。プロパティー
thorntail.environmentFile
デフォルト
Used by (使用フィールド)
複数開始
、実行
、開始
- filterWebInfLib
true
の場合、プラグインはプロジェクト WAR ファイルのWEB-INF/lib
ディレクトリーから Thorntail ランタイムによって提供されるアーティファクトを削除します。uberjar のみ
の場合、この変換は uberjar に配置される WAR ファイルでのみ行われ、スタンドアロン WAR ファイルは変更されません。それ以外の場合は、WEB-INF/lib
の内容は変更されません。プロパティー
thorntail.filterWebInfLib
デフォルト
true
Used by (使用フィールド)
package
このオプションは必須ではありませんが、Thorntail プラグインがアプリケーションが必要とする依存関係を削除した場合に回避策として提供されています。false の場合、WEB-INF/lib
ディレクトリーにアプリケーションの機能に影響を与える可能性がある Thorntail アーティファクトが含まれないように、開発者の責任があります。1 つの方法として、分解で依存関係を表現し、自動検出 に依存するか、または fractions オプションを使用して必要な追加分を明示的に一覧表示する方法が 挙げ られます。
- fractionDetectMode
分検出モード。利用可能なオプションは以下のとおりです。
-
when_missing
: Thorntail 依存関係が見つからない場合のみ実行します。 -
force
: 常に実行され、検出された分を既存の依存関係にマージします。既存の依存関係が優先されます。 -
Never
: 分検出を無効にします。
プロパティー
thorntail.detect.mode
デフォルト
when_missing
Used by (使用フィールド)
package
,run
,start
-
- 分
自動検出を使用する場合に含める追加分の一覧です。これは、検出できない分、またはユーザー指定の分について役に立ちます。
分を指定する場合は、*
group:artifact:version
*artifact:version
*artifact
:version * アーティファクトのいずれかを使用します。グループを指定しないと、
io.thorntail
が想定されます。バージョンが指定されていない場合、バージョンは使用しているプラグインバージョンの Thorntail BOM から取得されます。
値が
!
文字で開始すると、対応する自動検出された部分がインストールされません(他の部分の依存関係である場合を除く)。以下の例では、アプリケーションがjavax.servlet
パッケージのクラスを参照する場合でも、Undertow 分はインストールされません。<plugin> <groupId>io.thorntail</groupId> <artifactId>thorntail-maven-plugin</artifactId> <version>${version.thorntail}</version> <executions> <execution> <goals> <goal>package</goal> </goals> <configuration> <fractions> <fraction>!undertow</fraction> </fractions> </configuration> </execution> </executions> </plugin>
プロパティー
none
デフォルト
Used by (使用フィールド)
package
,run
,start
- jvmArguments
追加の JVM 引数
を指定する <jvmArgument
> 要素の一覧(-Xmx32m
など)。プロパティー
thorntail.jvmArguments
デフォルト
Used by (使用フィールド)
複数開始
、実行
、開始
- modules
追加のモジュール定義を含むディレクトリーへのパス。
プロパティー
none
デフォルト
Used by (使用フィールド)
package
,run
,start
- processes
開始するアプリケーションの設定( multistartを参照)。
プロパティー
none
デフォルト
Used by (使用フィールド)
multistart
- properties
「Thorntail Maven プラグイン設定プロパティー」 を参照してください。
プロパティー
none
デフォルト
Used by (使用フィールド)
package
,run
,start
- propertiesFile
「Thorntail Maven プラグイン設定プロパティー」 を参照してください。
プロパティー
thorntail.propertiesFile
デフォルト
Used by (使用フィールド)
package
,run
,start
- stderrFile
起動プロセスの
stderr
出力に送信される代わりに、stderr
出力が保存されるファイルへのパスを指定します。プロパティー
thorntail.stderr
デフォルト
Used by (使用フィールド)
run
,start
- stdoutFile
起動プロセスの
stdout
出力に送信されるのではなく、stdout
の出力が保存されるファイルへのパスを指定します。プロパティー
thorntail.stdout
デフォルト
Used by (使用フィールド)
run
,start
- useUberJar
指定されている場合は、${
project.build.directory} に
ある-thorntail.jar
ファイルが使用されます。この JAR は自動的に作成されないため、パッケージ
ゴールを最初に実行するようにしてください。プロパティー
thorntail.useUberJar
デフォルト
Used by (使用フィールド)
run
,start