Red Hat build of Quarkus 3.15 のリリースノート

Red Hat build of Quarkus 3.15 では、quarkus-spring-data-rest-extension が最新の spring-data-jpa 3.x 更新に合わせてリファクタリングされています。この更新では、次の重要な変更が導入されています。

このリファクタリングにより重大な変更が導入されます。詳細は、以前のバージョンとの互換性に影響する変更 の章を参照してください。

Red Hat build of Quarkus 3.15 では、Podman 専用の新しいエクステンション container-image-podman が導入されています。

Docker よりも Podman を優先したい場合は、この新しいエクステンションを使用できます。既存の container-image-docker エクステンションの機能をレプリケートすると同時に、Podman を使用してコンテナーイメージを構築し、ローカルレジストリーにロードするためのサポートも提供します。

container-image-docker エクステンションは Podman の Docker 互換 API と常に互換性がありますが、container-image-podman は Podman ツールセットを使用してイメージをシームレスに構築するように調整されています。

Docker 固有のタスクには container-image-docker エクステンションを使用し、Podman に関連するタスクには container-image-podman エクステンションを使用します。たとえば、マルチプラットフォームイメージの構築は、Docker と Podman では異なる方法で実装されます。Docker は Buildx プラグインを使用しますが、Podman はマルチプラットフォームイメージをネイティブにビルドできます。このため、その機能を実行するには特定のエクステンションを使用する必要があります。

Red Hat build of Quarkus 3.15 では、次のデフォルトの UBI イメージがアップグレードされました。

Red Hat build of Quarkus 3.15 では、エクステンションアノテーションプロセッサーの新しいアーキテクチャーが導入され、設定ドキュメントの生成方法が再開発されています。

エクステンションアノテーションプロセッサーには主に 2 つの目的があります。

この再開発により、アノテーションプロセッサーアーキテクチャーが合理化され、エクステンションの構築に必要なファイルとドキュメントの生成に必要なファイルが分離されます。

以前は、エクステンションアノテーションプロセッサーは、ルート target/generated/config ディレクトリーに設定ドキュメントを生成していました。これで、エクステンションアノテーションプロセッサーは設定のモデルを構築し、それを AsciiDoc などのさまざまな必要な形式で出力できるようになります。

詳細は、次の Quarkus リソースを参照してください。

ArC は、Red Hat build of Quarkus のコンテキストと依存性の注入 (CDI) 実装です。デフォルトでは、インターセプションはクラスベース Bean とも呼ばれるマネージド Bean に対してのみサポートされます。

Red Hat build of Quarkus 3.15 では、プロデューサーメソッドと合成 Bean のインターセプションをサポートする InterceptionProxy API と @BindingsSource アノテーションが導入されています。

InterceptionProxy API は、メソッド呼び出しをターゲットインスタンスに転送する前に、@AroundInvoke インターセプターを適用するプロキシーを作成します。@BindingsSource アノテーションを使用すると、インターセプトされたクラスが外部にあり変更できない場合に、インターセプターバインディングを設定できます。

詳細は、Quarkus の コンテキストと依存性の注入 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、Dev Services 機能を使用して開発モードを使用しているときに自動ライブリロードをオフにできる quarkus.live-reload.enabled 設定プロパティーが導入されました。

デフォルトでは、このプロパティーは true に設定されています。自動ライブリロードを無効にするには、false に設定します。

Red Hat build of Quarkus 3.15 では、quarkus config コマンドに次の更新が導入されています。

詳細は、Quarkus の Secrets 設定 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、Flyway エクステンションが Flyway 10.10 にアップグレードされます。

詳細は、Quarkus の Flyway の使用 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、大規模なエンティティーモデルの Hibernate Object-Relational Mapping (ORM) のビルド時間を短縮する機能拡張が導入されています。

特に、これらの機能拡張により、大規模なエンティティーモデルを持つアプリケーションで、Quarkus 開発モードのライブリロード機能の応答性が向上することが期待されます。

Red Hat build of Quarkus 3.15 では、Hibernate ORM がバージョン 6.6 にアップグレードされます。

詳細は、以下の資料を参照してください。

Red Hat build of Quarkus 3.15 では、Hibernate Reactive エクステンションがバージョン 2.4 にアップグレードされています。

詳細は、Quarkus の Hibernate Reactive ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、Hibernate Search がバージョン 7.2 にアップグレードされます。

Hibernate Search は、Red Hat build of Quarkus アプリケーションにインデックス作成機能と全文検索機能を提供します。Hibernate Search の詳細は、次のリソースを参照してください。

