Red Hat JBoss EAP XP 3.0.0 リリースノート

Red Hat JBoss Enterprise Application Platform 7.4

JBoss EAP XP 3.0.0 向け

概要

このドキュメントは、JBoss EAP XP 3.0.0 リリースに関する一般的な情報を提供します。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

Red Hat ドキュメントへのフィードバック

Red Hat ドキュメントに関するご意見やご感想をお寄せください。フィードバックをお寄せいただくには、ドキュメントのテキストを強調表示し、コメントを追加できます。以下の手順に従って、Red Hat ドキュメントのフィードバックをお寄せください。

前提条件

  • Red Hat カスタマーポータルにログインする。
  • Red Hat カスタマーポータルで、Multi-page HTML 形式のドキュメントを表示する。

手順

  1. フィードバック をクリックして、既存のリーダーコメントを表示します。

    注記

    フィードバック機能は、Multi-page HTML 形式でのみ有効です。

  2. フィードバックを提供するドキュメントのセクションを強調表示します。
  3. 選択したテキストの近くに表示されるプロンプトメニューで、Add Feedback をクリックします。

    ページの右側のフィードバックセクションにテキストボックスが開きます。

  4. テキストボックスにフィードバックを入力し、Submit をクリックします。

    ドキュメントに関する問題を作成しました。

  5. 問題を表示するには、フィードバックビューで問題トラッカーリンクをクリックします。

第1章 新機能および改良された機能

1.1. マイグレーション

移行ツール

以下のツールのいずれかを選択して、JBoss EAP XP 2.0.0 製品を JBoss EAP XP 3.0.0 製品にアップグレードおよび移行できます。

  • JBoss Server Migration Tool
  • Migration Toolkit for Applications (MTA)

JBoss EAP XP マネージャーを使用して JBoss EAP XP 2.0.0 製品を JBoss EAP XP 3.0.0 製品にアップグレードおよび移行することはできません。

関連情報

設定要素の名前変更

JBoss EAP XP 3.0.0 の場合、extraServerContentDirs 設定要素は extraServerContent 設定要素を置き換えます。この代替は、既存の extra-server-content-dirs 要素に合わせます。

JBoss EAP Maven プラグイン設定で extraServerContent 要素を使用した場合は、この要素を extraServerContentDirs 要素に置き換える必要があります。extra-server-content-dirs 要素を使用した場合は、設定を変更する必要はありません。

関連情報

1.2. MicroProfile

MicroProfile 4.0 のサポート

JBoss EAP XP3.0 は MicroProfile 4.0 仕様と互換性があります。

MicroProfile Config 2.0 のサポート

JBoss EAP は MicroProfile Config 2.0 をサポートします。これは MicroProfile 4.0 の一部です。この Config インターフェイスにより、新しいメソッドが導入されます。

変更についての詳細は、MicroProfile Config 2.0 のリリースノート を参照してください。

MicroProfile Metrics 3.0 のサポート

JBoss EAP は MicroProfile 4.0 の一部である MicroProfile Metrics 3.0 をサポートします。新しいリリースの重大な変更には、以下が含まれます。

  • API コードからの再利用に関連するものをすべて削除しました。すべてのメトリクスは再利用可能とみなすようになりました。
  • メトリックの登録変更しました。@Metric アノテーションが付けられた CDI プロデューサーがメトリクス登録をトリガーしなくなりました。メトリックの登録には、MetricRegistry メソッドを使用する必要があります。
  • MetricRegistry が抽象クラスからインターフェイスに変更しました。

変更の完全リストは、3.0 での変更 を参照してください。

MicroProfile Health 3.0 のサポート

JBoss EAP は MicroProfile 4.0 の一部である MicroProfile Health 3.0 をサポートします。主な変更は以下のとおりです。

  • @Health 修飾子のプルーニング
  • HealthCheckResponse デシリアライズの問題を修正

このコンポーネントのアップグレードでは、MicroProfile Health 3.0 を実装する smallrye-health 3.0.0 のアップグレードにも対応しています。詳細は、MicroProfile Health 3.0 のリリースノート を参照してください。

MicroProfile OpenTracing 2.0 のサポート

JBoss EAP は MicroProfile 4.0 の一部である MicroProfile OpenTracing 2.0 をサポートします。新しいリリースでは、以下の API が削除されます。

  • Scope = ScopeManager.active()
  • Scope = ScopeManager.activate(Span, boolean)
  • Span = Scope.span()
  • Scope = SpanBuilder.startActive()
  • Span = Tracer.startManual()
  • AutoFinishScopeManager

