1.11. Red Hat build of Quarkus Getting Started アプリケーションをネイティブモードでパッケージ化および実行する


ネイティブモードでは、アプリケーションビルドからの出力は、圧縮またはアーカイブ JAR ファイルではなく、プラットフォームに依存するネイティブバイナリーファイルになります。ネイティブモードと JVM の違いについて、詳しくは Getting Started ガイドの JVM とネイティブビルドモード の章を参照してください。

前提条件

  • OpenJDK 11 または 17 がインストールされており、JAVA_HOME 環境変数を設定して Java SDK の場所を指定している。
  • Apache Maven 3.8.6 以降がインストールされている。
  • 動作する C development environment がある。
  • Docker や Podman などの動作するコンテナーランタイムがある。
  • オプション: Quarkus コマンドラインインターフェイス (CLI) を使用する場合は、それがインストールされていることを確認してください。

    • Quarkus CLI のインストール方法については、Quarkus CLI で該当するコミュニティー情報を参照してください。
  • Quarkus Getting Started プロジェクト のクローンを作成してコンパイルしている。
  • GraalVM のコミュニティーエディションまたはエンタープライズエディションをダウンロードしてインストールした。

    • GraalVM のコミュニティーエディションまたはエンタープライズエディションをダウンロードおよびインストールするには、公式の Getting Started with GraalVM ドキュメントを参照してください。
    • もしくは、sdkmanhomebrewscoop などの、プラットフォーム固有のインストールツールを使用します。
注記

GraalVM のコミュニティーエディションを使用して Getting Started ガイドのすべての手順を完了できますが、GraalVM のコミュニティーエディションは Red Hat build of Quarkus の実稼働環境ではサポートされません。詳細は、Red Hat build of Quarkus アプリケーションをネイティブ実行可能ファイルにコンパイルする を参照してください。

手順

  1. ランタイム環境を設定するために、GRAALVM_HOME 環境変数を GraalVM インストールディレクトリーに設定します。以下に例を示します。

    export GRAALVM_HOME=$HOME/Development/graalvm/
    Copy to Clipboard Toggle word wrap
    • macOS の場合、変数が Home サブディレクトリーを指すようにします。

      export GRAALVM_HOME=$HOME/Development/graalvm/Contents/Home/
      Copy to Clipboard Toggle word wrap
    • Windows の場合、コントロールパネルを使用して環境変数を設定します。
  2. native-image ツールをインストールします。

    ${GRAALVM_HOME}/bin/gu install native-image
    Copy to Clipboard Toggle word wrap
  3. JAVA_HOME 環境変数を GraalVM インストールディレクトリーに設定します。

    export JAVA_HOME=${GRAALVM_HOME}
    Copy to Clipboard Toggle word wrap
  4. GraalVM bin ディレクトリーをパスに追加します。

    export PATH=${GRAALVM_HOME}/bin:$PATH
    Copy to Clipboard Toggle word wrap
  5. Getting Started プロジェクトフォルダーに移動します。

    cd getting-started
    Copy to Clipboard Toggle word wrap
  6. 次のいずれかの方法で、ネイティブイメージをコンパイルします。

    • Maven を使用:

      mvn clean package -Pnative
      Copy to Clipboard Toggle word wrap
    • Quarkus CLI を使用:

      quarkus build --native
      Copy to Clipboard Toggle word wrap

検証

  1. アプリケーションを起動します。

    ./target/getting-started-1.0.0-SNAPSHOT-runner
    Copy to Clipboard Toggle word wrap
  2. ログメッセージを観察し、native という単語が含まれていることを確認します。

    2023-08-30 09:51:51,505 INFO [io.quarkus] (main) getting-started 1.0.0-SNAPSHOT native (powered by Red Hat build of Quarkus 3.2.9.Final) started in 0.043s.
    Listening on: http://0.0.0.0:8080
    Copy to Clipboard Toggle word wrap
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る