Red Hat build of Quarkus 3.15 では、MongoDB クライアントがバージョン 4.11 からバージョン 5.1 にアップグレードされます。

Red Hat build of Quarkus 3.15 では、ネイティブイメージエージェントとのインテグレーションが導入されており、これを使用して、アプリケーションをネイティブイメージにコンパイルするときに、Red Hat build of Quarkus でまだサポートされていないライブラリーまたはコンポーネントを統合できます。

このインテグレーションにより、広範なネイティブイメージ設定が必要な JDK API を使用できます。ネイティブイメージエージェントを使用して、JVM モードでアプリケーションのインテグレーションテストを実行することもできます。エージェントによって生成された設定は、サポートされていないライブラリーを使い始めたり、アプリケーションをネイティブ実行可能ファイルとして実行し始めたりする際に役立ちます。

このインテグレーションは Apache Maven でのみ利用可能です。

詳細は、Quarkus の Native リファレンス ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、Dev Services 用の quarkus-observability-devservices および quarkus-observability-devservices-lgtm エクステンションが導入され、OpenTelemetry LGTM (OTel LGTM) Docker イメージがサポートされます。

pom.xml ファイルを更新して、これらのエクステンションをそれぞれ依存関係として追加できます。以下に例を示します。

<dependency>
   <groupId>io.quarkus</groupId>
   <artifactId>quarkus-observability-devservices-lgtm</artifactId>
   <version>${project.version}</version>
    <scope>provided</scope>
</dependency>

<dependency>
   <groupId>io.quarkus</groupId>
   <artifactId>quarkus-observability-devservices-lgtm</artifactId>
   <version>${project.version}</version>
    <scope>provided</scope>
</dependency>

詳細は、次の Quarkus リソースを参照してください。

Red Hat build of Quarkus 3.15 では、OpenTelemetry (OTel) SDK バージョンが 1.32 から 1.39 にアップグレードされます。また、OTel 計装はバージョン 1.32 から 2.50 にアップグレードされます。

これらのアップグレードにより、次の重大な変更が導入されます。

詳細は、以前のバージョンとの互換性に影響する変更 を参照してください。

Red Hat build of Quarkus 3.15 では、OpenTelemetry (OTel) で quarkus-redis-client エクステンションを使用する際のトレーシングのサポートが導入されています。

Red Hat build of Quarkus は、トレーシング用の手動および自動の計装を提供します。この OpenTelemetry Redis 実装を、quarkus-opentelemetry エクステンションの計装の下に配置する必要があります。

トレーシングデータには、他の属性のほか、要求ステートメント、データベースインスタンス、ピアアドレスなどが含まれます。ステータスコードとメッセージはエラースパンで使用できます。

詳細は、Quarkus の Quarkus Redis クライアントの使用 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、アノテーションを使用して、Jakarta REST エンドポイントに固有の認証メカニズムを有効にできます。

REST エンドポイントが一致した後にのみアノテーションを使用して認証メカニズムを選択できるため、この機能はプロアクティブ認証が無効になっている場合、つまり quarkus.http.auth.proactive が false に設定されている場合にのみ有効になります。

詳細は、「Quarkus 認証メカニズム」ガイドの アノテーションを使用して Jakarta REST エンドポイントのパスベースの認証を有効にする セクションを参照してください。

Red Hat build of Quarkus 3.15 では、新しいアノテーション @ClientBasicAuth が導入され、Red Hat build of Quarkus REST クライアントで Basic 認証のユーザー名とパスワードを使用して HTTP 認証ヘッダーを設定する方法が簡素化されました。

HTTP Basic 認証を使用する場合、quarkus.rest.client.reactive.ClientBasicAuth アノテーションにより、必要な認証ヘッダーの設定が簡素化されます。

以下に例を示します。

@ClientBasicAuth(username = "${service.username}", password = "${service.password}")
public interface SomeClient {
}

@ClientBasicAuth(username = "${service.username}", password = "${service.password}")
public interface SomeClient {
}

この例では、service.username と service.password は、実行時に適切なユーザー名とパスワードを設定してターゲットサービスへのアクセスを許可する設定プロパティーです。

詳細は、Quarkus の REST クライアントの使用 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、アクセストークンの発行者を使用して、ベアラートークン認証をサポートする静的 OpenID Connect (OIDC) テナントを解決できます。

この発行者ベースの解決が機能するように、次の条件を満たしていることを確認してください。

quarkus.oidc.resolve-tenants-with-issuer プロパティーを使用してトークン発行者を有効にする必要があります。

詳細は、Quarkus の OIDC マルチテナントの使用 ガイドを参照してください。

