1.3. コマンドラインで Red Hat build of Quarkus プロジェクトを作成する
コマンドラインで Red Hat build of Quarkus Maven プラグインを使用し、コマンドラインで属性および値を指定するか、インタラクティブモードでプラグインを使用して、Quarkus プロジェクトを作成できます。Quarkus コマンドラインインターフェイス (CLI) を使用して Quarkus プロジェクトを作成することもできます。作成されたプロジェクトには次の要素が含まれます。
- Maven の構造
- 関連するユニットテスト
-
アプリケーションの起動後に
http://localhost:8080でアクセス可能なランディングページ -
src/main/dockerの JVM およびネイティブモードのDockerfileファイルの例 - アプリケーションの設定ファイル
前提条件
OpenJDK 17 または 21 がインストールされている。
- Red Hat build of OpenJDK をダウンロードするには、Red Hat カスタマーポータルにログインし、ソフトウェアダウンロード に移動します。
-
JAVA_HOME環境変数を設定して Java SDK の場所を指定している。 Apache Maven 3.8.6 以降がインストールされている。
- Maven をダウンロードするには、Apache Maven Project の Web サイトにアクセスしてください。
- オプション: Quarkus コマンドラインインターフェイス (CLI) がインストールされている。これは、Quarkus プロジェクトを作成する方法の 1 つとして使用できます。詳細は、Quarkus CLI のインストール を参照してください。
Quarkus CLI は、Quarkus プロジェクトの作成、更新、ビルドなどのタスクを含む開発目的で使用されます。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。
手順
コマンドターミナルで以下のコマンドを入力して、Maven が OpenJDK 17 または 21 を使用していること、および Maven のバージョンが 3.8.6 以降であることを確認します。
mvn --version- 前のコマンドで OpenJDK 17 または 21 が返されない場合は、OpenJDK 17 または 21 へのパスを PATH 環境変数に追加し、前のコマンドを再度入力します。
プロジェクトを作成するには、次のいずれかの方法を使用します。
Quarkus Maven プラグインを使用します。以下のコマンドを実行します。
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.15.7.redhat-00001:create \ -DprojectGroupId=<project_group_id> \ -DprojectArtifactId=<project_artifact_id> \ -DplatformGroupId=com.redhat.quarkus.platform \ -DplatformArtifactId=quarkus-bom \ -DplatformVersion=3.15.7.redhat-00001 -DpackageName=getting.startedこのコマンドでは、以下の値を置き換えてください。
-
<project_group_id>: プロジェクトの一意識別子 -
<project_artifact_id>: プロジェクトおよびプロジェクトディレクトリーの名前
-
インタラクティブモードでプロジェクトを作成します。
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.15.7.redhat-00001:createプロンプトが表示されたら、必要な属性値を入力します。
注記次のコマンドを入力し、プロジェクト属性のデフォルト値でプロジェクトを作成することもできます。
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.15.7.redhat-00001:create -BQuarkus CLI を使用します。以下のコマンドを実行します。
quarkus create app my-groupId:my-artifactId --package-name=getting.started次のコマンドを使用して、利用可能なオプションのリストを取得することもできます。
quarkus create app --help
デフォルトでは、Quarkus Maven プラグインは最新の推奨 quarkus-bom バージョンを使用します。quarkus-bom ファイルはエクステンションを集約し、アプリケーションからエクステンションを参照して依存関係バージョンを調整できるようにします。オフラインの場合、Quarkus Maven プラグインは、Maven リポジトリーから最後に更新を取得したときから、quarkus-bom の最新の優先バージョンを使用します。