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

Quarkus のコミュニティーエクステンションハブである Quarkiverse が、Quarkus Chappie エクステンション (quarkus-chappie) を通じて、Dev Assistant を導入します。Dev Assistant は、開発モード中に AI を活用した支援を提供することで、例外のトラブルシューティング、テストコードの生成、TODO セクションの完了、複雑なコードの理解を支援します。この機能は、OpenAI 互換サービスまたはローカルの Ollama インスタンスと統合し、Dev UI から設定されます。実稼働アプリケーションのオーバーヘッドを増やすことはありません。

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

今回のリリースでは、同じ永続性ユニット内で Hibernate ORM と Hibernate Reactive を一緒に使用できます。

この機能により、アプリケーションはブロッキングとリアクティブの永続性を組み合わせることができ、混合ワークロードや、命令型コードと並行したリアクティブ機能の一部導入が可能になります。

詳細は、GitHub Pull Request #44473 を参照してください。

現在のリリースでは、Red Hat build of Quarkus に、Hibernate ORM エクステンション quarkus-hibernate-orm を通じて Jakarta Data 統合が導入されています。

Jakarta EE 11 仕様の Jakarta Data API は、Java アプリケーションでデータベースやその他のデータソースにアクセスして操作する方法を簡素化します。リポジトリーを定義する標準化された方法と、型安全な方法でクエリーを構築する機能を提供します。

Jakarta Data では、pom.xml ファイルに別のランタイム依存関係を追加する必要があります。

今回のリリースでは、Hibernate ORM はデータベース接続を必要とせずにオフラインで起動できます。Hibernate は、データベースのダイアレクトとバージョンに適切なデフォルトを指定します。ターゲットデータベースが共通のデフォルトと異なる場合は、ダイアレクト、バージョン、および ダイアレクト固有 の設定を行えます。

起動時に接続は開かれません。アプリケーションを起動する前にデータベーススキーマが正しく作成されていることを確認してください。データの永続性を確保したりクエリーを実行したりするには、実行時にライブデータベース接続が必要です。

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

Hibernate ORM は標準の Jakarta Persistence 実装であり、現在のリリースでは、Hibernate ORM は Jakarta Persistence バージョン 3.2 とともにバージョン 7.1 にアップグレードされています。

Hibernate ORM 7 リリースシリーズへのアップグレードでは、多くの新機能と拡張機能が導入されています。

変更点の完全なリストについては、次の Hibernate 移行ドキュメントを参照してください。

このアップグレードにより、Red Hat build of Quarkus に重大な変更が導入されます。

重大な変更点については、Hibernate ORM: バージョン 7.1 へのアップグレード リリースノートを参照してください。

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

現在のリリースでは、名前付き永続ユニットとデータソースが Hibernate Reactive で提供されます。

この機能は テクノロジープレビュー として利用できます。

この機能により Hibernate Reactive は Hibernate ORM と連携し、開発者はリアクティブアプリケーションで複数の永続性ユニットまたはデータソースを定義して使用できるようになります。

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

現在のリリースでは、Hibernate Reactive がバージョン 3.1 にアップグレードされました。

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

現在のリリースでは、Hibernate Search がバージョン 8.1 にアップグレードされました。

8.x シリーズへのアップグレードでは、Hibernate Search DSL の改善や、メトリクス集計の計算を簡素化し、バケット集計を作成するのに役立つ集計など、いくつかの新機能が導入されています。

Hibernate Search 8.1 はバージョン 7.2 と互換性があります。

Hibernate Search 8.1 の機能と拡張機能の詳細は、次の Hibernate ドキュメントを参照してください。

今回のリリースでは、Hibernate Validator と Hibernate Reactive の統合が拡張されました。この機能によりエンティティーの検証が可能になり、Hibernate Reactive のデータベーススキーマが強化されました。