ユーザーが認証のために OpenID Connect (OIDC) プロバイダーにリダイレクトされる場合、認証が完了したときにユーザーをどこに誘導するかをリダイレクトでプロバイダーに示す必要があります。

Red Hat build of Quarkus 3.15 では、OIDC リダイレクトをフィルタリングするための OpenID Connect (OIDC) リダイレクトフィルターが導入されています。1 つ以上の io.quarkus.oidc.OidcRedirectFilter 実装を登録して、OIDC 認可およびログアウトエンドポイントへの OIDC リダイレクトをフィルターし、カスタムエラーおよびセッション期限切れページへのローカルリダイレクトをフィルターできます。

OidcRedirectFilter を使用すると、追加のクエリーパラメーターや応答ヘッダーを追加したり、すべてのリダイレクト要求に対して新しい Cookie を設定したりすることもできます。

詳細は、Quarkus の「OIDC 認可コードフローメカニズム」ガイドの OIDC リダイレクトフィルター のセクションを参照してください。

以前は、ユーザーセッションを更新できない場合、現在認証されているユーザーは OpenID Connect (OIDC) プロバイダーにリダイレクトされ、再認証が行われていました。ただし、再認証が必要な理由がユーザーには明らかでない可能性があります。

Red Hat build of Quarkus 3.15 では、ユーザーをパブリックのアプリケーション固有のセッションの期限切れページにリダイレクトするように設定できるようになりました。このページでは、セッションの有効期限が切れたことをユーザーに知らせ、保護されたアプリケーションの Welcome ページへのリンクに従って再認証するようにアドバイスします。

このページを有効にするには、quarkus.oidc.authentication.session-expired-page 相対パスプロパティーを指定します。

詳細は、Quarkus の OIDC 認可コードフローメカニズム ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、OpenID Connect (OIDC) TokenCertificateValidator アノテーションの導入によりセキュリティーが強化されています。このアノテーションを使用すると、デフォルトのチェーン検証に加えて、トークンの証明書チェーンにカスタム証明書チェーン検証チェックを追加できます。

詳細は、Quarkus の OIDC ベアラートークン認証 ガイドを参照してください。

Red Hat build of Quarkus 3.15 では、セキュリティーコンテキストが利用可能な場合、スパン内のセキュリティーイベントを OpenTelemetry (OTel) イベントとしてエクスポートできます。この機能は、スパン属性にユーザー ID とロールを追加します。

この機能を有効にするには、application.properties ファイルで次の設定プロパティーを true に設定します。

quarkus.otel.security-events.enabled=true

詳細は、次の Quarkus リソースを参照してください。

OpenID Connect (OIDC) 認可中に、ID トークンが現在認証されているユーザーに関する十分な情報を提供しない場合は、UserInfo エンドポイントから JSON 形式で詳細情報を取得できます。

Red Hat build of Quarkus 3.15 では、署名された JSON Web Token (JWT) として返される UserInfo がサポートされています。Red Hat build of Quarkus はこの署名された JWT トークンを検証し、その後、UserInfo は保護された JSON データで初期化されます。

Red Hat build of Quarkus 3.15 では、次の機能を含む新しい Transport Layer Security (TLS) レジストリーエクステンション quarkus-tls-registry が導入されました。

詳細は、Quarkus TLS レジストリーリファレンス ガイドを参照してください。

Quarkus REST クライアントを使用する場合、サーバーに送信されたリクエストを調べる必要がある場合があります。HTTPS 接続を処理する場合、トラフィックを検査する最も簡単な方法は、パススループロキシーを使用することです。

Red Hat build of Quarkus 3.15 では、REST クライアント用の HTTP パススループロキシーを追加できます。このプロキシーを Wireshark のターゲットとして使用して、REST クライアントが送信するリクエストの内容を取得できます。

プロキシーを有効にするには、quarkus.rest-client.<client name>.enable-local-proxy プロパティーを true に設定します。

Red Hat build of Quarkus 3.15 では、Vert.x HTTP が強化されています。これで、HTTP サーバーの起動時にカスタムアクションを実行できるようになりました。

これを行うには、非同期コンテキストと依存性の注入 (CDI) オブザーバーメソッドを宣言します。次に、対応する HTTP サーバーが設定されたホストとポートでリッスンを開始すると、Red Hat build of Quarkus は次の CDI イベントを起動します。

詳細は、Quarkus の HTTP リファレンス ガイドを参照してください。

