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 版本的一般信息。

使开源包含更多

红帽承诺替换我们的代码、文档和网页属性中存在问题的语言。我们从这四个术语开始： master、slave、blacklist 和 whitelist。这些更改将在即将发行的几个发行本中逐渐实施。详情请查看 CTO Chris Wright 信息。

对红帽文档提供反馈

我们感谢您对我们文档的反馈。要提供反馈，您可以突出显示文档中的文本并添加注释。按照以下步骤了解提交对红帽文档的反馈。

先决条件

  • 登录红帽客户门户。
  • 在红帽客户门户中，以多页 HTML 格式查看文档。

流程

  1. 单击 Feedback 以查看现有读取器注释。

    注意

    反馈功能仅以多页 HTML 格式启用。

  2. 突出显示您要提供反馈的文档中的部分。

  3. 在显示在您选择的文本附近的提示菜单中，单击 Add Feedback。

    文本框将在页面右侧的"反馈"部分中打开。

  4. 在文本框中输入您的反馈，然后单击 Submit。

    您已创建了文档问题。

  5. 要查看问题，请单击反馈视图中的问题跟踪器链接。

第 1 章 新功能及功能增强

1.1. Migration（迁移）

迁移工具

您可以选择以下任一工具来升级 JBoss EAP XP 2.0.0 产品并将其迁移到 JBoss EAP XP 3.0.0 产品：

  • JBoss 服务器迁移工具
  • 应用迁移工具(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 XP 3.0 与 MicroProfile 4.0 规范兼容。

支持 MicroProfile Config 2.0

JBoss EAP 支持 MicroProfile Config 2.0，这是 MicroProfile 4.0 的一部分。此配置界面引进了新的方法。

如需有关更改的更多信息，请参阅 MicroProfile 配置 2.0 的发行说明。

支持 MicroProfile 指标 3.0

JBoss EAP 支持 MicroProfile 指标 3.0，这是 MicroProfile 4.0 的一部分。新发行版本的破坏更改包括以下 ：

  • 从 API 代码中删除了与可重复利用相关的所有内容。现在，所有指标都被视为可重复使用。
  • 已更改指标注册.使用 @Metric 标注的 CDI 制造商不再触发指标注册。您必须使用 MetricRegistry 方法来注册指标。
  • 从抽象类到接口的 Changed MetricRegistry。

有关更改的完整列表，请参阅 3.0 中的更改。

支持 MicroProfile Health 3.0

JBoss EAP 支持 MicroProfile Health 3.0，这是 MicroProfile 4.0 的一部分。主要变化如下：

  • pruned @Health 限定符
  • 修复了 HealthCheckResponse 降序问题

此组件升级还包括实施 MicroProfile Health 3.0 的 smallrye-health 3.0.0 升级。如需更多信息，请参阅 MicroProfile Health 3.0 的发行说明。

支持 MicroProfile OpenTracing 2.0

JBoss EAP 支持 MicroProfile OpenTracing 2.0，这是 MicroProfile 4.0 的一部分。新发行版本删除了以下 API：

  • Scope = ScopeManager.active()
  • ScopeManager.activate（Span、布尔值）
  • Span = Scope.span()
  • Scope = SpanBuilder.startActive()
  • Span = Tracer.startManual()
  • AutoFinishScopeManager

如需更多信息，请参阅 版本 2.0。

支持 MicroProfile 容错 3.0

JBoss EAP 支持 MicroProfile 容错 3.0，这是 MicroProfile 4.0 的一部分。新发行版本有以下中断更改：

  • 指标名称和范围已更改。MicroProfile Metrics 2.0 添加了指标标签，因此之前包含在指标名称中的一些信息现在包含在标签中。
  • 指定了断路器和舱壁的生命周期。断路器和舱壁在调用之间保持状态，因此它们的生命周期对于正确运行非常重要。

如需更多信息，请参阅 MicroProfile 容错 3.0 的发行说明。

1.3. 可引导 JAR

能够在运行时更新可引导 JAR 文件的服务器配置

现在，您可以使用 --cli-script=<path to CLI script> 参数在运行时更新可引导 JAR 文件的服务器配置。在参数中，<path to CLI script> 意味着到 JBoss CLI 脚本的路径，即 Unicode 转换格式 8 位(UTF-8)中的文本文件，以便在启动可引导 JAR 时执行。

这个新功能有以下注意事项：

  • 如果您执行任何需要重新启动服务器的操作，可引导的 JAR 服务器都会退出，这是可引导 JAR 重新启动的一般行为。
  • 您无法在运行时执行以下 JBoss CLI 命令： 连接、重新加载、关闭、jdbc-driver-info，以及与嵌入式服务器和 补丁相关的任何命令。

升级可引导 JAR 服务器组件的功能

在使用可引导 JAR maven 插件构建 JAR 文件时，您可以升级位于可引导 JAR 文件的以下服务器组件：

  • JBoss 模块的 JAR 文件， 如 undertow-core.
  • EAP 7.4.x Galleon feature-pack，这是 XP 3.0.x Galleon 功能包的 依赖项。

1.4. Quickstarts

OpenShift 快速入门

JBoss EAP XP 1.0.0 中发布的快速入门支持 OpenShift 是技术预览。

从 JBoss EAP XP 3.0.0 开始，完全支持这些快速入门。

可引导 JAR 的 MicroProfile 快速入门

JBoss EAP XP 3.0.0 提供 MicroProfile 快速入门，您可用于了解可引导 JAR 功能。

每个快速入门提供一个小的、具体的可引导 JAR 示例。使用 Quickstarts 在您选择的平台上运行和测试可引导 JAR 示例。

注意

MicroProfile 快速入门无法用于构建和测试易用的 JAR。

使用以下 MicroProfile 快速入门，在裸机平台或 OpenShift 平台上测试可引导 JAR：

  • MicroProfile Config
  • MicroProfile 容错
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile Metrics
  • MicroProfile OpenAPI
  • MicroProfile OpenTracing
  • MicroProfile REST Client

MicroProfile 响应消息 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 流集成的 MicroProfile Reactive Messaging 1.0

JBoss EAP XP 现在支持 MicroProfile 响应消息 1.0。您可以使用 MicroProfile 响应消息 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
  • SPARCv9 上的 Oracle Solaris

JBoss EAP 7.4 不包含这些平台的 WildFly SSL 原生。因此，甲骨文 Solaris 平台的 SSL 操作可能比之前版本的 JBoss EAP 慢。

OpenJDK 8 镜像流和镜像流

从版本 3.0 开始，JBoss EAP XP 不再提供或支持 OpenJDK 8 镜像或镜像流。

resteasy 参数

RESTEasy 提供 Servlet 3.0 ServletContainerInitializer 集成接口，用于对 servlet 的资源和提供程序执行自动扫描。容器可以使用此集成接口来启动应用。因此，不再支持使用以下 RESTEasy 参数：

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

Red Hat JBoss Operations Network

从 JBoss EAP 版本 7.1 开始，使用红帽 JBoss 运营网络(JON)进行 JBoss EAP 管理已弃用。对于 JBoss EAP 7.4，已弃用对红帽 JON 进行 JBoss EAP 管理的支持。

MS SQL Server 2017

JBoss EAP 7.4 不支持 MS SQL Server 2017。

有关 JBoss EAP 7.4 中不支持的功能的完整列表，请参阅 JBoss EAP 7.4 发行注记中的"不受支持的功能 "部分。

3.2. 已弃用的功能

本发行版本中弃用了一些功能。这意味着不会对这些功能进行任何增强，而且它们将来可能会被删除，通常是下一个主要版本。

红帽会根据我们的标准支持条款和条件继续提供全面支持和漏洞修复。有关红帽 JBoss EAP XP 支持政策的更多信息，请参阅 Red Hat JBoss Enterprise Application Platform 扩展软件包生命周期和支持政策。

OpenJDK11 OpenShift 镜像支持多个构架

IBM Z 和 IBM Power 系统的 OpenJ9 镜像将被弃用。以下 OpenJDK11 Builder 和 Runtime 镜像已更新为支持多个构架：

  • jboss-eap-7/eap-xp3-openjdk11-openshift-rhel8 （Builder 镜像）
  • jboss-eap-7/eap-xp3-openjdk11-runtime-openshift-rhel8 (Runtime image)

您可以在以下构架中使用 OpenJDK11 镜像：

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

如果要将 OpenJ9 Java 虚拟机(JVM)与 OpenJDK11 镜像一起使用，请参阅 Power 和 Z OpenShift 镜像的 Java 更改。

Galleon 层

jms-activemq decorator 层已被弃用，这个层已被 messaging-activemq 层替代。

操作系统

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

数据库和数据库连接器

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

服务器幻灯片 JavaScript

作为技术预览功能提供的 JBoss EAP Server Side JavaScript 支持已弃用。

轻量级目录访问协议(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

虽然红帽测试 Spring 应用程序在 JBoss EAP XP 3.0.0 上运行，但您必须使用最新版本的 Spring Framework 及其 BOM（例如，x.y.z.RELEASE）在 JBoss EAP XP 3.0.0 上开发您的应用。

有关 Spring Framework 版本的更多信息，请参阅 GitHub 上的 Spring Framework 版本。

Java 开发套件

  • Java 开发套件 8(JDK 8)

  • Java 开发套件 11(JDK 11)

    备注

在未来的 JBoss EAP 主要版本中，将根据行业（如 Jakarta EE、MicroProfile 等）和市场需求，评估 Java SE 要求。

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 子系统迁移到 elytron 子系统。

PicketLink

此扩展 支持的 org.wildfly.extension.picketlink 扩展和 picketlink-federation 和 picket link-identity-management 子系统现已弃用。将单点登录实施迁移到红帽单点登录。

基于 Picketbox 的安全库

基于 Picketbox 的安全库（通过传统安全子系统和 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 .xml、host.xml 和 domain.xml ）在此发行版本中已弃用。更新您的服务器配置文件，以使用 JBoss EAP 7.4 命名空间。

Agroal 子系统

Agroal 子系统已弃用。

application-security-domain resources

ejb3 和 undertow 子系统中的 application-security-domain 资源已弃用。

cluster 子系统中的资源

Cluster 子系统中的以下资源已弃用：

  • 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
  • modcluster 子系统

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 发行注记中的Deprecated features 部分。

第 4 章 已解决的问题和已知问题

4.1. 已解决的问题

请参阅 JBoss EAP XP 3.0.0 解决的问题，以查看已为此版本解决的问题列表。

4.2. 已知问题

请参阅 JBoss EAP XP 3.0.0 已知的问题，以查看此版本已知问题的列表。