1.4. ネイティブ実行可能ファイルの設定プロパティー

プロパティー

説明

型

デフォルト

quarkus.native.debug.enabled

デバッグを有効にし、別の .debug ファイルにデバッグシンボルを生成します。quarkus.native.container-build と使用すると、Red Hat build of Quarkus は、ネイティブイメージからのデバッグ情報を分割する objcopy ユーティリティーをインストールする binutils パッケージを含む Red Hat Enterprise Linux または他の Linux ディストリビューションのみをサポートします。

boolean

false

quarkus.native.resources.excludes

ネイティブイメージに追加するべきではないリソースパスに一致する glob のコンマ区切りリスト。

文字列のリスト

quarkus.native.additional-build-args

ビルドプロセスにパスする追加の引数。

文字列のリスト

quarkus.native.enable-http-url-handler

HTTP URL ハンドラーを有効にします。これにより、HTTP URL に対して URL.openConnection() を実行できるようになります。

boolean

true

quarkus.native.enable-https-url-handler

HTTPS URL ハンドラーを有効にします。これにより、HTTPS URL に対して URL.openConnection() を実行できるようになります。

boolean

false

quarkus.native.enable-all-security-services

ネイティブイメージにすべてのセキュリティーサービスを追加します。

boolean

false

quarkus.native.add-all-charsets

ネイティブイメージにすべてのキャラクターセットを追加します。これにより、イメージサイズが大きくなります。

boolean

false

quarkus.native.graalvm-home

GraalVM ディストリビューションのパスが含まれます。

string

${GRAALVM_HOME:}

quarkus.native.java-home

JDK のパスが含まれます。

file

${java.home}

quarkus.native.native-image-xmx

ネイティブイメージを生成するために使用する Java の最大ヒープサイズ。

string

quarkus.native.debug-build-process

ネイティブイメージのビルドを実行する前に、デバッガーがビルドプロセスにアタッチするまで待機します。GraalVM インターナルの知識のあるユーザーにとって、これは高度なオプションになります。

boolean

false

quarkus.native.publish-debug-build-process-port

debug-build-process が true の場合は、docker でビルドする際にデバッグポートを公開します。

boolean

true

quarkus.native.cleanup-server

ネイティブイメージサーバーを再起動します。

boolean

false

quarkus.native.enable-isolates

メモリー管理を改善するために分離を有効にします。

boolean

true

quarkus.native.enable-fallback-images

ネイティブイメージが失敗した場合に、JVM ベースのフォールバックイメージを作成します。

boolean

false

quarkus.native.enable-server

ネイティブイメージサーバーを使用します。これによりコンパイルが高速化されますが、キャッシュ無効化の問題により変更が失われる可能性があります。

boolean

false

quarkus.native.auto-service-loader-registration

すべての META-INF/services エントリーを自動的に登録します。

boolean

false

quarkus.native.dump-proxies

検査用にすべてのプロキシーのバイトコードをダンプします。

boolean

false

quarkus.native.container-build

コンテナーランタイムを使用するビルド。デフォルトで Docker が使用されます。

boolean

false

quarkus.native.builder-image

イメージをビルドするための Docker イメージ。

string

registry.access.redhat.com/quarkus/mandrel-for-jdk-21-rhel8:23.1

quarkus.native.container-runtime

イメージのビルドに使用されるコンテナーランタイム。たとえば、Docker などがあります。

string

quarkus.native.container-runtime-options

コンテナーランタイムにパスするオプション。

文字列のリスト

quarkus.native.enable-vm-inspection

イメージの VM イントロスペクションを有効化します。

boolean

false

quarkus.native.full-stack-traces

イメージのフルスタックトレースを有効化します。

boolean

true

quarkus.native.enable-reports

呼び出しパスと、含まれるパッケージ、クラス、メソッドのレポートを生成します。

boolean

false

quarkus.native.report-exception-stack-traces

フルスタックトレースを使用して例外を報告します。

boolean

true

quarkus.native.report-errors-at-runtime

ランタイム時にエラーを報告します。これにより、サポートされていない機能を使用すると、ランタイムでアプリケーションが失敗する可能性があります。

boolean

false

quarkus.native.resources.includes

ネイティブイメージに追加する必要のあるリソースパスに一致する glob のコンマ区切りリスト。すべてのプラットフォームで、パス区切り文字としてスラッシュ (/) 文字を使用します。glob の開始文字をスラッシュにしてはいけません。たとえば、ソースツリーに src/main/resources/ignored.png と src/main/resources/foo/selected.png があり、依存関係 JAR の 1 つに bar/some.txt ファイルが含まれ、quarkus.native.resources.includes が foo/,bar//*.txt に設定されていると、src/main/resources/foo/selected.png ファイルと bar/some.txt ファイルがネイティブイメージに含まれますが、src/main/resources/ignored.png は含まれません。詳細は、サポートされている glob 機能をリストした次の表を参照してください。

文字列のリスト