Red Hat は、Quarkus CLI、Maven および Gradle プラグインなどの Quarkus 開発ツールを使用して、Red Hat build of Quarkus アプリケーションのプロトタイプを作成、開発、テスト、デプロイするための 開発サポート を提供します。

Red Hat は、実稼働環境での Quarkus 開発ツールの使用をサポートしていません。詳細は、Red Hat ナレッジベースの記事 Development Support Scope of Coverage を参照してください。

Red Hat build of Quarkus 3.15 では、最新の Spring Boot 3 API 更新に合わせて quarkus-spring-data-rest-extension がアップグレードされました。

コード内で PagingAndSortingRepository インターフェイスを使用している場合、このアップグレードによって重大な変更が発生する可能性があります。以前は、PagingAndSortingRepository は CrudRepository を拡張し、カスタムリポジトリーが CrudRepository からメソッドを継承できるようにしていました。

この変更に関連する問題を解決するには、カスタムリポジトリーを更新して、ListCrudRepository または CrudRepository のいずれかを直接拡張する必要があります。この調整により、必要なメソッドへの継続的なアクセスが確保され、更新されたアーキテクチャーとの互換性が維持されます。

Red Hat build of Quarkus 3.15 では、Dev Services を起動するかどうかを決定する方法が変更されました。

以前は、Dev Services を起動するかを決定するために、Red Hat build of Quarkus は、設定プロパティーが拡張せずに定義されているかをチェックしていました。ただし、この方法では、プロパティーが空の値に展開された場合に問題が発生しました。

現在、Red Hat build of Quarkus は、展開されたプロパティーが空かどうかを最初にチェックします。この変更により、展開されたプロパティーが空になった場合に、以前は起動しなかった Dev Services が予期せず起動する可能性があります。ほとんどの Dev Services は、JDBC URL などの特定のプロパティーが提供されていないときに開始されます。

この変更により、展開されたプロパティーが空にならないように、設定プロパティーを調整してデフォルト値を含める必要があります。

たとえば、quarkus-test-oidc-server コンポーネントを使用して OpenID Connect (OIDC) サーバーをモックし、application.properties ファイルに次の内容が含まれている場合:

%test.quarkus.oidc.auth-server-url=${keycloak.url}/realms/quarkus/

%test.quarkus.oidc.auth-server-url=${keycloak.url}/realms/quarkus/

プロパティー値を次のように変更します。

%test.quarkus.oidc.auth-server-url=${keycloak.url:replaced-by-test-resource}/realms/quarkus/

%test.quarkus.oidc.auth-server-url=${keycloak.url:replaced-by-test-resource}/realms/quarkus/

このように、keycloak.url が定義されていない場合、デフォルトの replaced-by-test-resource 値により、プロパティーが空の値に拡張されることが防止され、Dev Services が意図せず起動することが回避されます。式で変数が定義されていない場合、式全体が空になります。

Red Hat build of Quarkus 3.15 では、GraalVM SDK の依存関係がバージョン 23.1.2 に更新され、以前の見落としが修正され、最新の GraalVM 機能との互換性が確保されています。

GraalVM の代替を使用してエクステンションを開発する場合は、org.graalvm.sdk:graal-sdk 依存関係を org.graalvm.sdk:nativeimage に置き換えます。nativeimage アーティファクトには置換に必要なクラスのみが含まれるため、より合理化されます。

この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

Red Hat build of Quarkus 3.15 では、Infinispan 15 コンポーネントがバージョン 15.0 にアップグレードされます。

以前のリリースでは、Infinispan 15 インテグレーションより前は、次の .Query.java コードを使用してクエリーを実行していました。

@Inject
RemoteCache<String, Book> booksCache;

…

QueryFactory queryFactory = Search.getQueryFactory(booksCache);
Query query = queryFactory.create("from book_sample.Book");
List<Book> list = query.execute().list();

@Inject
RemoteCache<String, Book> booksCache;

…

QueryFactory queryFactory = Search.getQueryFactory(booksCache);
Query query = queryFactory.create("from book_sample.Book");
List<Book> list = query.execute().list();

ただし、このリリースでは、RemoteCache が @ApplicationScoped プロキシー Bean になり、Search.getQueryFactory によって ClassCastException が発生するため、このコードは機能しなくなりました。

これを解決するには、次のように RemoteCache API の query メソッドを使用して間接参照を削除します。

@Inject
RemoteCache<String, Book> booksCache;

…

Query<Book> query = booksCache.<Book>query("from book_sample.Book");
List<Book> list = query.execute().list();

@Inject
RemoteCache<String, Book> booksCache;

…

