第1章 Quarkus アプリケーションのネイティブ実行可能ファイルへのコンパイル

手順

1. Getting Started プロジェクトの pom.xml ファイルを開き、プロジェクトに native プロファイルが含まれていることを確認します。

   <profiles>
       <profile>
           <id>native</id>
           <properties>
               <quarkus.package.type>native</quarkus.package.type>
           </properties>
       </profile>
   </profiles>

2. 次のいずれかの方法を使用して、ネイティブ実行可能ファイルをビルドします。

   • Maven の使用:

     • Docker の場合:

       ./mvnw package -Pnative -Dquarkus.native.container-build=true

     • Podman の場合:

       ./mvnw package -Pnative -Dquarkus.native.container-build=true -Dquarkus.native.container-runtime=podman

   • Quarkus CLI を使用する:

     • Docker の場合:

       quarkus build --native -Dquarkus.native.container-build=true

     • Podman の場合:

       quarkus build --native -Dquarkus.native.container-build=true -Dquarkus.native.container-runtime=podman

       手順を実行した結果

       これらのコマンドを実行すると、target ディレクトリーに *-runner バイナリーが作成されます。その場合、以下が適用されます。

     • *-runner ファイルは、Quarkus が生成したビルド済みのネイティブバイナリーです。

     • target ディレクトリーは、Maven アプリケーションをビルドするときに Maven が作成するディレクトリーです。

       重要

       Quarkus アプリケーションをネイティブ実行可能ファイルにコンパイルすると、分析および最適化の際にメモリーを大量に消費します。quarkus.native.native-image-xmx 設定プロパティーを設定して、ネイティブコンパイル時に使用されるメモリーの量を制限できます。メモリー制限を低く設定すると、ビルド時間が長くなる可能性があります。

3. ネイティブ実行可能ファイルを実行するには、以下のコマンドを入力します。

   ./target/*-runner

手順

1. GraalVM または Mandrel の場合は、次のいずれかの方法を使用してネイティブ実行可能ファイルをビルドします。

   • Maven の使用:

     ./mvnw package -Pnative

   • Quarkus CLI を使用する:

     quarkus build --native

     手順を実行した結果

     これらのコマンドを実行すると、target ディレクトリーに *-runner バイナリーが作成されます。その場合、以下が適用されます。

     • *-runner ファイルは、Quarkus が生成したビルド済みのネイティブバイナリーです。

     • target ディレクトリーは、Maven アプリケーションをビルドするときに Maven が作成するディレクトリーです。

       注記

       ネイティブ実行可能ファイルをビルドすると、quarkus.profile プロパティーで変更されない限り、prod プロファイルが有効になります。

2. ネイティブ実行可能ファイルを実行します。

   ./target/*-runner

   注記
   • quarkus.test.native-image-profile プロパティーで変更されない限り、ネイティブテストはデフォルトで prod プロファイルを使用して実行されます。