1.7. エクステンションのインストールと管理
Red Hat build of Quarkus では、エクステンションを使用してアプリケーションの機能を拡張し、フレームワークを設定および起動してアプリケーションに統合できます。この手順では、エクステンションを検索して Quarkus プロジェクトに追加する方法を説明します。
前提条件
- Quarkus Maven プロジェクトを作成している。
- オプション: Quarkus コマンドラインインターフェイス (CLI) がインストールされている。これは、Quarkus エクステンションを管理する方法の 1 つとして使用できます。詳細は、Quarkus CLI のインストール を参照してください。
Quarkus CLI は、Quarkus プロジェクトの作成、更新、ビルドなどのタスクを含む開発目的で使用されます。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。
手順
- Quarkus プロジェクトディレクトリーに移動します。
次のいずれかの方法で、使用可能なすべてのエクステンションをリスト表示します。
Maven を使用する場合:
./mvnw quarkus:list-extensions
./mvnw quarkus:list-extensionsCopy to Clipboard Copied! Toggle word wrap Toggle overflow Quarkus CLI を使用する場合:
quarkus extension --installable
quarkus extension --installableCopy to Clipboard Copied! Toggle word wrap Toggle overflow
次のいずれかの方法を使用して、プロジェクトにエクステンションを追加します。
Maven を使用して、次のコマンドを入力します。この場合の
<extension>は、追加するエクステンションのグループ、アーティファクト、バージョン (GAV) です。./mvnw quarkus:add-extension -Dextensions="<extension>"
./mvnw quarkus:add-extension -Dextensions="<extension>"Copy to Clipboard Copied! Toggle word wrap Toggle overflow たとえば、Agroal エクステンションを追加するには、以下のコマンドを入力します。
./mvnw quarkus:add-extension -Dextensions="io.quarkus:quarkus-agroal"
./mvnw quarkus:add-extension -Dextensions="io.quarkus:quarkus-agroal"Copy to Clipboard Copied! Toggle word wrap Toggle overflow Quarkus CLI を使用して、次のコマンドを入力します。この場合の
<extension>は、追加するエクステンションのグループ、アーティファクト、バージョン (GAV) です。quarkus extension add '<extension>'
quarkus extension add '<extension>'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
特定のエクステンションを検索するには、
-Dextensions=の後にエクステンション名または名前の一部を入力します。以下の例では、名前にagroalのテキストが含まれるエクステンションを検索します。./mvnw quarkus:add-extension -Dextensions=agroal
./mvnw quarkus:add-extension -Dextensions=agroalCopy to Clipboard Copied! Toggle word wrap Toggle overflow このコマンドは、以下の結果を返します。
[SUCCESS] ✅ Extension io.quarkus:quarkus-agroal has been installed
[SUCCESS] ✅ Extension io.quarkus:quarkus-agroal has been installedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 同様に、Quarkus CLI では次のように入力できます。
quarkus extension add 'agroal'
quarkus extension add 'agroal'Copy to Clipboard Copied! Toggle word wrap Toggle overflow