Query<Book> query = booksCache.<Book>query("from book_sample.Book");
List<Book> list = query.execute().list();

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、次のパッケージ関連のプロパティーが改名または変更されました。設定で元のプロパティーを使用した場合、それらは引き続き機能しますが、警告が表示されます。

この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

これらの変更を反映し、ビルドプロセス中の警告メッセージを停止するために、コードファイルと設定ファイルを更新します。

Red Hat build of Quarkus 3.15 では、ProfileManager が複数のプロファイルを処理しなかったため、非推奨の ProfileManager クラスと ProfileManager#getActiveProfile メソッドが削除されました。

この削除により、次の設定変更が必要になります。

アクティブなプロファイルを取得するには、io.quarkus.runtime.configuration.ConfigUtils#getProfiles API を使用します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

以前のリリースでは、生成されるアーティファクトの種類に関係なく、ビルドシステムの出力ディレクトリーに quarkus-app ディレクトリーが常に生成されるという意図しない動作が確認されました。

Red Hat build of Quarkus 3.15 では、ビルドプロセスによって、デフォルトのアーティファクトタイプである fast-jar パッケージに対してのみ quarkus-app ディレクトリーが作成されます。別のアーティファクトタイプ用にビルドを設定すると、quarkus-app ディレクトリーは作成されません。

Red Hat build of Quarkus 3.15 では、ランタイムファイルと設定ドキュメントの生成に使用されるエクステンションアノテーションプロセッサーが再開発され、柔軟性が向上しましたが、新しい制約が追加されました。

新しい @ConfigMapping インターフェイスへの移行が推奨されますが、スムーズな移行を確実にするために、従来の @ConfigRoot クラスのサポートもしばらく継続される予定です。非推奨化の予定は、後日発表される予定です。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Hibernate ORM エクステンションは、実行時に接続するデータベースバージョンが、ビルド時に設定されたバージョン以上であることを確認します。この検証は、設定が Red Hat build of Quarkus でサポートされている最小データベースバージョンをターゲットとするデフォルト設定に依存している場合でも実行されます。

この更新の目的は、Hibernate ORM または Red Hat build of Quarkus がサポートしなくなったデータベースバージョンを使用しようとした場合に、アプリケーション開発者に警告することです。サポートされなくなったデータベースバージョンを使用しようとすると、Red Hat build of Quarkus は起動せず、例外がスローされます。

この変更は、次のデータベースバージョンに依存するアプリケーションに影響します。

データベースをサポートされているバージョンにアップグレードできない場合でも、一部の機能が動作しない可能性がありますが、引き続き使用してみることはできます。以前のサポートされていないデータベースバージョンを引き続き使用するには、db-version を明示的に設定し、必要に応じて dialect も設定します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

詳細は、以下の資料を参照してください。

Red Hat build of Quarkus 3.15 では、いくつかの Dev Services のデフォルトイメージが次のバージョンに更新されました。

この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

これらのサービスの特定のバージョンまたはディストリビューションを使用するには、アプリケーションプロパティーでデフォルトのコンテナーイメージを手動でオーバーライドする必要があります。

詳細は、Quarkus の「Dev Services for Elasticsearch」ガイドの イメージの設定 セクションを参照してください。

Red Hat build of Quarkus 3.15 では、Hibernate Object/Relational Mapping (ORM) auto-flush 機能が最適化されています。

現在、デフォルトでは、Hibernate Query Language (HQL)、Java Persistence Query Language (JPQL)、またはネイティブクエリーを実行する前に、これらの変更がクエリー結果に影響を及ぼす可能性があることを検出した場合、Hibernate ORM は保留中の変更のみをデータベースにフラッシュします。

ほとんどの場合、この最適化により、バッチ処理の効率化など、アプリケーションのパフォーマンスが向上しますが、次の問題が発生する可能性があります。

以前の動作に戻して別のデフォルト値を選択する場合は、quarkus.hibernate-orm.flush.mode 設定プロパティーが導入されています。このプロパティーを always に設定します: quarkus.hibernate-orm.flush.mode=always。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

詳細は、以下の資料を参照してください。

Red Hat build of Quarkus 3.15 では、Hibernate ORM エクステンションが Hibernate ORM 6.6 にアップグレードされ、次の重大な変更が導入されました。

詳細は、以下の資料を参照してください。

quarkus-hibernate-search-orm-outbox-polling エクステンションは、Hibernate ORM が接続するデータベース内のシステムテーブルに依存しており、Red Hat build of Quarkus 3.15 では、これらのシステムテーブルのスキーマが変更される可能性があります。