たとえば、エンティティー属性の @NotNull アノテーションにより、対応する列定義に not null 句が生成されます。この動作により、Hibernate ORM との一貫性が確保され、リアクティブアプリケーション全体のデータ整合性が向上します。

制約宣言では、XML (validation.xml) で定義された制約マッピングが適用されます。Quarkus では、XML を介した ValidatorFactory の設定はサポートされていません。

この機能は テクノロジープレビュー として利用できます。したがって、いくつかの制限が適用されます。たとえば、遅延関連付け全体の検証は適切に機能しない可能性があります。

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

現在のリリースでは、Hibernate Validator はバージョン 9.0 にアップグレードされています。

Hibernate Validator 9.0 では、非推奨の制約とプロパティーが多数削除されました。これらの削除の詳細は、Hibernate Validator 9.0 移行 ガイドを参照してください。

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

今回のリリースでは、Quarkus TLS レジストリーを使用して MongoDB クライアント (quarkus-mongodb-client) 接続を設定できます。

# Configure MongoDB connection
quarkus.mongodb.connection-string=mongodb://localhost:27017?tls=true

# Define a named TLS configuration for MongoDB
quarkus.tls.my-mongo.trust-store.pem.certs=server-cert.pem
quarkus.tls.my-mongo.key-store.pem.0.key=client-key.pem
quarkus.tls.my-mongo.key-store.pem.0.cert=client-cert.pem

# Reference the named configuration in MongoDB client
quarkus.mongodb.tls-configuration-name=my-mongo

# Reuse the same TLS configuration for additional MongoDB connections
# quarkus.mongodb.db2.tls-configuration-name=my-mongo
# quarkus.mongodb.db3.tls-configuration-name=my-mongo

quarkus.tls.my-mongo.hostname-verification-algorithm=NONE 

quarkus.mongodb.tls-configuration-name=my-mongo 

詳細は、Quarkus の「MongoDB クライアントの使用」ガイドの TLS 設定 セクションを参照してください。

今回のリリースでは、gRPC エクステンションにより、gRPC サーバーのビルドプロセスのカスタマイズが導入されました。

この機能により、実行時の ServerBuilder インスタンスまたはサーバーオプションのチューニングなど、高度なシナリオが可能になります。

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

Red Hat build of Quarkus 3.27 では、Micrometer-OpenTelemetry Bridge (quarkus-micrometer-opentelemetry) エクステンションが導入され、Red Hat build of Quarkus アプリケーションで OpenTelemetry API を使用して実装された Micrometer レジストリーを作成できるようになりました。

この機能は テクノロジープレビュー として利用できます。

quarkus-micrometer-opentelemetry エクステンションは、quarkus-opentelemetry と quarkus-micrometer の両方の機能を組み込むことで統合を効率化し、Micrometer API の通常使用を可能にしながら、OpenTelemetry を通じてメトリクスを処理します。

この新しいエクステンションにより、Micrometer メトリクス、OpenTelemetry トレース、ログ、OpenTelemetry メトリクスをデフォルトで生成できるようになりました。

詳細は、Quarkus の Micrometer and OpenTelemetry extension ガイドを参照してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

今回のリリースでは、OpenID Connect (OIDC) クライアント (quarkus-oidc-client) エクステンションを設定して、トークンをバックグラウンドで非同期的に更新し、重要なアプリケーションのパフォーマンスを高めることができます。

デフォルトでは、OIDC クライアントは有効期限が切れた、または切れそうなことを検出すると、現在のリクエスト中にトークンを更新します。これにより、高スループットのアプリケーションでパフォーマンスのボトルネックが発生する可能性があります。新しい非同期更新機能は、トークンの有効期限が切れる前にバックグラウンドでトークンをプロアクティブに更新し、トークン更新操作によって受信リクエストがブロックされることを防ぎます。これは、レイテンシー要件が厳しいアプリケーションやリクエスト量が多いアプリケーションに特に役立ちます。

