第1章 Red Hat build of Quarkus アプリケーションをネイティブ実行可能ファイルにコンパイルする

手順

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

   <profiles>
     <profile>
       <id>native</id>
       <activation>
         <property>
           <name>native</name>
         </property>
       </activation>
       <properties>
         <skipITs>false</skipITs>
         <quarkus.package.type>native</quarkus.package.type>
       </properties>
     </profile>
   </profiles>

   Copy to Clipboard Toggle word wrap

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

   • Maven を使用:

     • Docker の場合:

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

       Copy to Clipboard Toggle word wrap

     • Podman の場合:

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

       Copy to Clipboard Toggle word wrap

   • Quarkus CLI を使用:

     • Docker の場合:

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

       Copy to Clipboard Toggle word wrap

     • Podman の場合:

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

       Copy to Clipboard Toggle word wrap

       手順を実行した結果

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

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

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

       重要

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

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

   ./target/*-runner

   Copy to Clipboard Toggle word wrap

手順

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

   • Maven を使用:

     ./mvnw package -Dnative

     Copy to Clipboard Toggle word wrap

   • Quarkus CLI を使用:

     quarkus build --native

     Copy to Clipboard Toggle word wrap

     手順を実行した結果

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

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

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

       注記

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

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

   ./target/*-runner

   Copy to Clipboard Toggle word wrap