第 9 章 功能修剪


在构建可引导 JAR 时,您可以决定要包含哪些 JBoss EAP 功能和子系统:

注意

只有 OpenShift 或构建可引导 JAR 时,才支持修剪功能。

其他资源

9.1. 可用的 JBoss EAP 层

红帽提供了多个层,可在 OpenShift 或可引导 JAR 中自定义 JBoss EAP 服务器的调配。

三个层是提供核心功能的基本层。其他层是 decorator 层,其增强了基本层的功能。

大多数 decorator 层可用于在 JBoss EAP 中为 OpenShift 构建 S2I 镜像,或构建可引导 JAR。几个层不支持 S2I 镜像;层的描述中指出这个限制。

注意

仅支持列出的层。不支持此处列出的层。

9.1.1. 基本层

每个基础层包括典型的服务器用户用例的核心功能。

datasources-web-server

此层包含一个 servlet 容器,以及配置数据源的功能。

此层不包括 MicroProfile 功能。

此层支持以下 Jakarta EE 规格:

  • Jakarta JSON Processing 1.1
  • Jakarta JSON Binding 1.0
  • Jakarta Servlet 4.0
  • Jakarta Expression Language 3.0
  • Jakarta Server Pages 2.3
  • Jakarta Standard Tag Library 1.2
  • jakarta Concurrency 1.1
  • Jakarta Annotations 1.3
  • Jakarta XML Binding 2.3
  • Jakarta Debugging Support for Other Languages 1.0
  • Jakarta Transactions 1.3
  • Jakarta Connectors 1.7
jaxrs-server

此层通过以下 JBoss EAP 子系统增强了 datasources-web-server 层:

  • jaxrs
  • weld
  • jpa

此层还在容器中本地添加了基于 Infinispan 的第二级实体缓存。

以下 MicroProfile 功能包含在此层中:

  • MicroProfile REST 客户端

除了 datasources-web-server 层支持的那些层,还需要以下 Jakarta EE 规格:

  • jakarta 上下文和依赖注入 2.0
  • Jakarta Bean Validation 2.0
  • Jakarta Interceptors 1.2
  • jakarta RESTful Web Services 2.1
  • Jakarta Persistence 2.2
cloud-server

此层通过以下 JBoss EAP 子系统增强了 jaxrs-server 层:

  • resource-adapters
  • messaging-activemq (远程代理消息传递,非嵌入式消息传递)

此层还在 jaxrs-server 层中添加以下可观察性功能:

  • MicroProfile Health
  • MicroProfile Config

除了 jaxrs-server 层支持的外,该层还支持以下 Jakarta EE 规格:

  • jakarta Security 1.0

cloud-default-mp-config

此层根据 standalone-microprofile-ha.xml 文件,使用独立配置来调配服务器。cloud-default-mp-layerorg.jboss.eap.xp:eap-xp-cloud-galleon-pack 提供,支持 JBoss EAP XP S2I 构建,但不适用于 Bootable JAR。有关 JBoss EAP XP 中包含的服务器配置文件的更多信息,请参阅 单机服务器配置文件 部分。

此工作流使用 microprofile-config quickstart 作为示例。Quickstart 提供了一个小型特定工作示例,可用作您自己的项目的参考。如需更多信息,请参阅 JBoss EAP XP 5.0.0 附带的 microprofile-config Quickstart。

ee-core-profile-server

ee-core-profile-server 层置备带有 Jakarta EE 10 核心配置文件的服务器。Core Profile 为提供核心 JBoss EAP 服务器功能和 Jakarta EE API 的用户提供了一个小型的轻量级配置文件。ee-core-profile-server 层最适合更小的运行时,如云原生应用程序和微服务。

9.1.2. decorator 层

Decorator 层不会独立使用。您可以使用基本层配置一个或多个 decorator 层,以提供额外的功能。

ejb-lite

此 decorator 层向置备的服务器添加最小的 Jakarta Enterprise Beans 实施。这个层不包括以下支持:

  • IIOP 集成
  • MDB 实例池
  • 远程连接器资源

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

Jakarta Enterprise Beans