# Configure OIDC client connection
quarkus.oidc-client.auth-server-url=https://auth.example.com/realms/myrealm
quarkus.oidc-client.client-id=my-client
quarkus.oidc-client.credentials.secret=my-secret

# Enable periodic asynchronous token refresh
quarkus.oidc-client.refresh-interval=1m 

# Optional: Configure refresh token time skew
quarkus.oidc-client.refresh-token-time-skew=30s 

詳細は、「OpenID Connect (OIDC) クライアントおよびトークン伝播」ガイドの アクセストークンの更新 セクションを参照してください。

今回のリリースでは、OIDC エクステンションにより、ログアウト時に Clear-Site-Data HTTP レスポンスヘッダーを設定する機能が追加されました。

このヘッダーは、ユーザーがログアウトしたときに、Cookie、キャッシュ、ストレージなどのローカルデータを消去するようにブラウザーに指示し、エンドユーザーのセキュリティーとプライバシーを向上させます。

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

現在のリリースでは、Quarkus OpenID Connect (quarkus-oidc) エクステンションでヘルスレディネスチェックがサポートされるようになりました。この機能を使用すると、リクエストを処理する前に、アプリケーションが OIDC サーバーに接続できることを確認します。

OIDC ヘルスチェックを有効にするには、以下を実行します。

ヘルスチェックはデフォルトで無効になっています。有効にすると、設定された各 OIDC テナントの検出エンドポイントに ping が送信されます。少なくとも 1 つのテナントが OK ステータスを報告した場合、チェックは UP を返します。利用可能なテナントがないか、すべてのテナントが OK 以外のステータス (DISABLED、UNKNOWN、ERROR) を報告した場合は DOWN を返します。

詳細は、「Quarkus OpenId Connect (OIDC) Expanded Configuration Reference」ガイドの Create OIDC configuration at request time セクションを参照してください。

今回のリリースでは、REST Client - OpenID Connect Filter (quarkus-rest-client-oidc-filter) および RESTEasy Client - OpenID Connect Filter (quarkus-resteasy-client-oidc-filter) エクステンションが、REST クライアントリクエストが "401 Unauthorized" レスポンスを受け取ったときに自動的にトークンを更新する機能をサポートしています。この機能を使用すると、手動による介入なしに、期限切れまたは取り消し済みアクセストークンを処理できます。

自動トークン更新をグローバルで有効にするには、エクステンションに一致するプロパティーを設定します。

quarkus.rest-client-oidc-filter.refresh-on-unauthorized=true
quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized=true

特定のクライアントエンドポイントのトークン更新を有効にするには、カスタムフィルターを作成します。

この機能は、同期 REST クライアントとリアクティブ REST クライアントの両方で動作します。リクエストが 401 を返すと、フィルターはアクセストークンを自動的に更新し、リクエストを再試行します。

詳細は、「OpenID Connect (OIDC) クライアントとトークンの伝播」ガイドの RestClient Reactive ClientFilter での OidcClient の使用 および RestClient ClientFilter での OidcClient の使用 セクションを参照してください。

今回のリリースでは、Quarkus OIDC (quarkus-oidc) エクステンションを使用して、保護対象のリソースを設定し、既知のエンドポイントを介して OAuth2 Protected Resource Metadata (RFC 9728) をアドバタイズできます。このエンドポイントは、リソース識別子を返すほか、それを保護する認可サーバーを含むメタデータを必要に応じて返します。このメタデータを使用すると、手動設定不要で、クライアントが認証要件を自動的に検出できるようになります。

この機能を有効にするには、次のプロパティーを設定します。

quarkus.oidc.resource-metadata.enabled=true

詳細は、「Quarkus OpenId Connect (OIDC) Expanded Configuration Reference」ガイドの Protected Resource Metadata セクションを参照してください。

今回のリリースでは、Quarkus OIDC エクステンション (quarkus-oidc) が、OIDC フィルター内のリクエストボディーとレスポンスボディーのカスタマイズをサポートしています。この機能を使用すると、OIDC 認証およびトークン交換データを変更できます。

