Quarkusアプリケーションの再オーグメンテーション

Quarkusのアプリケーション設定には、2種類の設定オプションがあります。

オーグメンテーションとは、アプリケーションのビルドプロセスの段階で、アプリケーションのバイトコードがアプリケーションのビルド時の設定に応じて最適化されることです。 EAR ファイルが Jakarta EE サーバーにデプロイされるときに行われていた初期化ステップ (静的設定のパース、プロキシーインスタンスの作成など) が、オーグメンテーション時に行われるようになりました。 オーグメンテーション後に追加されたCDI Beanは (プロキシークラスがないため) 動作しません。また、オーグメンテーション後に変更されたビルド時のプロパティー (例: quarkus.datasource.db-kind) は無視されます。 ビルド時のプロパティーには、すべての設定オプションのリスト でロックアイコン () が付いています。 プロファイルやその他の方法でプロパティーをオーバーライドしても関係ありません。

再オーグメンテーションは、アプリケーションのユーザーがビルド時のプロパティーの一部を変更できるようにしたい場合に便利です。 たとえば、データベースドライバーの変更や、機能のオン/オフ (例: OpenTelemetry または Config Consul) などの場合に便利です。 ユーザー環境に依存するビルド時のプロパティーが 2 つか 3 つしかない場合は、アプリケーションの代替ビルドの提供を検討してもよいでしょう。しかし、そのようなプロパティーが多い場合は、代わりに変更可能な jar を配布し、ユーザーが自分の環境に合わせてアプリケーションを再調整できるようにする方が良いかもしれません。 パッケージタイプ mutable-jar では、ネイティブイメージを使用できない点に注意してください。 その結果と、他にどんな選択肢があるかを考えてみてください。

サーバーの起動に数分かかり、準備が整うまでコーヒーを楽しむことができた古き良き時代を懐かしむのでなければ、ランタイムに再オーグメンテーションを行うことは得策ではありません。

オーグメンテーションステップを実行するためには、使用される Quarkus エクステンションのデプロイメント JAR が必要です。 これらのJARは、 mutable-jar のディストリビューションにのみ含まれています。つまり、 quarkus.package.jar.type=mutable-jar でアプリケーションを構築する必要があります。 mutable-jar ディストリビューションは、 fast-jar ディストリビューションと同じですが、追加のフォルダー quarkus-app/lib/deployment には、 デプロイメント JAR とその依存関係 (および一部のクラスローダ設定) が含まれています。