第 1 章 将应用程序迁移到红帽构建的 Quarkus 3.8
作为应用程序开发人员，您可以使用 Quarkus CLI 的 update 命令将 基于 Red Hat build of Quarkus 的早期版本的应用程序迁移到 3.8 版本。
Quarkus CLI 仅用于 dev 模式。红帽不支持在生产环境中使用 Quarkus CLI。
1.1. 将项目更新至最新的红帽构建的 Quarkus 版本
您可以使用 update 命令更新或将红帽构建的 Quarkus 项目升级到最新版本。
update 命令主要使用 OpenRewrite recipes 自动更新大多数项目依赖项、源代码和文档。虽然这些方法执行许多迁移任务，但它们并不涵盖迁移指南中详述的所有任务。
更新后，如果缺少预期的更新，请考虑以下原因：
-
update命令应用的配方可能不包括项目所需的迁移任务。 - 您的项目可能会使用与最新的红帽构建的 Quarkus 版本不兼容的扩展。
对于使用 Hibernate ORM 或 Hibernate Reactive 的项目，请查看 Hibernate ORM 5 到 6 的迁移 快速参考。以下 update 命令只涵盖本指南的子集。
1.1.1. 先决条件
- 大约 30 分钟
- IDE
-
正确配置了
JAVA_HOME的 JDK 11+ - Apache Maven 3.8.6 或更高版本
- 另外，如果要使用它，红帽构建的 Quarkus CLI
- 如果要构建原生可执行文件（如果使用原生容器构建，则为 Docker）正确安装和配置 Mandrel 或 GraalVM
- 基于红帽构建的 Quarkus 版本 2.13 或更高版本的项目。
1.1.2. 流程
- 使用您的版本控制系统为您的项目创建可正常工作的分支。
-
要在下一步中使用 Red Hat build of Quarkus CLI，请安装 Red Hat build of Quarkus CLI 的最新版本。使用
quarkus -v确认版本号。 - 配置扩展 registry 客户端，如 Quarkus "Getting Started" 指南中的 Configuring Red Hat build of Quarkus extension registry client 部分所述。
要使用红帽构建的 Quarkus CLI 更新，请进入项目目录并将项目更新至最新的流：
要使用 Maven 而不是红帽构建的 Quarkus CLI 更新，请进入项目目录并将项目更新至最新的流：
- 确保红帽构建的 Quarkus Maven 插件版本与最新支持的 Red Hat build of Quarkus 版本一致。
根据 Getting started with Quarkus 指南中提供的指南配置您的项目。
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.8.4.redhat-00002:update
可选： 默认情况下，这个命令会更新到最新的当前版本。要更新到特定流而不是最新的当前版本，请在这个命令中添加
stream选项，后跟版本；例如：-Dstream=3.2
- 分析 update 命令输出的潜在指令，并根据需要执行建议的任务。
- 使用 diff 工具来检查所有更改。
- 查看 update 命令没有更新的项目的迁移指南。如果您的项目有这样的项目，请实施这些主题中建议的额外步骤。
- 在部署到生产之前，确保项目构建时没有错误，所有测试都通过应用功能。
在将更新的 Red Hat build of Quarkus 应用程序部署到生产环境前，请确保以下内容：
- 项目构建时无错误。
- 所有测试都通过。
- 应用程序可以正常工作。