OIDC リクエストまたはレスポンスをカスタマイズするには、以下を実行します。

以下に例を示します。

@OidcEndpoint(value = Type.TOKEN)
public class TokenRequestFilter implements OidcRequestFilter {
    @Override
    public void filter(OidcRequestContext rc) {
        rc.requestBody(Buffer.buffer(rc.requestBody().toString() +
            "&custom_param=custom_value"));
    }
}

OIDC フィルターを使用すると、カスタムパラメーターの追加、ヘッダーの変更、レスポンス形式の変換、検証ロジックの実装が可能になります。

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

今回のリリースでは、Quarkus VertX HTTP (quarkus-vertx-http) エクステンションを使用することで、Fluent API を使用してプログラムによってパス固有の認可を設定できます。この API は、io.quarkus.vertx.http.security.HttpSecurity CDI イベントを使用し、設定プロパティーの代替としてより柔軟な手段を提供します。

この機能は テクノロジープレビュー として利用できます。

以前は、開発者はパス固有の認可を設定するには設定プロパティーを使用する必要がありました。これは詳細すぎて、複雑なアプリケーションでは管理が困難になる可能性がありました。新しい Fluent API を使用すると、Java コードで直接認可ルールを定義できるため、セキュリティー設定の保守性が向上し、より動的になります。このアプローチは、認可要件が複雑なアプリケーションや、実行時の条件に基づいて権限を設定する必要があるアプリケーションに特に役立ちます。

package org.acme.http.security;

import io.quarkus.vertx.http.security.HttpSecurity;
import jakarta.enterprise.event.Observes;

public class HttpSecurityConfiguration {

    void configure(@Observes HttpSecurity httpSecurity) {
        httpSecurity
                .get("/public/*").permit() 

                .path("/roles-secured/*", "/other/*", "/api/*").roles("admin", "user") 

                .path("/forbidden").authorization().deny(); 

    }
}

さらに、Fluent API では、さまざまなパスに対して特定の認証メカニズムとカスタムセキュリティーポリシーを設定できます。Basic 認証、ベアラートークン、認可コードフローなどの認証方法を、ロールベースのアクセス制御や権限チェックカスタム認可ポリシーと組み合わせることができます。

詳細は、「Web エンドポイントの認可」ガイドの パス固有の認可をプログラムでセットアップする セクションを参照してください。

今回のリリースでは、Dev UI に基本的なワークスペース機能が導入されています。

開発モードでは、Dev UI でプロジェクトのソースファイルを直接参照および編集できます。

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

今回のリリースでは、Dev Services に Compose のサポートが追加されています。

この機能により、開発者は Docker または Podman で Compose 記述を使用して Dev Services 用カスタムコンテナーの定義およびオーケストレーションを行うことができ、Dev Services フレームワークによってサービスの起動、設定、ライフサイクルが自動的に管理されます。

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

今回のリリースでは、Quarkus のテストクラスの読み込みインフラストラクチャーが改善されます。この機能拡張により、さまざまな環境でのテスト実行の信頼性と一貫性が向上します。

詳細は、GitHub Pull Request #34681 を参照してください。

現在のリリースでは、SmallRye GraphQL は Java 仮想スレッドでの操作の実行をサポートしています。ブロッキング操作に @RunOnVirtualThread のアノテーションを付け、プラットフォームスレッドを管理せずに仮想スレッドで実行します。ブロッキング操作には @RunOnVirtualThread を使用し、@Blocking または @NonBlocking と組み合わせないようにしてください。仮想スレッドは、コードのシンプルに保ち、ワーカースレッドと比較して同時実行性を高めることができます。リアクティブモデルは、最もリソース効率が高く、非常に高い同時実行性を確保します。

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

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

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

今回のリリースでは、QuarkusTransaction.isActive() メソッドが非推奨になりました。

このメソッドの動作は曖昧であり、トランザクションの状態を確実に示すものではありません。

