Red Hat SummitRed Hat build of Apache Camel for Quarkus のリリースノート
Red Hat build of Apache Camel の新機能
概要
第1章 Red Hat build of Apache Camel for Quarkus 3.2 リリースノート
1.1. Red Hat build of Apache Camel for Quarkus の機能
- 高速起動と低 RSS メモリー
- Quarkus の最適化されたビルドタイムおよび事前 (AOT: Ahead-of-Time) コンパイラー機能を使用すると、ビルド時に Camel アプリケーションを事前に設定できるため、起動時間を短縮できます。
- アプリケーションジェネレーター
- Quarkus アプリケーションジェネレーター を使用して、アプリケーションをブートストラップし、エクステンションエコシステムを検出します。
- 高度な設定が可能
Red Hat build of Apache Camel for Quarkus アプリケーションの重要な側面はすべて、CDI (Contexts and Dependency Injection) または設定プロパティーを使用してプログラム的に設定できます。デフォルトでは、CamelContext が設定され、自動的に開始されます。
アプリケーションのブートストラップおよび設定のさまざまな方法は、Configuring your Quarkus applications by using a properties file ガイドを参照してください。
- 既存の Quarkus エクステンションとの統合
- Red Hat build of Apache Camel for Quarkus は、ネイティブサポートと設定オプションを継承する Camel コンポーネントにより使用されるライブラリーとフレームワークのエクステンションを提供します。
1.2. サポートされるプラットフォーム、設定、データベース、およびエクステンション
- Red Hat build of Apache Camel for Quarkus バージョン 3.2 でサポートされているプラットフォーム、設定、およびデータベースについては、カスタマーポータルの サポートされる構成 ページを参照してください (ログインが必要です)。
- Red Hat Red Hat build of Apache Camel for Quarkus エクステンションのリストと、各エクステンションに対する Red Hat のサポートレベルについては、Red Hat build of Apache Camel for Quarkus リファレンス の エクステンションの概要 の章を参照してください (ログインが必要です)。
1.3. Red Hat build of Apache Camel for Quarkus の BOM ファイル
-
サポートされているエクステンションを使用するように Red Hat build of Apache Camel for Apache Camel バージョン 3
.2 プロジェクトを設定するには、Redhat Maven リポジトリー にある最新の BOM (Bill of Materials)バージョン 3.2.10.Final-redhat⚙ 以降を使用します。
BOM 依存関係管理の詳細は、Red Hat build of Apache Camel for Quarkus を使用したアプリケーションの開発 を参照してください。
1.4. テクノロジープレビューのエクステンション
Red Hat build of Apache Camel for Quarkusリファレンス の エクステンションの概要 の章でテクノロジープレビューに指定された項目については、「テクノロジープレビュー機能のサポート範囲」で定義されているように、サポート範囲が限定されています。
1.5. 既知の問題
1.5.1. SAP エクステンションの Camel Quarkus の制限事項
SAP エクステンションはパッケージタイプ uber-jar をサポートしていないため、アプリケーションが次のような実行時例外を出力します。
Caused by: java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.ExceptionInInitializerError: Illegal JCo archive "sap-1.0.0-SNAPSHOT-runner.jar". It is not allowed to rename or repackage the original archive "sapjco3.jar".
Caused by: java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.ExceptionInInitializerError: Illegal JCo archive "sap-1.0.0-SNAPSHOT-runner.jar". It is not allowed to rename or repackage the original archive "sapjco3.jar".1.5.2. JVM-only サポートタグの欠落
現在、http://code.quarkus.redhat.com には、次のエクステンションの正しいサポート情報が記載されていません。
| エクステンション | アーティファクト | JVM サポートレベル | ネイティブサポートレベル | 説明 |
|---|---|---|---|---|
| Azure-servicebus | テクノロジープレビュー | なし | Azure Service Bus との間でメッセージを送受信します。 | |
| SAP | 製品サポート | なし | SAP Camel コンポーネントを提供します。 | |
| SNMP | 製品サポート | なし | トラップを受信し、SNMP (Simple Network Management Protocol) 対応デバイスをポーリングします。 |
1.5.3. その他の既知の問題
- CEQ-6085 サポートエクステンション: camel-quarkus-micrometer
smallrye-metricsからmicrometerに移行する場合は、一部の Bean をスコープ指定された Bean として手動で定義する必要がある場合があります。smallrye-metricsでは、メトリクス (@COUNTED、@METRICなど) として登録されているが、スコープ指定された Bean として登録されていないクラスが、自動的に登録されます。micrometerではこのようなことは起こりません。micrometerでは、@Dependentアノテーションを追加するなどして、CDI を通じてアクセスされる Bean を手動で登録する必要があります。- CEQ-5705 camel-quarkus-snmp がネイティブではサポートされていない
-
Red Hat build of Apache Camel for Quarkus では、
camel-quarkus-snmpコンポーネントが JVM モードでのみサポートされます。
1.6. CXF の既知の問題
このリリースの CXF には次の問題があります。
1.6.1. サポートされるエクステンション
現在、次の quarkus-cxf エクステンション のみ がサポートされています。
暗黙的に、camel-quarkus-cxf-soap の推移的な依存関係として、以下がサポートされます。
-
quarkus-cxf -
quarkus-cxf-rt-features-logging
さらに、WS-Security またはその他の関連機能が必要な場合は、次のサポート対象のエクステンションを追加できます。
-
quarkus-cxf-rt-ws-security -
quarkus-cxf-services-sts -
quarkus-cxf-xjc-plugins
1.6.1.1. WS-ReliableMessaging
CXF WS-ReliableMessaging の完全なサポートは現在提供されていません。この機能は、バージョン 3.2 ではテクノロジープレビュー機能のままとなります。
1.6.2. java.net.http.HttpClient を使用する CXF クライアントによる DoS ベクトルの可能性
CXF クライアントが基盤となる HTTP クライアントとして java.net.http.HttpClient を使用している場合、CXF の問題 により、多数のクライアントが作成されると、スレッドが終了しないため、アプリケーションがクラッシュする可能性があります。
この問題は、CXF クライアントがリクエストごとなどに繰り返し作成される場合に、java.net.http.HttpClient で発生します。アプリケーションの存続期間全体を通じてクライアントが維持される場合、この問題は発生しません。
Apache Camel for Quarkus 3.2.0 および Quarkus CXF 2.2.3 以降では、特定の CXF クライアントにおける HTTP クライアント実装の選択は、quarkus.cxf.client.yourClient.http-conduit-factory プロパティーにより制御されます。デフォルトでは、Quarkus CXF によって作成された CXF クライアントは java.net.HttpURLConnection を HTTP クライアントとして使用します。そのため、この問題はデフォルトでは発生しません。この問題は、quarkus.cxf.client.yourClient.http-conduit-factory=HttpClientHTTPConduitFactory を設定すると発生する可能性があります。
1.6.2.1. DoS ベクトルの軽減
-
java.net.http.HttpClientでバックアップされた CXF クライアントは、アプリケーションの存続期間中にクライアントが 1 回しか作成されないことが確実な場合に限り使用してください。 -
HC5 や
java.net.HttpURLConnectionなど、他の HTTP クライアント実装でバックアップされた CXF クライアントを使用します。
1.7. 重要事項
1.7.1. javax から jakarta へのパッケージ名前空間の変更
Java EE は Eclipse Foundation に移行し、Jakarta EE が設立されました。Jakarta EE 9 以降、すべての EE API に使用されるパッケージは jakarta.* に変更されました。
ドキュメント内のコードスニペットは jakarta.* 名前空間を使用するように更新されています。ただし、お客様のアプリケーションは注意してご確認いただく必要があります。
この変更は、Java SE に含まれる javax パッケージには影響しません。
アプリケーションを EE 10 に移行する場合は、次のことを行う必要があります。
-
import ステートメントまたはその他のソースコードにおける EE API クラスの使用を
javaxパッケージからjakartaに更新します。 -
名前が
javax.で始まる EE 指定のシステムプロパティーまたはその他の設定プロパティーを、jakarta.で始まるものに変更します。 -
META-INF/services/jakarta.[rest_of_name]名前形式を使用して、実装 EE インターフェイスを使用するアプリケーション内の実装クラス、またはjava.util.ServiceLoaderメカニズムでブートストラップされる抽象クラスを識別します。
1.7.1.1. 移行ツール
- ソースコードの移行: How to use Red Hat Migration Toolkit for Auto-Migration of an Application to the Jakarta EE 10 Namespace
- バイトコード変換: ソースコードの移行が可能ではない場合は、オープンソースの Eclipse Transformer
関連情報
1.7.2. Java
- Java の最小バージョン - JDK 17
- Red Hat build of Apache Camel for Quarkus バージョン 3.2 には、JDK 17 以降が必要です。
- AdoptiumJDK のサポート
- Red Hat build of Apache Camel for Quarkus バージョン 3.2 には、AdoptiumJDK 17 のサポートが含まれています。
1.7.3. アップグレード
- バージョン 3.14.2 からバージョン 3.18.6 にアップグレードされた Camel
Red Hat build of Apache Camel for Quarkus バージョン 3.2 は、Camel バージョン 3.18.6 から Camel バージョン 4.0.0 にアップグレードされました。介在する各 Camel パッチリリースに関する追加情報は、以下を参照してください。
- Apache Camel 3.18.7 リリースノート
- Apache Camel 3.18.8 リリースノート
- Apache Camel 3.19.0 リリースノート
- Apache Camel 3.20.0 リリースノート
- Apache Camel 3.20.1 リリースノート
- Apache Camel 3.20.2 リリースノート
- Apache Camel 3.20.3 リリースノート
- Apache Camel 3.20.4 リリースノート
- Apache Camel 3.20.5 リリースノート
- Apache Camel 3.20.6 リリースノート
- Apache Camel 3.20.7 リリースノート
- Apache Camel 3.20.8 リリースノート
- Apache Camel 3.21.0 リリースノート
- Apache Camel 3.21.1 リリースノート
- Apache Camel 3.21.2 リリースノート
- Apache Camel 4.0.0 リリースノート
- Camel Quarkus がバージョン 2.7 からバージョン 2.13 にアップグレード
Red Hat build of Apache Camel for Quarkus バージョン 3.2 は、Camel Quarkus バージョン 2.13 から Camel Quarkus バージョン 3.2 にアップグレードされました。その間の各 Camel Quarkus パッチリリースに関する詳細は、以下を参照してください。
1.8. 解決した問題
次の表は、Red Hat build of Apache Camel for Quarkus に影響を及ぼしていた既知の問題を示しています。これらは、Red Hat build of Apache Camel for Quarkus バージョン 3.2 で修正されています。
解決した問題
- CEQ-7591
- Quarkus CXF: デフォルトのチャンクサイズが小さいため、大きい応答の下転送
- CEQ-7086
- CEQ のスタートガイドで、どの Maven リポジトリーを設定する必要があるかがユーザーに示されていない
- CEQ-6604
- camel-cxf-soap 名前空間の変更に伴い CEQ 移行手順を更新する
- CEQ-6217
- テンプレート化されたルートがルートテンプレートの前に処理されると失敗する
- CEQ-6263
- OpenTelemetry トレースが順番に生成されない
- CEQ-6203
- OpenShift 上の CXF を使用して CQ をデプロイする場合、quarkus.cxf.path プロパティーを設定する必要がある
- CEQ-4878
- JMS コンポーネントの接続プーリング (汎用クライアント、完全サポート)
- CEQ-1203
- プラットフォームのサポート: KNative/サーバーレスデプロイメント
1.8.1. 以前のリリース
Camel Quarkus 2.13 と Camel Quarkus 3.2 の間で解決された問題の詳細は、各パッチリリースの リリースノートを 参照してください。
1.9. Red Hat build of Apache Camel for Quarkus バージョン 3.2 の非推奨機能
Red Hat build of Apache Camel for Quarkus バージョンに非推奨の機能はありません。
1.10. Red Hat build of Apache Camel for Quarkus バージョン 3.2 で削除されたエクステンション
次の表に、Red Hat build of Apache Camel for Quarkus のこのリリースで追加されたエクステンションを示します。
| エクステンション | アーティファクト | 説明 | 注記 |
|---|---|---|---|
| MicroProfile Metrics |
| Camel ルートからメトリクスを公開します。 |
1.11. Red Hat build of Apache Camel for Quarkus バージョン 3.2 で追加されたエクステンション
次の表に、Red Hat build of Apache Camel for Quarkus のこのリリースで追加されたエクステンションを示します。
| エクステンション | アーティファクト | 説明 | 注記 |
|---|---|---|---|
| AMQP |
| Apache QPid クライアントを使用した AMQP プロトコルによるメッセージング。 | |
| Azure-servicebus |
| Azure Service Bus との間でメッセージを送受信します。 | |
| CLI-connector |
| Camel CLI に接続するランタイムアダプター | |
| Crypto |
| Java Cryptographic Extension (JCE) の署名サービスを使用してエクスチェンジに署名し、検証します。 | |
| GRPC |
| gRPC エンドポイントを公開し、外部 gRPC エンドポイントにアクセスします。 | |
| JDBC |
| ||
| 言語 |
| ||
| LDAP |
| LDAP サーバーで検索を実行します。 | |
| 管理 |
| JMX 管理ストラテジーと関連する管理リソース。 | |
| Mapstruct |
| Mapstruct を使用した型変換 | |
| Micrometer |
| Micrometer ライブラリーを使用して、Camel ルートからさまざまなメトリクスを直接収集します。 | |
| Minio |
| Minio SDK を使用して、Minio Storage Service からオブジェクトを保存および取得します。 | |
| Mybatis |
| MyBatis を使用して、リレーショナルデータベースでクエリー、ポーリング、挿入、更新、または削除を実行します。 | |
| Netty-http |
| Netty 4.x を使用する Netty HTTP サーバーおよびクライアント。 | |
| SAP |
| SAP Camel コンポーネントを提供します。 | |
| Saxon |
| XQuery および Saxon を使用して XML ペイロードをクエリーまたは変換します。 | |
| Splunk |
| Splunk でイベントを公開または検索します。 | |
| Vertx-http |
| ||
| Vertx-websocket |
| Vert.x による Camel WebSocket のサポート | |
| XSLT-Saxon |
| Saxon を使用した XSLT テンプレートを使用して XML ペイロードを変換します。 |
1.12. Red Hat build of Apache Camel for Quarkus バージョン 3.2 でサポートが変更されたエクステンション
次の表に、Red Hat build of Apache Camel for Quarkus のこのリリースでサポートレベルが変更されたエクステンションを示します。
| エクステンション | アーティファクト | 説明 | 注記 |
|---|---|---|---|
| AWS2-CW |
| AWS SDK バージョン 2.x を使用してメトリクスを AWS CloudWatch に送信します。 | |
| CXF-soap |
| Apache CXF を使用して SOAP WebServices を公開するか、CXF WS クライアントを使用して外部 WebServices に接続します。 | |
| Telegram |
| Telegram Bot API として動作するメッセージを送受信します。 | |
| XML IO DSL |
| XML ルート定義を解析するための XML スタック | |
| Yaml-dsl |
| YAML ルート定義を解析するための YAML スタック |
サポートレベルについては、Red Hat build of Apache Camel for Quarkus リファレンス を参照してください。
1.13. Red Hat build of Apache Camel for Quarkus バージョン 3.2 で追加されたデータ形式
次の表に、Red Hat build of Apache Camel for Quarkus バージョン 3.2 のこのリリースで追加されたデータ形式を示します。
| エクステンション | アーティファクト | 説明 |
|---|---|---|
| JAXP |
| XML JAXP タイプコンバーターおよびパーサー |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}