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

手順

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

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

   Copy to Clipboard Toggle word wrap

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

   • Maven の使用:

     • Docker の場合:

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

       Copy to Clipboard Toggle word wrap

     • Podman の場合:

       ./mvnw package -Pnative -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 -Pnative

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

手順

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

   • Docker:

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

     Copy to Clipboard Toggle word wrap

   • Podman:

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

     Copy to Clipboard Toggle word wrap

2. 次のいずれかの方法を使用して、コンテナーイメージをビルドします。

   • Docker:

     docker build -f src/main/docker/Dockerfile.native -t quarkus-quickstart/getting-started .

     Copy to Clipboard Toggle word wrap

   • Podman

     podman build -f src/main/docker/Dockerfile.native -t quarkus-quickstart/getting-started .

     Copy to Clipboard Toggle word wrap

3. 次のいずれかの方法を使用して、コンテナーを実行します。

   • Docker:

     docker run -i --rm -p 8080:8080 quarkus-quickstart/getting-started

     Copy to Clipboard Toggle word wrap

   • Podman:

     podman run -i --rm -p 8080:8080 quarkus-quickstart/getting-started

     Copy to Clipboard Toggle word wrap

手順

1. OpenShift CLI にログインします。

   oc login -u <username_url>

   Copy to Clipboard Toggle word wrap

2. OpenShift に新規プロジェクトを作成します。

   oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

3. src/main/docker/Dockerfile.native ファイルに基づいてビルド設定を作成します。

   cat src/main/docker/Dockerfile.native | oc new-build --name <build_name> --strategy=docker --dockerfile -

   Copy to Clipboard Toggle word wrap

4. プロジェクトをビルドします。

   oc start-build <build_name> --from-dir .

   Copy to Clipboard Toggle word wrap

5. プロジェクトを OpenShift Container Platform にデプロイします。

   oc new-app <build_name>

   Copy to Clipboard Toggle word wrap

6. サービスを公開するには、以下を実行します。

   oc expose svc/<build_name>

   Copy to Clipboard Toggle word wrap