現在のトランザクションステータスを確認するには、getStatus() メソッドを使用してください。正常な動作を確保するために、既存の isActive() の使用をすべて getStatus() に更新してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

今回のリリースでは、Quarkus はレガシー設定クラスのサポートを削除しました。レガシー設定クラスに基づいてビルドされたカスタムエクステンションを含め、エクステンションに依存するアプリケーションは、ビルドに失敗します。

影響を受けるエクステンションは、@io.smallrye.config.ConfigMapping を使用するバージョンに更新してください。または、カスタムエクステンションをそれに合わせて移行してください。

たとえば、互換性クラス GlobalDevServicesConfig は DevServicesConfig に置き換えます。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

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

今回のリリースでは、設定内の機能トグルが .enable ではなく .enabled 接尾辞を使用します。この変更により、設定プロパティー間の一貫性が向上し、接尾辞の混在が防止されます。古い .enable プロパティーは下位互換性のために引き続き認識されますが、非推奨です。

設定を自動的に移行するには、quarkus update を実行してください。手動で更新する場合は、非推奨の警告を回避するために、quarkus.log.console.enable などのキーの名前を quarkus.log.console.enabled に変更してください。名前付きログハンドラーも同じルールに従い、quarkus.log.handler.*."handler-name".enabled を使用します。

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

詳細は、Quarkus の Migration guide 3.26: `.enable` to `.enabled` in configuration properties を参照してください。

今回のリリースでは、org.eclipse.jgit 依存関係が quarkus-bom で管理されなくなりました。

現在、アプリケーションが JGit に依存している場合は、ネイティブイメージの互換性を確保し、互換性のあるライブラリーバージョンを使用するために、依存関係に quarkus-jgit エクステンションを追加してください。

quarkus-jgit エクステンションは Red Hat build of Quarkus ではサポートされていません。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

今回のリリースでは、ビルドモードに関係なく、JsonRPCProvidersBuildItem を生成する必要があります。

以前は、ほとんどのエクステンションが @BuildStep(onlyIf = IsDevelopment.class) を使用して、開発モードでのみこのビルド項目を生成していました。

現在は、JSON-RPC クラスで実行モデルの検証を有効にするために、ビルド時にビルドプロセスでこの項目が必要になります。

ビルドプロセスでは、この項目を使用して JSON-RPC エンドポイント、特に @Blocking、@NonBlocking、@RunOnVirtualThread などのアノテーションを使用するクラスを識別します。

Quarkus は以前 JSON-RPC クラス用のフォールバック検出メカニズムを提供していました。今回のリリースではこのメカニズムは削除されています。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22: extensions must produce JsonRPCProvidersBuildItem always を参照してください。

今回のリリースでは、Stork が REST クライアントの組み込み依存関係ではなくなりました。

現在は、REST クライアントで Stork を使用するには、プロジェクトの依存関係に quarkus-stork エクステンションを追加する必要があります。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

互換性に影響する変更: 今回のリリースでは、長い間非推奨となっていた quarkus.test.native-image-profile 設定プロパティーが削除されました。削除されたプロパティーをまだ使用している設定がある場合は、代わりに最新の quarkus.test.integration-test-profile プロパティーを使用するようにその設定を更新してください。

quarkus.test.integration-test-profile プロパティーは、@QuarkusIntegrationTest を使用してテストを実行するときに使用する設定プロファイルを指定します。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

現在のリリースでは、Apache Derby データベースのサポートは Red Hat build of Quarkus から削除されました。

Apache Derby は以前のリリースで非推奨となり、現在は完全に削除されました。Derby を使用するアプリケーションは、サポートされる構成 に記載されている別のデータベース、PostgreSQL、MySQL、MariaDB などのサポート対象のデータベースに移行する必要があります。

アプリケーションが現在 Derby を使用している場合は、以下が必要になります。

