Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.2. 環境の準備

Quarkus の使用を開始する前に、環境を準備する必要があります。

手順

  • システムで次のインストールが完了していることを確認します。

    • OpenJDK 11 または 17 をインストールし、JAVA_HOME 環境変数を設定して Java SDK の場所を指定している。

    • Apache Maven 3.8.6 以降がインストールされている。Maven は、Apache Maven Project の Web サイトから入手できます。

    • オプション: Quarkus コマンドラインインターフェイス (CLI) を使用する場合は、それがインストールされていることを確認してください。

      • Quarkus CLI のインストール方法については、Quarkus CLI で該当するコミュニティー情報を参照してください。
重要

Quarkus CLI は開発モードのみを対象としています。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。

1.2.1. Red Hat build of Quarkus の BOM
リンクのコピー

Red Hat build of Quarkus 2.2 以降、すべてのコア Quarkus エクステンションの依存関係バージョンは、com.redhat.quarkus.platform:quarkus-bom ファイルを使用して管理されます。

Bill of Materials (BOM) ファイルの目的は、プロジェクト内の Quarkus アーティファクトの依存関係バージョンを管理することです。これにより、プロジェクトで BOM を使用するときに、どの依存関係バージョンが連携するかを指定する必要がなくなります。代わりに、Quarkus BOM ファイルを pom.xml 設定ファイルにインポートできます。依存関係のバージョンは <dependencyManagement> セクションに含まれています。そのため、pom.xml ファイルの指定の BOM で管理される個別の Quarkus 依存関係のバージョンを記述する必要はありません。

Red Hat build of Quarkus で使用できる、サポートされるエクステンション固有の BOM に関する情報を表示するには、Red Hat build of Quarkus コンポーネントの詳細 を参照してください。

アプリケーションで使用するプラットフォームメンバーのエクステンションのメンバー固有 BOM をインポートのみインポートする必要があります。したがって、モノリシックなシングル BOM と比較して、管理する依存関係が少なくなります。すべてのメンバー固有 BOM はユニバーサル Quarkus BOM のフラグメントであるため、競合を引き起こすことなくメンバー BOM を任意の順序でインポートできます。

1.2.2. Apache Maven と Red Hat build of Quarkus
リンクのコピー

Apache Maven は分散型構築自動化ツールで、Java アプリケーション開発でソフトウェアプロジェクトの作成、ビルド、管理に使用されます。Maven は Project Object Model (POM) ファイルと呼ばれる標準の設定ファイルを使用して、プロジェクトの定義や構築プロセスの管理を行います。POM ファイルには、モジュールとコンポーネントの依存関係、ビルド順序、結果として得られるプロジェクトのパッケージ化と出力のターゲットがXML ファイルを使用して記述されており、これによりプロジェクトが正しく均一にビルドされることが保証されます。

Maven リポジトリー

Maven リポジトリーには、Java ライブラリー、プラグイン、およびその他のビルドアーティファクトが格納されます。デフォルトのパブリックリポジトリーは Maven 2 Central Repository ですが、複数の開発チームの間で共通のアーティファクトを共有する目的で、社内のプライベートおよび内部リポジトリーとすることが可能です。また、サードパーティーのリポジトリーも利用できます。

Quarkus プロジェクトでは、Red Hat が提供する Maven リポジトリーを使用するか、Red Hat build of Quarkus の Maven リポジトリーをダウンロードできます。

Maven プラグイン

Maven プラグインは、1 つ以上のタスクを実行する POM ファイルの定義済みの部分です。Red Hat build of Quarkus アプリケーションでは、次の Maven プラグインを使用します。

  • Quarkus Maven プラグイン (quarkus-maven-plugin): Maven は、Quarkus プロジェクトを作成し、アプリケーションを JAR ファイルにパッケージ化し、開発モードを提供できるようになります。
  • Maven Surefire プラグイン (maven-surefire-plugin): Quarkus が test プロファイルを有効にすると、ビルドライフサイクルの test フェーズでのユニットテストに、Maven Surefire プラグインが使用されます。プラグインは、テストレポートが含まれるテキストファイルと XML ファイルを生成します。

1.2.3. オンラインリポジトリーの Maven の settings.xml ファイルを設定する
リンクのコピー

Red Hat がホストする Quarkus リポジトリーを Quarkus Maven プロジェクトで使用するには、ユーザー用に settings.xml ファイルを設定します。リポジトリーマネージャーまたは共有サーバー上のリポジトリーで使用される Maven 設定により、プロジェクトの制御と管理が向上します。

注記

Maven の settings.xml ファイルを変更してリポジトリーを設定する場合、変更はすべての Maven プロジェクトに適用されます。設定を特定のプロジェクトにのみ適用する場合は、-s オプションを使用して、プロジェクト固有の settings.xml ファイルへのパスを指定します。

手順

  1. テキストエディターまたは統合開発環境 (IDE) で、Maven $HOME/.m2/settings.xml ファイルを開きます。

    注記

    $HOME/.m2/ ディレクトリーに settings.xml ファイルが存在しない場合は、$MAVEN_HOME/conf/ ディレクトリーから $HOME/.m2/ ディレクトリーに settings.xml ファイルをコピーします。

  2. 以下の行を settings.xml ファイルの <profiles> 要素に追加します。 

    <!-- Configure the Red Hat build of Quarkus Maven repository -->
<profile>
  <id>red-hat-enterprise-maven-repository</id>
  <repositories>
    <repository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>https://maven.repository.redhat.com/ga/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>https://maven.repository.redhat.com/ga/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </pluginRepository>
  </pluginRepositories>
</profile>
    Copy to Clipboard Toggle word wrap

  3. 以下の行を settings.xml ファイルの <activeProfiles> 要素に追加し、ファイルを保存します。 

    <activeProfile>red-hat-enterprise-maven-repository</activeProfile>
    Copy to Clipboard Toggle word wrap

1.2.4. Maven プロジェクトを Red Hat build of Quarkus に再設定する
リンクのコピー

Quarkus コミュニティープロジェクトは、プロジェクト POM ファイルの Maven 設定を変更することで Red Hat build of Quarkus に移行できます。

前提条件

  • pom.xml ファイル内の Quarkus community artifacts に依存する Maven でビルドされた Quarkus プロジェクトがある。

手順

  • プロジェクトの pom.xml ファイルの <properties> セクションで、次の値を変更します。

    • <quarkus.platform.group-id> プロパティーの値を com.redhat.quarkus.platform に変更します。

    • <quarkus.platform.version> プロパティーの値を 3.8.5.SP1-redhat-00001 に変更します。

      pom.xml

      <project>
  ...
  <properties>
     ...
     <quarkus.platform.group-id>com.redhat.quarkus.platform</quarkus.platform.group-id>
     <quarkus.platform.artifact-id>quarkus-bom</quarkus.platform.artifact-id>
     <quarkus.platform.version>3.2.12.SP1-redhat-00003</quarkus.platform.version>
     ...
  </properties>
  ...
</project>
      Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat