Update projects to the latest Quarkus version

你可以使用更新命令将 Quarkus 项目更新或升级到 Quarkus 的最新版本。 更新命令主要使用 OpenRewrite 配方自动化更新大多数项目依赖项、源代码和文档。虽然这些配方会更新许多迁移项，但不会涵盖 Migration Guides 中详述的所有项。 在更新后，如果缺少预期的更新，请考虑以下原因：

  • 配方中可能未包含项目中的特定项。

  • 你的项目可能使用与 Quarkus 最新版本不兼容的扩展程序。

对于使用 Hibernate ORM 或 Hibernate Reactive 的项目，请查看 Hibernate ORM 5 to 6 migration 快速参考。以下更新命令仅涵盖本指南的一小部分内容。

Table of Contents

Prerequisites

include::./_includes/prerequisites.adoc[]* 基于 Quarkus 版本 2.13 或更高版本的项目。

Procedure

  1. 使用版本控制系统为项目创建一个工作分支。

  2. 在下一步中使用 Quarkus CLI，install the latest version of the Quarkus CLI。使用 quarkus -v 确认版本号。

  3. 访问项目目录并将项目更新为最新流：[role="primary asciidoc-tabs-sync-cli"] .Using Quarkus CLI

quarkus update

可选：要指定特定的流，请使用 --stream 选项；例如： --stream=3.2

Using Maven
./mvnw {quarkus-platform-groupid}:quarkus-maven-plugin:{quarkus-version}:update -N

可选：要指定特定的流，请使用 -Dstream 选项；例如： -Dstream=3.2 . 分析更新命令的输出以获取潜在的指令，并在必要时执行建议的任务。 . 使用 diff 工具检查所有更改。 . 查看 Migration Guides 以了解更新命令未更新的项目。如果项目中存在此类项目，请实施这些主题中建议的附加步骤。 . 确保项目在不产生错误的情况下构建，所有测试通过，且应用程序在部署到生产环境前按要求运行。