詳細は、Release 2.0 を参照してください。

MicroProfile Fault Tolerance 3.0 のサポート

JBoss EAP は、MicroProfile 4.0 の一部である MicroProfile Fault Tolerance 3.0 をサポートします。新リリースには、次の重大な変更があります。

  • メトリック名とスコープが変更されました。MicroProfile Metrics 2.0 はメトリックタグを追加し、その結果、以前はメトリック名に含まれていた一部の情報がタグに含まれるようになりました。
  • サーキットブレーカーとバルクヘッドのライフサイクルが指定されています。サーキットブレーカーとバルクヘッドは呼び出し間で状態を保持するため、正しく機能するためにはそれらのライフサイクルが重要です。

詳細は、Release Notes for MicroProfile Fault Tolerance 3.0 を参照してください。

1.3. 起動可能な JAR

起動時に起動可能な JAR ファイルのサーバー設定を更新する機能

--cli-script=<path to CLI script> 引数を使用して、ランタイム時に起動可能な JAR ファイルのサーバー設定を更新できるようになりました。引数では、<path to CLI script> は、起動可能な JAR の起動時に実行する Unicode Transformation Format 8 ビット (UTF-8) のテキストファイルである JBoss CLI スクリプトへのパスを意味します。

この新機能には、以下の注意事項があります。

  • サーバーの再起動を必要とする操作を実行すると、起動可能な JAR サーバーが終了します。このサーバーは、起動可能な JAR を再起動するの通常の動作です。
  • ランタイム時に以下の JBoss CLI コマンドを実行できません。connectreloadshutdownjdbc-driver-info、および組み込みサーバーおよび patch に関連するコマンドです。

起動可能な JAR サーバーコンポーネントをアップグレードする機能

起動可能な JAR Maven プラグインから JAR ファイルを構築するときに、起動可能な JAR にある以下のサーバーコンポーネントをアップグレードできます。

  • undertow-core などの JBoss Modules モジュール の JAR ファイル
  • XP 3.0.x Galleon feature-pack の依存関係である EAP 7.4.x Galleon feature-pack

1.4. クイックスタート

OpenShift クイックスタート

OpenShift をサポートするために JBoss EAP XP 1.0.0 でリリースされたクイックスタートはテクノロジープレビューでした。

JBoss EAP XP 3.0.0 の時点で、これらのクイックスタートは完全にサポートされます。

起動可能な JAR の MicroProfile クイックスタート

JBoss EAP XP 3.0.0 は、起動可能な JAR 機能を理解するために使用できる MicroProfile クイックスタートを提供します。

各クイックスタートは、小規模かつ特定の起動可能な JAR の例を提供します。クイックスタートを使用して、選択したプラットフォームで起動可能な JAR サンプルを実行し、テストします。

注記

MicroProfile クイックスタートは、空の JAR の構築およびテストには使用できません。

以下の MicroProfile クイックスタートを使用して、ベアメタルプラットフォームまたは OpenShift プラットフォームのいずれかで起動可能な JAR をテストします。

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile Metrics
  • MicroProfile OpenAPI
  • MicroProfile OpenTracing
  • MicroProfile REST クライアント

MicroProfile Reactive Messaging 1.0 のクイックスタート

JBoss EAP XP 3.0.0 は、基本的な機能を記述する MicroProfile Reactive Messaging 1.0 の新しいクイックスタートとガイドを提供します。

Apache Kafka プラットフォームがサポートするインメモリーストリームとストリームを使用できます。ベアメタルシステムを使用している場合は、Docker プラットフォームを使用して Apache Kafka 機能にアクセスできます。OpenShift では、AMQ Streams operator を使用して Apache Kafka 機能にアクセスできます。

1.5. テクノロジープレビュー機能

AMQ Streams インテグレーションの MicroProfile Reactive Messaging 1.0

JBoss EAP XP は MicroProfile Reactive Messaging 1.0 をサポートするようになりました。MicroProfile Reactive Messaging 1.0 API を使用して、AMQ Streams 2021.Q2 と対話できます。つまり、JBoss EAP XP はメッセージリレーとして動作し、アプリケーション内でメッセージを消費、処理、および生成できます。このテクノロジープレビュー機能は OpenShift Container Platform で利用できます。

第2章 メンテナンスサポート

2.1. JBoss EAP XP のメンテナンスサポート

新しい JBoss EAP XP メジャーバージョンがリリースされると、以前のメジャーバージョンのメンテナンスサポートが開始されます。通常、メンテナンスサポートは 12 週間の間です。

