红帽全球峰会1.2. 准备您的环境
在开始使用 Quarkus 前，您必须准备您的环境。
流程
确认您的系统中完成了以下安装：
已安装 OpenJDK 17 或 21，并设置
JAVA_HOME环境变量来指定 Java SDK 的位置。- 要下载红帽 OpenJDK 的构建，请登录红帽客户门户网站并转至 软件下载。
- 已安装 Apache Maven 3.9.9。Apache Maven 位于 Apache Maven 项目网站。
可选 ：如果要使用 Quarkus 命令行界面(CLI)，请确保已安装它。
- 有关如何安装 Quarkus CLI 的说明，请参阅 Quarkus CLI 中的特定于社区的信息。
Quarkus CLI 主要用于开发目的，包括创建、更新和构建 Quarkus 项目等任务。但是，红帽不支持在生产环境中使用 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 的一个片段，所以您可以在不造成冲突的情况下以任何顺序导入 member BOM。
1.2.2. 关于 Apache Maven 和红帽构建的 Quarkus
Apache Maven 是一个分布式构建自动化工具，用于 Java 应用程序开发来创建、管理和构建软件项目。
要了解更多有关 Apache Maven 的信息，请参阅 Apache Maven 文档。
Maven 存储库
Maven 存储库存储 Java 库、插件和其他构建构件。默认公共存储库是 Maven 2 Central Repository，但存储库可以是私有和内部存储库，以在开发团队之间共享通用工件。存储库也可由第三方获得。
您可以将红帽托管的 Maven 存储库用于 Quarkus 项目。
Maven 插件
Maven 插件是 POM 文件的定义部分，该文件运行一个或多个任务。红帽构建的 Quarkus 应用程序使用以下 Maven 插件：
-
Quarkus Maven 插件(
quarkus-maven-plugin) ：启用 Maven 创建 Quarkus 项目，将应用程序打包到 JAR 文件，并提供 dev 模式。 -
Maven Surefire 插件(
maven-surefire-plugin): 当 Quarkus 启用测试配置集时，在构建生命周期的测试阶段使用 Maven Surefire 插件来对应用程序运行单元测试。该插件生成包含测试报告的文本和 XML 文件。
其他资源
1.2.3. 为在线存储库配置 Maven settings.xml 文件
要将红帽托管的 Quarkus 存储库与您的 Quarkus Maven 项目一起使用，请为您的用户配置 settings.xml 文件。与存储库管理器或共享服务器上的存储库一起使用的 Maven 设置可以提供更好的控制和管理性。
当您通过修改 Maven settings.xml 文件配置存储库时，更改会应用到所有 Maven 项目。如果您只想将配置应用到特定的项目，请使用 the -s 选项并指定特定于项目的 settings.xml 文件的路径。
流程
在文本编辑器中或集成开发环境(IDE)中打开 Maven
$HOME/.m2/settings.xml文件。注意如果
$HOME/.m2/目录中没有settings.xml文件，请将$MAVEN_HOME/conf/目录中的settings.xml文件复制到$HOME/.m2/目录中。在
settings.xml文件的<profiles> 元素中添加以下行：<!-- Configure the Red Hat build of 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>在
settings.xml文件的 <activeProfiles> 元素中添加以下行并保存文件。<activeProfile>red-hat-enterprise-maven-repository</activeProfile>
1.2.4. 将您的 Maven 项目重新配置为红帽构建的 Quarkus
您可以通过更改项目 POM 文件中的 Maven 配置，将 Quarkus 社区项目迁移到红帽构建的 Quarkus。
先决条件
-
您有一个使用 Maven 构建的 Quarkus 项目，它依赖于
pom.xml文件中的 Quarkus 社区工件。
流程
更改项目的
pom.xml文件的<properties> 部分中的以下值：-
将 <
quarkus.platform.group-id>属性的值改为com.redhat.quarkus.platform。 将 <
quarkus.platform.version>属性的值改为3.20.0.redhat-00002。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>3.20.0.redhat-00002</quarkus.platform.version> ... </properties> ... </project>
-
将 <
