第 4 章 迁移 Camel Quarkus 项目
4.1. 将项目更新至最新的 Quarkus 版本
我们建议您使用 Maven 更新项目,并将项目升级到最新的 Quarkus 版本。
对于使用 Hibernate ORM 或 Hibernate Reactive 的项目,请查看 Hibernate ORM 5 到 6 的迁移 快速参考。以下 update 命令只涵盖本指南的子集。
4.1.1. 先决条件
- 大约 30 分钟
-
正确安装了
JAVA_HOME
的 JDK - Apache Maven 3.8.6
- 另外,如果要使用 Quarkus CLI
- 基于 Camel Quarkus 版本 2.13 或更高版本的项目。
4.1.2. 使用 Maven 更新
- 配置扩展 registry 客户端,如 Quarkus Getting Started 指南中的 Configuring Quarkus extension registry client 部分所述。
使用 Maven 更新:
进入项目目录,将项目更新至最新的流:
- 确保 Quarkus Maven 插件版本与最新支持的 Red Hat build of Quarkus 版本一致。
使用以下命令运行更新:
mvn io.quarkus.platform:quarkus-maven-plugin:3.8.4:update -N
对于多模块项目,始终首先尝试以下命令:
mvn io.quarkus.platform:quarkus-maven-plugin:3.8.4:update
如果这个命令失败,您可以尝试这个较长的命令:
find . -type f -name "pom.xml" -execdir sh -c 'mvn io.quarkus.platform:quarkus-maven-plugin:3.8.4:update -N' \;
注意由于 OpenRewrite 存在问题,迁移日志中会预先设置警告。
- 选填
默认情况下,这个命令会更新到最新的当前版本。要更新到特定流而不是最新的当前版本,请在这个命令中添加 stream 选项,后跟版本;例如:
-Dstream=3.2
注意多模块项目的更新可能会显示很多错误,因为更新工具无法使用 <packaging>
pom</packaging>
更新模块。如果存在这些模块(通常包含版本),请手动更新它们。
- 分析更新命令输出以了解潜在的指令,并根据需要执行建议的任务。
- 使用 diff 工具来检查所有更改。
- 查看 update 命令没有更新的项目的迁移指南。如果您的项目有这样的项目,请实施这些主题中建议的额外步骤。
- 在部署到生产之前,确保项目构建时没有错误,所有测试都通过应用功能。
在将更新的 Quarkus 应用程序部署到生产环境前,请确保以下内容:
- 项目构建时无错误。
- 所有测试都通过。
- 应用程序可以正常工作。