このエクステンションを使用する場合は、データベーススキーマを移行する必要があります。データベーススキーマを移行する方法は、"Hibernate Search migration" ガイドの Outbox polling database tables セクションを参照してください。

データベーススキーマを更新できない場合は、次の設定を適用して以前のデフォルトを復元します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Hibernate ORM with Panache、Hibernate Reactive with Panache、または MongoDB with Panache を使用する場合、外部定義エンティティーに io.quarkus:quarkus-panache-common アノテーションプロセッサーが不要になったため、削除されました。

以前のリリースでは、このアノテーションプロセッサーはクラスパスで見つかったときに自動的に実行されていました。ビルドツールでアノテーションプロセッサーのセットをオーバーライドした場合は、明示的に追加する必要がありました。

アノテーションプロセッサーリストから io.quarkus:quarkus-panache-common へのすべての参照を削除します。

この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

<build>
    <plugins>
        <!-- other plugins -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.13.0</version> <!-- Necessary for proper dependency management in annotationProcessorPaths -->
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>io.quarkus</groupId>
                        <artifactId>quarkus-panache-common</artifactId>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
        <!-- other plugins -->
    </plugins>
</build>

<build>
    <plugins>
        <!-- other plugins -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.13.0</version> <!-- Necessary for proper dependency management in annotationProcessorPaths -->
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>io.quarkus</groupId>
                        <artifactId>quarkus-panache-common</artifactId>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
        <!-- other plugins -->
    </plugins>
</build>

dependencies {
    annotationProcessor "io.quarkus:quarkus-panache-common"
}

dependencies {
    annotationProcessor "io.quarkus:quarkus-panache-common"
}

Red Hat build of Quarkus 3.15 では、Quarkus メッセージングエクステンションの 同期メソッド の実行モードがデフォルトでワーカースレッドに設定されるようになりました。以前のバージョンでは、これらのメソッドは Vert.x イベントループ (I/O スレッド) で実行されていました。

たとえば、次の処理メソッドは、Vert.x I/O スレッドではなくワーカースレッドでデフォルトで呼び出されるようになりました。

package org.acme;

import org.eclipse.microprofile.reactive.messaging.Incoming;
import org.eclipse.microprofile.reactive.messaging.Outgoing;

@Incoming("source")
@Outgoing("sink")
public Result process(int payload) {
    return new Result(payload);
}

package org.acme;

import org.eclipse.microprofile.reactive.messaging.Incoming;
import org.eclipse.microprofile.reactive.messaging.Outgoing;

@Incoming("source")
@Outgoing("sink")
public Result process(int payload) {
    return new Result(payload);
}

以前の動作に戻すには、quarkus.messaging.blocking.signatures.execution.mode 設定プロパティーを使用できます。

可能な値は次のとおりです。

@Blocking および @NonBlocking アノテーションを使用して、メソッドごとに実行モードを調整することもできます。

package org.acme;

import io.smallrye.common.annotation.NonBlocking;
import org.eclipse.microprofile.reactive.messaging.Incoming;

@Incoming("source")
@NonBlocking
public void consume(int payload) {
    // called on I/O thread
}

package org.acme;

import io.smallrye.common.annotation.NonBlocking;
import org.eclipse.microprofile.reactive.messaging.Incoming;

@Incoming("source")
@NonBlocking
public void consume(int payload) {
    // called on I/O thread
}

メソッドに @NonBlocking アノテーションを付けることで、そのメソッドが Vert.x イベントループ (I/O スレッド) で呼び出されるようになります。

メッセージングメソッドを確認して、必要な実行モードで実行されることを確認し、必要に応じてコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarku 3.15 では、SmallRye Reactive Messaging エクステンションの名前が quarkus-messaging-* に変更され、リアクティブワークロードとブロッキングワークロードの両方をサポートしていることが反映されています。

Maven の再配置が実装されました。この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

プロジェクト内の古いエクステンション名のすべてのインスタンスを新しい名前に置き換えます。

設定ルートも quarkus.smallrye-reactive-messaging. から quarkus.messaging. に更新されました。必要に応じて、古い設定プロパティーに戻すための自動フォールバックメカニズムが用意されています。

これらの変更を反映するようにコードと設定を更新します。

Red Hat build of Quarkus 3.15 では、quarkus.opentelemetry.* namespace の下にあるすべての設定プロパティーが削除されました。

これらのプロパティーは非推奨となり、バージョン 3.2 および 3.8 では下位互換性のために維持されています。これらは 3.15 で削除されたため、アプリケーションを移行するには次の変更を行う必要があります。