メンテナンスサポートの長さ外にある JBoss EAP XP メジャーバージョンを使用している場合は、セキュリティーパッチおよびバグ修正の開発が適用されなくなったため、問題が発生する可能性があります。このような問題を回避するには、お使いの JBoss EAP バージョンと互換性のある最新の JBoss EAP XP メジャーバージョンリリースにアップグレードします。

関連情報

第3章 サポートされない機能と非推奨の機能

3.1. サポートされない機能

メンテナンスコストが高いこと、コミュニティーの関心が低いこと、より優れた代替ソリューションが存在するのを理由に、一部のテクノロジーのサポートを終了しました。以下の機能は JBoss EAP XP 3.0.0 ではサポートされません。

プラットフォームおよび機能

Oracle Solaris

JBoss EAP のバージョン 7.1 で以下のプラットフォームが非推奨になりました。以下のプラットフォームは JBoss EAP 7.4 ではテストされていません。

  • Oracle Solaris on x86_64
  • Oracle Solaris on SPARCv9

JBoss EAP 7.4 には、これらプラットフォームの WildFly SSL ネイティブは含まれていません。そのため、Oracle Solaris プラットフォームでの SSL 操作は、以前の JBoss EAP バージョンよりも速度が遅くなる可能性があります。

OpenJDK8 イメージおよびイメージストリーム

バージョン 3.0 以降、JBoss EAP XP は OpenJDK8 イメージやイメージストリームを提供またはサポートしなくなりました。

RESTEasy パラメーター

RESTEasy には、サーブレットのリソースおよびプロバイダーの自動スキャンを実行する Servlet 3.0 ServletContainerInitializer 統合インターフェイスが同梱されています。コンテナーは、この統合インターフェイスを使用してアプリケーションを起動できます。そのため、以下の RESTEasy パラメーターの使用はサポート対象外となりました。

  • resteasy.scan
  • resteasy.scan.providers
  • resteasy.scan.resources

Red Hat JBoss Operations Network

JBoss EAP バージョン 7.2 以降、JBoss EAP 管理への Red Hat JBoss Operations Network (JON) の使用は非推奨となりました。JBoss EAP 7.4 では、JBoss EAP 管理に対する Red Hat JON のサポートは非推奨になりました。

MS SQL Server 2017

MS SQL Server 2017 は JBoss EAP 7.4 ではサポートされません。

JBoss EAP 7.4 でサポートされていない機能の完全なリストは、JBoss EAP 7.4 Release Notes の サポートされない機能 を参照してください。

3.2. 非推奨の機能

本リリースでは一部の機能が非推奨になりました。非推奨の機能には改良が加えられず、将来的 (通常は次のメジャーリリース) に削除される可能性があります。

Red Hat は標準のサポート条件に基づき、継続して完全サポートおよびバグ修正を提供します。JBoss EAP XP の Red Hat サポートポリシーに関する詳細は、Red Hat カスタマーポータルにある Red Hat JBoss Enterprise Application Platform expansion pack のライフサイクルとサポートポリシー を参照してください。

OpenJDK11 OpenShift イメージは複数のアーキテクチャーをサポートします

IBM Z および IBM Power Systems の OpenJ9 イメージは非推奨となりました。以下の OpenJDK11 Builder イメージおよび Runtime イメージが更新され、複数のアーキテクチャーをサポートするようになりました。

  • jboss-eap-7/eap-xp3-openjdk11-openshift-rhel8 (Builder イメージ)
  • jboss-eap-7/eap-xp3-openjdk11-runtime-openshift-rhel8 (Runtime イメージ)

OpenJDK11 イメージは、次のアーキテクチャーで使用できます。

  • x86 (x86_64)
  • s390x (IBM Z)
  • ppc64le (IBM Power Systems)

OpenJDK11 イメージで OpenJ9 Java Virtual Machine (JVM) を使用する場合は、Java Change in Power and Z OpenShift Images を参照してください。

Galleon レイヤー

jms-activemq デコレーターレイヤーは非推奨になり、このレイヤーは messaging-activemq レイヤーに置き換えられました。

オペレーティングシステム

  • Microsoft Windows Server on i686
  • Red Hat Enterprise Linux (RHEL) 6 on i686

データベースおよびデータベースコネクター

  • IBM DB2 11.1
  • PostgreSQL / EnterpriseDB 11
  • MariaDB 10.1
  • MS SQL 2017

Server Side JavaScript

テクノロジープレビュー機能として提供されていた JBoss EAP Server Side JavaScript サポートは非推奨になりました。

