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

手順

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

2. code.quarkus.redhat.com アプリケーションでは、利用可能なバージョンのリストから、Red Hat build of Quarkus の最新リリースがデフォルトで選択されます。

   注記

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

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

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

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

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

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

        注記

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

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

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

      
   2. プロジェクトによって生成されたアーティファクトに使用するバージョンを入力します。このフィールドのデフォルト値は 1.0.0-SNAPSHOT です。semantic versioning の使用が推奨されますが、別のバージョン管理タイプを指定することもできます。

   3. code.quarkus.redhat.com でプロジェクトにスターターコードを追加するかどうかを選択します。"STARTER-CODE" でマークされたエクステンションをプロジェクトに追加する場合、このオプションを有効にして、プロジェクト生成時にそのエクステンションのサンプルクラスとリソースファイルを自動的に作成できます。ただし、サンプルコードを提供するエクステンションを追加しない場合は、このオプションは生成されたプロジェクトに影響しません。

      注記

      code.quarkus.redhat.com アプリケーションでは、Red Hat build of Quarkus の最新リリースが自動的に使用されます。必要に応じて、プロジェクトを生成した後に pom.xml ファイルで以前の BOM バージョンに手動で変更できますが、ベストプラクティスはデフォルトを維持することです。

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

   重要

   同じプロジェクトで quarkus-rest エクステンションと quarkus-resteasy エクステンションを使用しないでください。どちらも同様の機能を提供しますが、動作方法は非常に異なります。quarkus-rest の使用が推奨されます。

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

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

   

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

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

検証

1. 開発モードで、アプリケーションのコンパイルと起動を行います。詳細は、Red Hat build of Quarkus Getting Started プロジェクトのコンパイルおよび起動 を参照してください。
2. Quarkus CLI から Getting Started プロジェクトをパッケージ化して実行します。詳細は、Red Hat build of Quarkus Getting Started アプリケーションのパッケージ化および実行 を参照してください。