1.5. code.quarkus.redhat.com を使用して Getting Started プロジェクトを作成する

手順

1. Web ブラウザーで、https://code.quarkus.redhat.com に移動します。

2. 利用可能なバージョンのリストから、必要な Red Hat build of Quarkus のバージョンを選択します。

   注記

   code.quarkus.redhat.com アプリケーションは、自動的に Red Hat build of Quarkus の最新リリースを使用します。これは優先されるオプションです。ただし、必要に応じて、プロジェクト生成後に pom.xml ファイル内の以前の BOM バージョンに手動で変更することもできますが、これは推奨されません。

3. プロジェクトの基本情報を指定します。

   

   View larger image

   
   1. プロジェクトのグループ名を入力します。名前の形式は、Java パッケージ命名規則に従います (例: org.acme)。
   2. プロジェクトによって生成される Maven アーティファクトの名前 (code-with-quarkus など) を入力します。

   3. アプリケーションのコンパイルおよび起動に使用するビルドツールを選択します。選択したビルドツールにより、次の設定が決まります。

      • 生成されるプロジェクトのディレクトリー構造
      • 生成したプロジェクトで使用される設定ファイルのフォーマット

      • プロジェクトの生成後に code.quarkus.redhat.com に表示される、アプリケーションのコンパイルと起動のためのカスタムビルドスクリプトおよびコマンド

        注記

        Red Hat は、Quarkus Maven プロジェクトを作成する場合にのみ code.quarkus.redhat.com の使用をサポートします。

4. アプリケーションプロジェクトに関する追加情報を指定します。

   1. アプリケーションの詳細を含むフィールドを表示するには、More options を選択します。

      

      View larger image

      
   2. プロジェクトによって生成されたアーティファクトに使用するバージョンを入力します。このフィールドのデフォルト値は 1.0.0-SNAPSHOT です。semantic versioning の使用が推奨されます。ただし、別のタイプのバージョン管理を指定することもできます。
   3. code.quarkus.redhat.com がスターターコードをプロジェクトに追加するかどうかを選択します。"STARTER-CODE" でマークされたエクステンションをプロジェクトに追加する場合、このオプションを有効にして、プロジェクト生成時にそのエクステンションのサンプルクラスとリソースファイルを自動的に作成できます。ただし、サンプルコードを提供するエクステンションを追加しない場合、このオプションは生成されたプロジェクトには影響しません。

   image::additional-app-details-project-generator.png[code.quarkus.redhat.com サイトのアプリケーション詳細セクションのスクリーンショット。追加のアプリケーションの詳細を含む展開されたフォームが表示されています。]

5. 使用するエクステンションを選択します。Quarkus アプリケーションには、依存関係として選択したエクステンションが含まれます。Quarkus プラットフォームにより、これらのエクステンションは今後のバージョンとの互換性も確保されます。

   重要

   同じプロジェクトで RESTEasy と Quarkus REST 拡張機能を使用しないでください。どちらも同様の機能を提供しますが、動作方法は非常に異なります。Quarkus REST の使用が推奨されます。

   エクステンションの横にある quark アイコン ( ) は、そのエクステンションが Red Hat build of Quarkus プラットフォームリリースの一部であることを示します。Red Hat は、同じプラットフォームのエクステンションを使用することを推奨します。これは、エクステンションは一緒にテストおよび検証され、使用とアップグレードが容易になるためです。

   "STARTER-CODE" でマークされたエクステンションのスターターコードを自動生成するオプションを有効にできます。

   

6. 選択を確認するには、Generate your application を選択します。表示されるダイアログボックスには、次の項目が表示されます。

   • 生成されたプロジェクトを含むアーカイブをダウンロードするためのリンク
   • アプリケーションをコンパイルして起動するために使用できるコマンド
7. 生成されたプロジェクトファイルを含むアーカイブをマシンに保存するには、Download the ZIP を選択します。
8. アーカイブの内容をデプロイメントします。

9. 展開したプロジェクトファイルが含まれるディレクトリーに移動します。

   cd <directory_name>

   Copy to Clipboard Toggle word wrap

10. 次のいずれかの方法でアプリケーションを開発モードでコンパイルして起動します。

    • Maven を使用する場合:

      ./mvnw quarkus:dev

      Copy to Clipboard Toggle word wrap

    • Quarkus CLI を使用:

      quarkus dev

      Copy to Clipboard Toggle word wrap