Red Hat build of Quarkus でのデータソースの設定に関する詳細は、データソースの設定 を参照してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

今回のリリースでは、以下の Dev Services のデフォルトイメージが以下のバージョンに更新されました。

互換性に影響する変更: アプリケーションでこれらのイメージの特定のバージョンが必要な場合は、コンテナーイメージを明示的に設定する必要があります。以下に例を示します。

quarkus.elasticsearch.devservices.image-name=docker.io/elastic/elasticsearch:9.1.3

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の「Dev Services for Elasticsearch」ガイドの Configuring the image セクションを参照してください。

今回のリリースでは、Hibernate ORM によってデータベースのバージョンチェックが改善されています。

このチェックは以前のリリースでもすでに適用されていました。この更新により、バージョン検出の精度が向上し、起動時に実行されるチェックの範囲が拡大されました。

アプリケーションの起動時にバージョンチェックに失敗した場合は、ダイアレクトに合わせて正しいデータベースバージョンを設定するか、データベースをサポートされているバージョンにアップグレードしてください。

CockroachDialect を使用する場合は、アプリケーションが接続するサーバーに合わせて (PostgreSQL バージョンではなく) CockroachDB バージョンを設定します。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.25 を参照してください。

現在のリリースでは、YAML 設定を簡素化し、今後の変更に備えるために、次の Hibernate ORM (quarkus-hibernate-orm) エクステンションプロパティーの名前が変更されました。

古いプロパティーは現在のリリースでは認識されたままですが、非推奨となっており、今後のリリースでは削除される予定です。

現在のリリースにアップグレードするときに、新しいプロパティーを使用します。

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

現在のリリースでは、Hibernate ORM がバージョン 7.1 にアップグレードされました。このアップグレードでは、アプリケーションに影響を及ぼす可能性のある重大な変更が導入されます。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

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

今回のリリースでは、Hibernate Reactive が起動時にデータベースのバージョンを検証します。

この変更により、サポートされているデータベースとの互換性が確保され、サポートされていないバージョンや互換性のないバージョンに対してアプリケーションが実行されることが防止されます。

アプリケーションが Hibernate Reactive の要件を満たさないデータベースバージョンに接続すると、起動が失敗し、明確なエラーメッセージが表示されます。

この問題を解決するには、データベースをサポートされているバージョンにアップグレードするか、状況に合わせて設定を調整してください。

詳細は、Quarkus の Migration guide 3.25 を参照してください。

現在のリリースでは、Hibernate Reactive がバージョン 3.1 にアップグレードされました。

Hibernate Reactive 3.1 は、ほとんどのアプリケーションで 3.0 との互換性を維持していますが、Hibernate ORM にに加えられた重大な変更を引き継いでおり、影響が生じる場合があります。

Hibernate ORM の重大な変更の詳細は、Hibernate ORM: バージョン 7.1 へのアップグレード リリースノートを参照してください。

次の Hibernate Reactive の重大な変更も導入されています。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

現在のリリースでは、Hibernate Search がバージョン 8.1 にアップグレードされました。

8.x バージョンシリーズへのアップグレードにより、アプリケーションに影響を及ぼす可能性のある重大な変更が導入されます。

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

現在のリリースでは、quarkus-kafka-client エクステンションで使用される Apache Kafka クライアントアーティファクト kafka-clients がバージョン 4.0.0 にアップグレードされました。

このバージョンでは、次の変更が導入されています。

Apache Kafka 3.x ブローカーには引き続き接続できます。削除されたプロトコルバージョンに依存する古いブローカーは互換性がない可能性があります。

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

現在のリリースでは、quarkus-opentelemetry エクステンションによって提供される OpenTelemetry メトリクスが変更されました。

次の表に、現在利用可能な OpenTelemetry メトリクスを示します。jvm.system.cpu.utilization メトリクスは JVM モードでは削除されました。代わりに jvm.cpu.recent_utilization を使用してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

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

