Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

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

作为应用程序开发人员，您可以使用 Quarkus CLI 的 update 命令，将基于 Red Hat build of Quarkus 的 应用程序迁移到版本 3.2。

重要

Quarkus CLI 仅用于 dev 模式。红帽不支持在生产环境中使用 Quarkus CLI。

您可以使用 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. 流程
复制链接

  1. 使用您的版本控制系统为您的项目创建可正常工作的分支。
  2. 要在下一步中使用 Red Hat build of Quarkus CLI，请安装 Red Hat build of Quarkus CLI 的最新版本。使用 quarkus -v 确认版本号。
  3. 配置扩展 registry 客户端，如 Quarkus "Getting Started" 指南中的 Configuring Red Hat build of Quarkus extension registry client 部分所述。

  4. 要使用红帽构建的 Quarkus CLI 更新，请进入项目目录并将项目更新至最新的流： 

    quarkus update
    Copy to Clipboard Toggle word wrap

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

  5. 要使用 Maven 而不是红帽构建的 Quarkus CLI 更新，请进入项目目录并将项目更新至最新的流：

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

    2. 根据 Getting started with Quarkus 指南中提供的指南配置您的项目。 

      mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:update
      Copy to Clipboard Toggle word wrap

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

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

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

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

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部