Lightweight Directory Access Protocol (LDAP) サーバー

  • Red Hat Directory Server 10.0
  • Red Hat Directory Server 10.1

Spring BOM

Red Hat Maven リポジトリーにある以下の Spring BOM が非推奨になりました。

  • jboss-eap-jakartaee8-with-spring4

RedHat は Spring アプリケーションが JBoss EAP XP 3.0.0 で実行されることをテストしますが、JBoss EAP XP 3.0.0 でアプリケーションを開発するには、Spring Framework とその BOM の最新バージョン (例: x.y.z.RELEASE) を使用する必要があります。

Spring Framework のバージョンの詳細は、Spring Framework Versions on GitHubを参照してください。

Java Development Kit

  • Java Development Kit 8 (JDK 8)
  • Java Development Kit 11 (JDK 11)

    注記

今後の主要な JBoss EAP リリースでは、Java SE 要件は、業界 (Jakarta EE、MicroProfile など) と市場のニーズに基づいて再評価されます。

JBoss EAP OpenShift テンプレート

OpenShift 向けの JBoss EAP テンプレートが非推奨になりました。

.json テンプレート

eap-xp2-third-party-db-s2i.json テンプレートは非推奨になり、JBoss EAP XP 3.0.0 で削除されました。

eap74-beta-starter-s2i.json および eap74-beta-third-party-db-s2i.json テンプレートは非推奨になり、JBoss EAP 7.4.0 で削除されました。

レガシーセキュリティーサブシステム

org.jboss.as.security 拡張と、この拡張がサポートするレガシーの security サブシステムは非推奨になりました。セキュリティー実装を security サブシステムから elytron サブシステムに移行します。

org.wildfly.extension.picketlink 拡張およびこの拡張をサポートする picketlink-federationpicketlink-identity-management サブシステムが非推奨になりました。シングルサインオン実装を Red Hat Single Sign-On に移行してください。

PicketBox ベースのセキュリティー vault

PicketBox ベースのセキュリティー vault は、レガシーセキュリティーサブシステムと core-service=vault カーネル管理リソースの両方を介して非推奨になりました。

以前の JBoss EAP バージョンの管理対象ドメインサポート

JBoss EAP 7.4 の管理対象ドメインで JBoss EAP 7.3 以前のバージョンを実行しているホストのサポートは非推奨になりました。管理対象ドメインのホストを JBoss EAP 7.4 に移行します。

JBoss EAP 7.3 以前からの名前空間を使用するサーバー設定ファイル

本リリースでは、JBoss EAP 7.3 からの名前空間が含まれるサーバー設定ファイル (standalone.xmlhost.xmldomain.xml) の使用は非推奨となりました。JBoss EAP 7.4 の namespace を使用するようにサーバー設定ファイルを更新します。

Agroal サブシステム

Agroal サブシステムは非推奨です。

application-security-domain リソース

ejb3 サブシステムおよび undertow サブシステムの application-security-domain リソースは非推奨になりました。

クラスターリングサブシステムのリソース

クラスターリングサブシステムの次のリソースは非推奨です。

  • infinispan サブシステム

    • /subsystem=infinispan/remote-cache-container=*/component=transaction
    • /subsystem=infinispan/remote-cache-container=/near-cache=
  • jgroups サブシステム

    • /subsystem=jgroups/stack=*/protocol=S3_PING
    • /subsystem=jgroups/stack=*/protocol=GOOGLE_PING
  • Themodcluster サブシステム

Codehaus Jackson

現在サポートされていない Codehaus Jackson 1.x モジュールは JBoss EAP 7.4 で非推奨になりました。

SCRAM メカニズム

次の SCRAM メカニズムとそのチャネルバインディングバリアントは非推奨になりました。

  • SCRAM-SHA-512
  • SCRAM-SHA-384

Hibernate ORM 5.1

Hibernate ORM 5.1 ネイティブ API バイトコードトランスフォーマーは、最初に導入されて以来、常に非推奨になっています。

HornetQ クライアント

HornetQ クライアントモジュールは非推奨になりました。

JBoss EAP 7.4 で非推奨となった機能の一覧は、JBoss EAP 7.4 リリースノートの 非推奨の機能 を参照してください。

第4章 解決された問題および既知の問題

4.1. 解決した問題

本リリースで解決した問題の一覧は、Resolved Issues for JBoss EAP XP 3.0.0 を参照してください。

4.2. 既知の問題

本リリースでの 既知の問題の一覧は、JBoss EAP XP 3.0.0 の既知の問題を参照してください。