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>
Copy to Clipboard Toggle word wrap

如果您需要引用多个功能包,请在 <feature-packs> 元素中列出它们。以下示例显示了将 Red Hat Single Sign-On 功能包添加到 <feature-packs> 元素中:

<configuration>
    <feature-packs>
         <feature-pack>
             <location>org.jboss.eap:wildfly-galleon-pack:3.0.0.GA-redhat-00001</location>
        </feature-pack>
        <feature-pack>
            <location>org.jboss.sso:keycloak-adapter-galleon-pack:9.0.10.redhat-00001</location>
        </feature-pack>
    </feature-packs>
</configuration>
Copy to Clipboard Toggle word wrap

您可以组合多个功能包中的 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 功能包的构建号。XBUILD_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>
Copy to Clipboard Toggle word wrap

流程

  1. 确定受支持的 JBoss EAP Galleon 层,它们可提供运行应用所需的功能。
  2. 在 Maven 项目 pom.xml 文件的 <plugin> 元素中引用 JBoss EAP 功能包位置。您必须指定任何 Maven 插件的最新版本,以及 org.jboss.eap:wildfly-galleon-pack Galleon 功能包的最新版本,如下例中所示。以下示例还显示包含单个功能包,其中包括 jaxrs-server 基础层和 jpa-distributed 层:jaxrs-server 基础层为服务器提供额外的支持。

    <plugins>
          <plugin>
                <groupId>org.wildfly.plugins</groupId>
                 <artifactId>wildfly-jar-maven-plugin</artifactId>
                 <version>${bootable.jar.maven.plugin.version}</version>
                <configuration>
                     <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location>
                     <layers>
                         <layer>jaxrs-server</layer>
                         <layer>jpa-distributed</layer>
                     </layers>
                     <excluded-layers>
                         <layer>jpa</layer>
                     </excluded-layers>
                     ...
    </plugins>
    Copy to Clipboard Toggle word wrap

    此示例还演示了将 jpa 层从项目中排除。

    注意

    如果您在项目中包含 jpa-distributed 层,则必须将 jpa 层从 jaxrs-server 层中排除。jpa 层配置本地 infinispan hibernate 缓存,而 jpa-distributed 层配置远程 infinispan hibernate 缓存。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部