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

1.2. 准备您的环境

在使用 Quarkus 之前，您必须准备您的环境。

流程

  • 确认您的系统中已完成以下安装：

    • 已安装 OpenJDK 11 或 17，并设置 JAVA_HOME 环境变量来指定 Java SDK 的位置。

      • 要下载红帽构建的 OpenJDK，请登录到红帽客户门户网站，再进入 Software Downloads。
    • 已安装 Apache Maven 3.8.x，其中 x 是 6 或更高版本。Apache Maven 位于 Apache Maven Project 网站。

    • 可选 ： 如果要使用 Quarkus 命令行界面(CLI)，请确保已安装它。

      • 有关如何安装 Quarkus CLI 的说明，请参考 Quarkus CLI 中的特定于社区的信息。
重要

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

1.2.1. 关于 Quarkus BOMs
复制链接

从红帽构建的 Quarkus 2.2 中，所有核心 Quarkus 扩展的依赖项版本都由使用 com.redhat.quarkus.platform:quarkus-bom 文件进行管理。

Bill of Materials (BOM)文件的目的是管理项目中的 Quarkus 工件的依赖项版本，以便在项目中使用 BOM 时，您不需要指定哪些依赖项版本协同工作。相反，您可以将 Quarkus BOM 文件导入到 pom.xml 配置文件，其中依赖项版本包含在 < dependencyManagement> 部分中。因此，您不需要列出由 pom.xml 文件中指定 BOM 管理的单个 Quarkus 依赖项版本。

要查看红帽构建的 Quarkus 中支持的扩展特定 BOM 的信息，请参阅 红帽构建的 Quarkus 组件详情。

您只需要为应用程序中使用的平台成员扩展导入特定于成员的 BOM。因此，与单个 BOM 相比，您需要管理较少的依赖项。因为每个特定于成员的 BOM 是通用 Quarkus BOM 的片段，所以您可以以任何顺序导入成员 BOM，而不创建冲突。

1.2.2. 关于 Apache Maven 和 Quarkus
复制链接

Apache Maven 是一个分布式构建自动化工具，用于 Java 应用程序开发，用于创建、管理和构建软件项目。Maven 使用名为 Project Object Model(POM)文件的标准配置文件来定义项目并管理构建流程。POM 文件描述了模块和组件依赖项，使用 XML 文件描述生成的项目打包和输出的构建顺序和目标，确保项目被正确构建并统一。

Maven 存储库

Maven 存储库存储 Java 库、插件和其他构建构件。默认公共存储库是 Maven 2 Central Repository，但存储库可以是私有和内部的，以在开发团队之间共享通用工件。也可从第三方提供存储库。

您可以将 Red Hat-hosted Maven 存储库与 Quarkus 项目一起使用，也可以下载红帽构建的 Quarkus Maven 存储库。

Maven 插件

Maven 插件是 POM 文件的定义部分，用于运行一个或多个任务。红帽构建的 Quarkus 应用程序使用以下 Maven 插件：

  • Quarkus Maven 插件(quarkus-maven-plugin) ：启用 Maven 来创建 Quarkus 项目，将应用程序打包到 JAR 文件中，并提供开发模式。
  • Maven Surefire 插件(maven-surefire-plugin): 当 Quarkus 启用 测试 配置集时，会在构建生命周期的测试阶段使用 Maven Surefire 插件在应用程序上执行单元测试。该插件生成包含测试报告的文本和 XML 文件。

1.2.3. 为在线存储库配置 Maven settings.xml 文件
复制链接

要将 Red Hat-hosted Quarkus 存储库与您的 Quarkus Maven 项目搭配使用，请为您的用户配置 settings.xml 文件。与存储库管理器或共享服务器上的存储库一起使用的 Maven 设置可以提供更好的项目控制和易管理性。

注意

当您修改 Maven settings.xml 文件来配置存储库时，这些更改将应用到所有 Maven 项目。如果只想将配置应用到特定的项目，请使用 -s 选项并指定特定于项目的 settings.xml 文件的路径。

流程

  1. 在文本编辑器中或集成开发环境(IDE)中打开 Maven $HOME/.m2/settings.xml 文件。

    注意

    如果 $HOME/.m2/ 目录中没有 settings.xml 文件，请将 settings.xml 文件从 $MAVEN_HOME/.m2/conf/ 目录中复制到 $HOME/.m2/ 目录中。

  2. 在 settings.xml 文件的 <profiles > 元素中添加以下行： 

    <!-- Configure the Quarkus Maven repository -->
