JBoss EAP XP 4.0 升级和迁移指南

流程

1. 删除任何 Thorntail BOM 导入。

   从 pom.xml 文件中删除 io.thorntail Thorntail BOM 导入的示例。

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>io.thorntail</groupId>
         <artifactId>bom</artifactId>
         <version>${version.thorntail}</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>

   Copy to Clipboard Toggle word wrap

2. 使用 JBoss EAP XP BOMs 将支持的工件导入到 JBoss EAP XP 依赖项管理。

   使用 jboss-eap-jakartaee8-with-tools BOM 将支持的工件导入到项目的示例。

   <dependencyManagement>
           <dependencies>
               <!-- importing the jakartaee8-with-tools BOM adds specs and other useful artifacts as managed dependencies -->
               <dependency>
                   <groupId>org.jboss.bom</groupId>
                   <artifactId>jboss-eap-jakartaee8-with-tools</artifactId>
                   <version>${version.server.bom}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
               <!-- importing the microprofile BOM adds MicroProfile specs -->
               <dependency>
                   <groupId>org.jboss.bom</groupId>
                   <artifactId>jboss-eap-xp-microprofile</artifactId>
                   <version>${version.microprofile.bom}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
           </dependencies>
       </dependencyManagement>

   Copy to Clipboard Toggle word wrap

   注意

   只有在应用程序依赖于 MicroProfile 平台中没有包含的 Jakarta EE 8 规格时，才导入 jakartaee8-with-tools BOM。

3. 将 Thorntail Maven 插件替换为 JBoss EAP XP bootable JAR Maven 插件。

   使用 JBoss EAP XP bootable JAR Maven 插件替换 Thorntail Maven 插件的示例。

   <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>microprofile-platform</layer>
         </layers>
      </configuration>
      <executions>
         <execution>
            <goals>
               <goal>package</goal>
            </goals>
         </execution>
      </executions>
   </plugin>

   Copy to Clipboard Toggle word wrap

   注意

   前面的示例为 Maven 插件版本指定以下属性：

   ${bootable.jar.maven.plugin.version}

   Copy to Clipboard Toggle word wrap

   您必须设置 Maven 插件版本，以代替项目中的此属性。例如：

   <properties>
       <bootable.jar.maven.plugin.version>6.1.2.Final-redhat-00001</bootable.jar.maven.plugin.version>
   </properties>

   Copy to Clipboard Toggle word wrap

   • 默认情况下，可引导 JAR 插件会构建 UberJAR，这意味着它将 JBoss EAP XP 运行时与部署的应用程序打包。要构建 hollow JAR，请在插件配置中添加 <hollow-jar>true</hollow-jar >。

4. 在 Maven 项目中对 Thorntail 部分进行以下更改。

   1. 删除 Thorntail 部分依赖项。

      显示从 Maven 项目中删除 io.thorntail Thorntail 部分的示例。

      <dependencies>
        <dependency>
          <groupId>io.thorntail</groupId>
          <artifactId>jaxrs</artifactId>
        </dependency>
      </dependencies>

      Copy to Clipboard Toggle word wrap

   2. 配置 Maven 依赖项。

      使用 XML 片断向 Jakarta EE 8 JAX-RS 和 MicroProfile Config API 的工件中添加依赖项的示例。

      <dependencies>
          <!-- Import the MicroProfile Config API, we use provided scope as the API is included in the server -->
          <dependency>
            <groupId>org.eclipse.microprofile.config</groupId>
            <artifactId>microprofile-config-api</artifactId>
            <scope>provided</scope>
          </dependency>
          <!-- Import the Jakarta REST API, we use provided scope as the API is included in the server -->
          <dependency>
            <groupId>org.jboss.spec.javax.ws.rs</groupId>
            <artifactId>jboss-jaxrs-api_2.1_spec</artifactId>
            <scope>provided</scope>
          </dependency>
        </dependencies>

      Copy to Clipboard Toggle word wrap

   3. 删除 Thorntail YAML 文件、系统属性和环境属性。

   4. 配置 Galleon 层。

      为需要 JAX-RS 的应用在可引导 JAR Maven 插件中配置 Galleon 层的示例。

      <plugin>
        <groupId>org.wildfly.plugins</groupId>               <artifactId>wildfly-jar-maven-plugin</artifactId>                  <configuration>
         ...
            <layers>
              <layer>jaxrs-server</layer>
              <layer>microprofile-platform</layer>
            </layers>
        </configuration>
         ...
      </plugin>

      Copy to Clipboard Toggle word wrap