此 decorator 层扩展 ejb-lite 层。除了 ejb-lite 层中包含的基本功能外,此层还对置备的服务器添加以下支持:

  • MDB 实例池
  • 远程连接器资源

如果要使用消息驱动的 Bean (MDB)或 Jakarta Enterprise Beans 远程功能,则使用这个层。如果不需要这些功能,请使用 ejb-lite 层。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

ejb-local-cache

此 decorator 层将 Jakarta Enterprise Beans 的本地缓存支持添加到置备的服务器。

依赖项 :只有当您包含 ejb-lite 层或 ejb 层时,才能包含此层。

注意

此层与 ejb-dist-cache 层不兼容。如果包含 ejb-dist-cache 层,则无法包含 ejb-local-cache 层。如果您同时包含两个层,则生成的构建可能会包含意外的 Jakarta Enterprise Beans 配置。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

ejb-dist-cache

此 decorator 层将 Jakarta Enterprise Beans 的分布式缓存支持添加到置备的服务器。

依赖项 :只有当您包含 ejb-lite 层或 ejb 层时,才能包含此层。

注意

此层与 ejb-local-cache 层不兼容。如果包含 ejb-dist-cache 层,则无法包含 ejb-local-cache 层。如果您同时包含两个层,则生成的构建可能会导致意外配置。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

jdr

此 decorator 层添加 JBoss 诊断报告(jdr)子系统,以便在从红帽请求支持时收集诊断数据。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

jakarta Persistence

此 decorator 层为单节点服务器添加持久性功能。请注意,只有在服务器能够组成集群时,分布式缓存才可以正常工作。

该层将 Hibernate 库添加到置备的服务器,并具有以下支持:

  • jpa 子系统的配置
  • infinispan 子系统的配置
  • 本地 Hibernate 缓存容器
注意

此层与 jpa-distributed 层不兼容。如果包含 jpa 层,则无法包含 jpa-distributed 层。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

jpa-distributed

这个 decorator 层为集群中运行的服务器添加持久性功能。该层将 Hibernate 库添加到置备的服务器,并具有以下支持:

  • jpa 子系统的配置
  • infinispan 子系统的配置
  • 本地 Hibernate 缓存容器
  • Invalidation 和 replication Hibernate 缓存容器
  • 配置 jgroups 子系统
注意

此层与 jpa 层不兼容。如果包含 jpa 层,则无法包含 jpa-distributed 层。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

jakarta Server Faces

此 decorator 层将 jsf 子系统添加到调配的服务器。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

microprofile-platform

此 decorator 层向置备的服务器添加以下 MicroProfile 功能:

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile OpenAPI
注意

此层包括 可观察 层中包含的 MicroProfile 功能。如果包含这个层,则不需要包含 可观察 层。

Observability(可观察性)

这个 decorator 层在置备的服务器中添加了以下可观察性功能:

  • MicroProfile Health
  • MicroProfile Config
注意

此层内置于 cloud-server 层。您不需要将此层添加到 cloud-server 层。

remote-activemq

此 decorator 层添加了与远程 ActiveMQ 代理通信到调配的服务器的功能,集成消息传递支持。

池的连接工厂配置将 guest 指定为 用户和密码 属性的值。您可以使用 CLI 脚本在运行时更改这些值。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

sso

这种 decorator 层将 Red Hat Single Sign-On 集成到置备的服务器。

只有在使用 S2I 调配服务器时,才应使用此层。

web-console

这个 decorator 层将管理控制台添加到置备的服务器。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

web-clustering

此 decorator 层通过为适合集群环境的数据会话处理配置基于本地 Infinispan 的容器 Web 缓存来添加对可分布式 Web 应用的支持。

web-passivation

此 decorator 层通过为适合单一节点环境的数据会话配置本地基于 Infinispan 的容器 Web 缓存来添加对可分布式 Web 应用程序的支持。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

webservices

此层为调配的服务器添加 Web 服务功能,支持 Jakarta Web 服务部署。

只有在构建可引导 JAR 时,才支持此层。使用 S2I 时不支持这个层。

其他资源

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat