8.4. 为您的可引导 JAR 服务器指定 Galleon 层
您可以指定 Galleon 层来为您的服务器构建自定义配置。另外,您可以指定您要从服务器中排除的 Galleon 层。
要引用单个功能包,请使用 <feature-pack-location> 元素来指定其位置。以下示例在 Maven 插件配置文件中的 <feature 。
-pack> 元素中指定了 org.jboss.eap:wildfly-galleon-pack: 3.0.0.GA-redhat-00001
<configuration> <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:3.0.0.GA-redhat-00001</feature-pack-location> </configuration>
<configuration>
<feature-pack-location>org.jboss.eap:wildfly-galleon-pack:3.0.0.GA-redhat-00001</feature-pack-location>
</configuration>
如果您需要引用多个功能包,请在 <feature-packs> 元素中列出它们。以下示例显示了将 Red Hat Single Sign-On 功能包添加到 <feature-packs> 元素中:
您可以组合多个功能包中的 Galleon 层来配置可引导 JAR 服务器,使其仅包含提供您所需功能的受支持 Galleon 层。
在裸机平台上,如果您未在配置文件中指定 Galleon 层,调配的服务器包含与默认 standalone-microprofile.xml 配置相同的配置。
在 OpenShift 平台上,在插件 配置中添加 <cloud/> 配置元素后,您选择不在配置文件中指定 Galleon 层,置备的服务器包含根据云环境进行调整的配置,并且与默认的 standalone-microprofile-ha.xml 类似。
先决条件
- 已安装 Maven。
-
您已检查了最新的 Maven 插件版本,如
MAVEN_PLUGIN_VERSION.X.GA.Final-redhat-00001,其中 MAVEN_PLUGIN_VERSION 是主版本,X 是 microversion。请参阅 /ga/org/wildfly/plugins/wildfly-jar-maven-plugin 的索引。 -
您已检查了最新的 Galleon 功能包版本,如
3.0.X.GA-redhat-BUILD_NUMBER,其中 X 是 JBoss EAP XP 和 BUILD_NUMBER 的微版本,是 Galleon 功能包的构建号。X 和 BUILD_NUMBER 在 JBoss EAP XP 3.0.0 产品生命周期中都可能会演变。请参阅 /ga/org/jboss/eap/wildfly-galleon-pack 的索引。
流程中显示的示例指定以下属性:
-
用于 Maven 插件版本的
${bootable.jar.maven.plugin.version}。 -
Gall
eon 功能包版本的 ${JBoss.xp.galleon.feature.pack.version}。
您必须在项目中设置这些属性。例如:
<properties>
<bootable.jar.maven.plugin.version>4.0.3.Final-redhat-00001</bootable.jar.maven.plugin.version>
<jboss.xp.galleon.feature.pack.version>3.0.0.GA-redhat-00001</jboss.xp.galleon.feature.pack.version>
</properties>
<properties>
<bootable.jar.maven.plugin.version>4.0.3.Final-redhat-00001</bootable.jar.maven.plugin.version>
<jboss.xp.galleon.feature.pack.version>3.0.0.GA-redhat-00001</jboss.xp.galleon.feature.pack.version>
</properties>
流程
- 确定受支持的 JBoss EAP Galleon 层,它们可提供运行应用所需的功能。
在 Maven 项目
pom.xml文件的<plugin>元素中引用 JBoss EAP 功能包位置。您必须指定任何 Maven 插件的最新版本,以及org.jboss.eap:wildfly-galleon-packGalleon 功能包的最新版本,如下例中所示。以下示例还显示包含单个功能包,其中包括jaxrs-server基础层和jpa-distributed层:jaxrs-server基础层为服务器提供额外的支持。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 此示例还演示了将
jpa层从项目中排除。注意如果您在项目中包含
jpa-distributed层,则必须将jpa层从jaxrs-server层中排除。jpa层配置本地 infinispan hibernate 缓存,而jpa-distributed层配置远程 infinispan hibernate 缓存。