第 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-layer
由 org.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 时不支持这个层。
其他资源