将 Fuse 7 Applications 迁移到 Red Hat build of Apache Camel for Quarkus

流程

1. 使用 code.quarkus.redhat.com 网站，为本例选择以下扩展：

   • camel-quarkus-xml-io-dsl
   • camel-quarkus-file
   • camel-quarkus-xpath
2. 选择 Generate your application 来确认您的选择并显示包含您生成的项目的存档的下载链接。
3. 选择 Download the ZIP 将带有生成的项目文件的存档保存到您的机器中。
4. 提取存档的内容。

5. 进入从上一步中提取生成的项目文件的目录：

   $ cd <directory_name>

   Copy to Clipboard Toggle word wrap
6. 在 src/main/resources/routes/ 目录中创建一个名为 camel-routes.xml 的文件。

7. 将以下 blueprint-example.xml 示例中的 < route > 元素和子元素复制到 camel-routes.xml 文件中：

   blueprint-example.xml

   <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
       <camelContext id="cbr-example-context" xmlns="http://camel.apache.org/schema/blueprint">
           <route id="cbr-route">
               <from id="_from1" uri="file:work/cbr/input"/>
               <log id="_log1" message="Receiving order ${file:name}"/>
               <choice id="_choice1">
                   <when id="_when1">
                       <xpath id="_xpath1">/order/customer/country = 'UK'</xpath>
                       <log id="_log2" message="Sending order ${file:name} to the UK"/>
                       <to id="_to1" uri="file:work/cbr/output/uk"/>
                   </when>
                   <when id="_when2">
                       <xpath id="_xpath2">/order/customer/country = 'US'</xpath>
                       <log id="_log3" message="Sending order ${file:name} to the US"/>
                       <to id="_to2" uri="file:work/cbr/output/us"/>
                   </when>
                   <otherwise id="_otherwise1">
                       <log id="_log4" message="Sending order ${file:name} to another country"/>
                       <to id="_to3" uri="file:work/cbr/output/others"/>
                   </otherwise>
               </choice>
               <log id="_log5" message="Done processing ${file:name}"/>
           </route>
       </camelContext>
   </blueprint>

   Copy to Clipboard Toggle word wrap

   camel-routes.xml

   <route id="cbr-route">
       <from id="_from1" uri="file:work/cbr/input"/>
       <log id="_log1" message="Receiving order ${file:name}"/>
       <choice id="_choice1">
           <when id="_when1">
               <xpath id="_xpath1">/order/customer/country = 'UK'</xpath>
               <log id="_log2" message="Sending order ${file:name} to the UK"/>
               <to id="_to1" uri="file:work/cbr/output/uk"/>
           </when>
           <when id="_when2">
               <xpath id="_xpath2">/order/customer/country = 'US'</xpath>
               <log id="_log3" message="Sending order ${file:name} to the US"/>
               <to id="_to2" uri="file:work/cbr/output/us"/>
           </when>
           <otherwise id="_otherwise1">
               <log id="_log4" message="Sending order ${file:name} to another country"/>
               <to id="_to3" uri="file:work/cbr/output/others"/>
           </otherwise>
       </choice>
       <log id="_log5" message="Done processing ${file:name}"/>
   </route>

   Copy to Clipboard Toggle word wrap

8. 修改 application.properties

   # Camel
   #
   camel.context.name = camel-quarkus-xml-io-dsl-example
   camel.main.routes-include-pattern = file:src/main/resources/routes/camel-routes.xml

   Copy to Clipboard Toggle word wrap

9. 编译您的 CEQ 应用程序。

   mvn clean compile quarkus:dev

   Copy to Clipboard Toggle word wrap
   注意

   此命令编译项目，启动应用程序，并允许 Quarkus 工具监视工作区中的更改。项目中的任何修改都会自动在正在运行的应用程序中生效。

1. 配置扩展 registry 客户端，如 Quarkus Getting Started 指南中的 Configuring Quarkus extension registry client 部分所述。

2. 使用 Maven 更新：

   进入项目目录，将项目更新至最新的流：

   1. 确保 Quarkus Maven 插件版本与最新支持的 Red Hat build of Quarkus 版本一致。

   2. 使用以下命令运行更新：

      mvn io.quarkus.platform:quarkus-maven-plugin:3.8.6:update -N

      Copy to Clipboard Toggle word wrap

      对于多模块项目，始终首先尝试以下命令：

      mvn io.quarkus.platform:quarkus-maven-plugin:3.8.6:update

      Copy to Clipboard Toggle word wrap

      如果这个命令失败，您可以尝试这个较长的命令：

      find . -type f -name "pom.xml" -execdir sh -c 'mvn io.quarkus.platform:quarkus-maven-plugin:3.8.6:update -N' \;

      Copy to Clipboard Toggle word wrap
      注意

      由于 OpenRewrite 存在问题，迁移日志中会预先设置警告。

      选填

      默认情况下，这个命令会更新到最新的当前版本。要更新到特定流而不是最新的当前版本，请在这个命令中添加 stream 选项，后跟版本；例如： -Dstream=3.2

      注意

      多模块项目的更新可能会显示很多错误，因为更新工具无法使用 <packaging> pom</packaging> 更新模块。

      如果存在这些模块（通常包含版本），请手动更新它们。

3. 分析更新命令输出以了解潜在的指令，并根据需要执行建议的任务。
4. 使用 diff 工具来检查所有更改。
5. 查看 update 命令没有更新的项目的迁移指南。如果您的项目有这样的项目，请实施这些主题中建议的额外步骤。
6. 在部署到生产之前，确保项目构建时没有错误，所有测试都通过应用功能。

7. 在将更新的 Quarkus 应用程序部署到生产环境前，请确保以下内容：

   • 项目构建时无错误。
   • 所有测试都通过。
   • 应用程序可以正常工作。