これらの新しいプロパティーと値を使用するには、コードと設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、非推奨のアノテーション io.opentelemetry.extension.annotations.WithSpan が削除されました。新しい io.opentelemetry.instrumentation.annotations.WithSpan アノテーションを使用するようにコードを更新します。

この更新との互換性を確保するために、古いアノテーションに依存する設定またはコードを確認して変更してください。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、OpenTelemetry (OTel) SDK がバージョン 1.39.0 に、計装がバージョン 2.5.0 にアップグレードされました。このアップグレードでは、OpenTelemetry HTTP semantic convention stability migration で定義された新しい規則が適用されます。また、非推奨の標準の削除も完了します。これらの規約に依存するコードまたは設定を更新します。

さらに、オプトインがサポートされなくなったため、quarkus.otel.semconv-stability.opt-in システムプロパティーは削除されました。このプロパティーに依存するコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、OpenTelemetry (OTel) REST クライアントのスパン名に HTTP リクエストメソッドとパスの両方が含まれるようになりました (例: GET /hello)。以前の REST クライアントのスパン名には、HTTP メソッドのみが含まれていました。

REST クライアントスパンの特定の形式に依存するコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、使用するライブラリーの更新により、データベース操作によって生成されるスパン名が変更されました。

たとえば、この変更前は、データベーステーブルを作成するための古いスパン名は DB Query でした。この変更により、新しいスパン名は CREATE TABLE {table_name} になります。

この新しい命名規則により、実行される特定のデータベース操作を正確に反映する、より説明的で意味のあるスパン名が提供されます。

その結果、可観測性ツールでデータベース操作によって生成されたスパンに異なる名前が付けられていることに気付く場合があります。

新しい命名規則に対応するために、古いスパン名に依存するカスタムモニタリング設定、アラート、またはダッシュボードを確認して更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

データベーススパンの命名規則とベストプラクティスの詳細は、OpenTelemetry Database Span Semantic Conventions の仕様を参照してください。

以前のバージョンでは、一部の設定プロパティーが quarkus.health 設定ルートの下に誤って配置されていました。

Red Hat build of Quarkus 3.15 では、一貫性を保つために、これらのプロパティーは quarkus.smallrye-health 設定ルートに再配置されました。

Red Hat build of Quarkus 3.15 では、古い設定ルートを持つプロパティーは非推奨となり、今後のリリースで削除される予定です。新しいプロパティーのロケーションを使用するようにコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Java Keystroke (JKS) はデフォルトのキーストアおよびトラストストア形式ではなくなりました。

代わりに、Red Hat build of Quarkus は、次のようにファイル拡張子に基づいて形式を決定します。

ファイルでこれらの拡張子のいずれも使用していない場合は、ファイル形式を設定する必要があります。

たとえば、JKS 形式を指定するには、次の設定値を設定します。

Red Hat build of Quarkus 3.15 では、io.quarkus.oidc.UserInfo が REST エンドポイントに注入されると、quarkus.oidc.authentication.user-info-required プロパティーが自動的に true に設定されるようになりました。この変更により、UserInfo は通常、使用が意図されたときに注入されるため、このプロパティーを手動で設定する必要がなくなります。

ただし、複数の OIDC テナントがエンドポイントを保護し、一部のテナントが UserInfo をサポートしていない複雑なセットアップでは、この変更によりテナントの初期化が失敗する可能性があります。これは、UserInfo をサポートしていないテナントが UserInfo を取得するように設定されている場合にのみ発生し、そのテナントによって保護されたリクエストが失敗する可能性があります。

マルチテナントセットアップでこのような失敗を回避するには、UserInfo をサポートしていないテナントに対して、テナント固有の quarkus.oidc.<tenant-id>.authentication.user-info-required プロパティーを false に設定します。これにより、UserInfo をサポートするテナントのみがその取得を強制するようになります。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Quarkus BOM は org.junit-pioneer:junit-pioneer 依存関係のバージョンを強制しなくなりました。プロジェクトでこの依存関係を使用している場合は、ビルドファイルでそのバージョンを明示的に指定する必要があります。

ビルドの問題を回避するには、pom.xml または build.gradle ファイルでバージョンを定義します。次に例を示します。

<properties>
    ...
    <junit-pioneer.version>2.2.0</junit-pioneer.version>
    ...
</properties>

<properties>
    ...
    <junit-pioneer.version>2.2.0</junit-pioneer.version>
    ...
</properties>

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Quarkus REST (旧称 RESTEasy Reactive) の Hypertext Application Language (HAL) ラッパークラスのシグネチャーが変更され、コレクション内の要素の型が含まれるようになりました。

コード内で HAL ラッパークラスを使用する場所に適切な型引数を追加します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

@Path("/records")
public class RecordsResource {

    @Inject
    HalService halService;

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @RestLink(rel = "list")
    public HalCollectionWrapper<Record> getAll() {
        List<Record> list = // ...
        HalCollectionWrapper<Record> halCollection = halService.toHalCollectionWrapper( list, "collectionName", Record.class);
        // ...
        return halCollection;
    }

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @Path("/{id}")
    @RestLink(rel = "self")
    @InjectRestLinks(RestLinkType.INSTANCE)
    public HalEntityWrapper<Record> get(@PathParam("id") int id) {
        Record entity = // ...
        HalEntityWrapper<Record> halEntity = halService.toHalWrapper(entity);
        // ...
        return halEntity;
    }
}

@Path("/records")
public class RecordsResource {

    @Inject
    HalService halService;

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @RestLink(rel = "list")
    public HalCollectionWrapper<Record> getAll() {
        List<Record> list = // ...
        HalCollectionWrapper<Record> halCollection = halService.toHalCollectionWrapper( list, "collectionName", Record.class);
        // ...
        return halCollection;
    }

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @Path("/{id}")
    @RestLink(rel = "self")
    @InjectRestLinks(RestLinkType.INSTANCE)
    public HalEntityWrapper<Record> get(@PathParam("id") int id) {
        Record entity = // ...
        HalEntityWrapper<Record> halEntity = halService.toHalWrapper(entity);
        // ...
        return halEntity;
    }
}

コンストラクターを使用して HAL ラッパーを作成することは引き続き機能しますが、このアプローチは今後のバージョンでは非推奨になる可能性があります。したがって、HalService Bean によって公開されるヘルパーメソッドの使用を開始してください。

詳細は、「Quarkus REST」ガイドの Web リンクのサポート セクションを参照してください。

以前のリリースでは、要求されたリソースが REST リソースでない場合でも、Quarkus REST (旧称 RESTEasy Reactive) フィルターが実行されていました。Red Hat build of Quarkus 3.15 では、その動作が変更されました。現在、Quarkus REST フィルターは REST リソースでのみ実行されます。

フィルターを Quarkus 以外の REST リソースに適用する必要がある場合は、次の例に示すように、NotFoundException のカスタム ExceptionMapper を追加することで適用できます。

package io.quarkus.resteasy.reactive.server.test.customproviders;

import jakarta.ws.rs.NotFoundException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class NotFoundExeptionMapper implements ExceptionMapper<NotFoundException> {
    @Override
    public Response toResponse(NotFoundException exception) {
        return Response.status(404).build();
    }
}

package io.quarkus.resteasy.reactive.server.test.customproviders;

import jakarta.ws.rs.NotFoundException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class NotFoundExeptionMapper implements ExceptionMapper<NotFoundException> {
    @Override
    public Response toResponse(NotFoundException exception) {
        return Response.status(404).build();
    }
}

この ExceptionMapper を使用すると、Quarkus REST は "Not Found" リソースを処理し、フィルターが期待どおりに実行されるようになります。以前は、フィルターは常に非 REST リソースで実行されていたため、他のエクステンションが "Not Found" シナリオを効果的に処理することが困難でした。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、io.quarkus.qute.TemplateInstance クラスは非ブロッキング型として登録されなくなりました。その結果、Jakarta REST (旧称 JAX-RS) リソースメソッドが TemplateInstance オブジェクトを返す場合、デフォルトでブロッキングと見なされるようになりました。

以前の非ブロッキング動作を復元するには、リソースメソッドに @io.smallrye.common.annotation.NonBlocking アノテーションを適用します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、RESTEasy Reactive エクステンションの名前が quarkus-rest-* に変更され、リアクティブワークロードとブロッキングワークロードの両方をサポートしていることが反映されています。

Maven の再配置が実装されました。この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

プロジェクト内の古いエクステンション名のすべてのインスタンスを新しい名前に置き換えます。

新しいエクステンションの名前のほとんどは、次の命名規則に従います。

設定ルートも更新されました:

必要に応じて、古い設定プロパティーに戻すための自動フォールバックメカニズムが用意されています。

Red Hat build of Quarkus 3.15 では、quarkus-webjars-locator エクステンションの名前が quarkus-web-dependency-locator に変更され、mvnpm (Maven NPM) と importmaps も含まれるように強化されています。

新しいエクステンション名を使用するようにコードと設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

詳細は、Quarkus の Web 依存関係ロケーター ガイドを参照してください。