今回のリリースでは、非推奨のブロッキングメソッド HttpAuthenticationMechanism.getCredentialTransport() が削除されました。

アプリケーションまたはカスタムのセキュリティーエクステンションがこのメソッドをオーバーライドする場合は、コンパイルエラーを回避するために実装を更新する必要があります。

次の例のように、リアクティブバージョンを実装して、削除されたメソッドを置き換えてください。

Uni<HttpCredentialTransport> getCredentialTransport(RoutingContext context) {
    return Uni.createFrom().item(myHttpCredentialTransport);
}

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

今回のリリースでは、runtime モジュールと spi モジュール間でパッケージが分割されないように、TLS レジストリーエクステンション (quarkus-tls-registry) が再構築されました。

この再編成の一環として、io.quarkus.tls.TlsRegistryBuildItem クラスの名前が io.quarkus.tls.deployment.spi.TlsRegistryBuildItem に変更されました。ただし、まだ spi モジュール内にあります。

以前の TlsRegistryBuildItem クラスの場所を参照する既存のコードがある場合は、現在のパッケージを使用するようにインポートを更新します。

// Earlier import
import io.quarkus.tls.TlsRegistryBuildItem;

// Current import
import io.quarkus.tls.deployment.spi.TlsRegistryBuildItem;

この変更は、デプロイメントとランタイムコンポーネントをより明確に分離するために Quarkus プロジェクトで提案されているアーキテクチャーの改善と方向性が一致しています。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

互換性に影響する変更: レガシー設定クラスと -AlegacyConfigRoot=true アノテーションプロセッサーオプションを使用したエクステンションのビルドのサポートが削除されました。

エクステンションでは、@ConfigMapping および @ConfigRoot でアノテーションが付けられた設定インターフェイスを使用する必要があります。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

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

今回のリリースでは、Gradle タスクの testNative と quarkusIntTest が test タスクに依存しなくなりました。

これらのタスクは、それぞれネイティブテストと結合テストだけを実行するようになったため、テストの各段階を独立して実行できます。

ネイティブテストまたは結合テストを実行するときに、ユニットテストを含むデフォルトのタスク依存関係を使用していた場合は、ビルドスクリプトを更新してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

今回のリリースでは、ラムダを使用して REST クライアントで ContextResolver を定義すると、IllegalArgumentException が出力されます。

これが発生するのは、REST クライアントエクステンションがジェネリック型を推論できないためです。以前のバージョンでは、デフォルトで Object に設定されていました。

実行時エラーを回避し、正しい REST クライアント設定を確保するために、ラムダを具体的な ContextResolver 実装に置き換えてください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

今回のリリースでは、Panache を使用する Jakarta REST リソースクラスは、Quarkus REST モジュールでのみ動作します。

REST Data Panache モジュールは、RESTEasy Classic モジュールでは動作しなくなりました。

実行時の障害を回避するために、RESTEasy Classic (quarkus-resteasy-*) ではなく、Quarkus REST (quarkus-rest-*) を使用してください。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.22 を参照してください。

今回のリリースでは、Quarkus REST はシリアライゼーションとデシリアライゼーションの両方に一貫して @JsonView を適用します。

リソースメソッドまたは DTO の @JsonView は、指定されたビュークラス (たとえば、Views.Public および Views.Private) に従って、入力から読み取るプロパティーと出力に書き込むプロパティーを制御するようになりました。

以前は、シリアライゼーションのみが @JsonView を適用していたため、デシリアライゼーションではアクティブビューの外部のプロパティーが受け入れられる可能性がありました。この動作に依存していたアプリケーションでは、新しい動作に合わせてコードまたは設定の変更が必要になる場合があります。

この変更を適用するには、このリリースノートに記載されている追加の手順を手動で実行します。Red Hat build of Quarkus 3.27 へのアプリケーションの移行ガイド の自動更新プロセスには、この変更は含まれません。

詳細は、Quarkus の Migration guide 3.21 を参照してください。