<profile>
  <id>red-hat-enterprise-maven-repository</id>
  <repositories>
    <repository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>https://maven.repository.redhat.com/ga/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>https://maven.repository.redhat.com/ga/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </pluginRepository>
  </pluginRepositories>
</profile>
    Copy to Clipboard Toggle word wrap

  3. 在 settings.xml 文件的 < activeProfiles > 元素中添加以下行并保存文件。 

    <activeProfile>red-hat-enterprise-maven-repository</activeProfile>
    Copy to Clipboard Toggle word wrap

1.2.4. 配置 Quarkus Maven 存储库
复制链接

如果您不想使用在线 Maven 存储库，您可以下载并配置 Quarkus Maven 存储库，以使用 Maven 创建 Quarkus 应用程序。Quarkus Maven 存储库包含多个依赖项，Java 开发人员通常用来构建应用程序。此流程演示了如何编辑 settings.xml 文件来配置 Quarkus Maven 存储库。

注意

当您修改 Maven settings.xml 文件来配置存储库时，更改将应用到所有 Maven 项目。如果要将配置应用到特定的项目，请使用 -s 选项并指定特定于项目的 settings.xml 文件的路径。

流程

  1. 登录到红帽客户门户网站，进入 Software Downloads，再下载 Quarkus Maven 存储库 ZIP 文件。
  2. 提取下载的存档。
  3. 进入 $HOME/.m2/ 目录，并在文本编辑器中打开 Maven settings.xml 文件，或一个集成的开发环境(IDE)。

  4. 将您下载的 Quarkus Maven 存储库路径添加到 settings.xml 文件的 <profiles > 元素中。Quarkus Maven 存储库的路径的格式必须是 file://$PATH，例如 file:///home/userX/<root-directory-of-the-downloaded-archive>/maven-repository。 

    <!-- Configure the Quarkus Maven repository -->
<profile>
  <id>red-hat-enterprise-maven-repository</id>
  <repositories>
    <repository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>file:///path/to/Quarkus/Maven/repository/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>red-hat-enterprise-maven-repository</id>
      <url>file:///path/to/Quarkus/Maven/repository/</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </pluginRepository>
  </pluginRepositories>
</profile>
    Copy to Clipboard Toggle word wrap

  5. 在 settings.xml 文件的 < activeProfiles > 元素中添加以下行并保存文件。 

    <activeProfile>red-hat-enterprise-maven-repository</activeProfile>
    Copy to Clipboard Toggle word wrap
重要

如果您的 Maven 存储库包含过时的工件，则构建或部署项目时可能会遇到以下 Maven 错误消息之一：

  • 缺少工件 <project_name>
  • [ERROR] Failed to execute goal on project <artifact_name>; Could not resolve dependencies for <project_name>

其中：

  • <artifact_name > 是缺少工件的名称
  • <project_name > 是您要构建的项目的名称

要解决这个问题，请通过删除本地仓库的缓存版本（位于 $HOME/.m2/repository 目录中）来强制下载最新的 Maven 工件。

您可以通过更改项目 POM 文件中的 Maven 配置，将 Quarkus 社区项目迁移到红帽构建的 Quarkus。

先决条件

  • 您有一个使用 Maven 构建的 Quarkus 项目，它依赖于 pom.xml 文件中的 Quarkus 社区工件。

流程

  • 更改项目的 pom.xml 文件的 <properties > 部分中的以下值：

    • 将 < quarkus.platform.group-id> 属性的值更改为 com.redhat.quarkus.platform。

    • 将 < quarkus.platform.version> 属性的值更改为 2.13.9.SP2-redhat-00003。

      pom.xml

      <project>
  ...
  <properties>
     ...
     <quarkus.platform.group-id>com.redhat.quarkus.platform</quarkus.platform.group-id>
     <quarkus.platform.artifact-id>quarkus-bom</quarkus.platform.artifact-id>
     <quarkus.platform.version>2.13.9.SP2-redhat-00003</quarkus.platform.version>
     ...
  </properties>
  ...
</project>
      Copy to Clipboard Toggle word wrap

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat