第 1 章将应用程序迁移到红帽构建的 Quarkus 3.20

作为应用程序开发人员，您可以使用 quarkus CLI 或 Maven 将基于红帽构建的 Quarkus 版本 3.2 或更高版本的应用程序迁移到 3.20 版本。

重要

Quarkus CLI 主要用于开发目的，包括创建、更新和构建 Quarkus 项目等任务。但是，红帽不支持在生产环境中使用 Quarkus CLI。

1.1. 将项目更新至最新的红帽构建的 Quarkus 版本

要将 Red Hat build of Quarkus 项目更新至最新版本，请按照以下步骤操作，具体在本指南的后续部分中详细介绍：

运行 quarkus CLI 或 Maven 命令会触发升级项目依赖项和源代码的 OpenRewrite 方法。这种自动化方法提供了一种便捷且可靠的方法来更新您的项目。

但是，并非所有迁移任务都是自动化的。如果在运行 quarkus update 命令或其 Maven 等效后没有应用特定的更新，请考虑以下可能的原因：

手动更新可让您灵活地和控制来解决任何迁移任务，以确保您的项目与您的特定需求保持一致。未自动的任务必须手动处理。

有关从上一版本升级到此迁移任务所需的迁移任务列表，请参阅本指南中与早期版本兼容部分的更改。

查看应用程序项目当前版本和您要升级到的版本之间的每个发行版本的迁移指南非常重要。此审核过程可确保您完全了解并准备好更新过程。例如，如果从 3.15 升级到 3.20，您只需要查看本指南。如果您要从 3.2 版本升级到 3.20，还必须查看每个中间版本的指南：

此迁移指南中的每个任务都概述了所需的更改，并指示它们是否由 quarkus update 命令及其 Maven 自动处理。

如需了解更多背景，请参阅 Quarkus 社区迁移指南。