1.3. 在命令行中创建红帽构建的 Quarkus 项目


在命令行中使用 Red Hat build of Quarkus Maven 插件创建一个 Quarkus 项目,方法是在命令行上提供属性和值,或者在交互模式中使用插件。您还可以使用 Quarkus 命令行界面(CLI)创建 Quarkus 项目。生成的项目包括以下元素:

  • Maven 结构
  • 关联的单元测试
  • 启动应用程序后,可在 http://localhost:8080 上访问的登录页面
  • src/main/docker中的 JVM 和原生模式的 Dockerfile 文件示例
  • 应用程序配置文件

先决条件

  • 已安装 OpenJDK 11 或 17。

    • 要下载红帽构建的 OpenJDK,请登录到红帽客户门户网站,再进入 Software Downloads
  • 您已设置了 JAVA_HOME 环境变量,以指定 Java SDK 的位置。
  • 已安装 Apache Maven 3.8.6 或更高版本。

  • 已安装 Quarkus 命令行界面(CLI),这是可用于创建 Quarkus 项目的方法之一。如需更多信息 ,请参阅安装 Quarkus CLI
注意

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

流程

  1. 在命令终端中,输入以下命令验证 Maven 是否使用 OpenJDK 11 或 17,并且 Maven 版本是否为 3.8.6 或更高版本:

    mvn --version
    Copy to Clipboard Toggle word wrap
  2. 如果前面的命令没有返回 OpenJDK 11 或 17,请将到 OpenJDK 11 或 17 的路径添加到 PATH 环境变量中,然后再次输入前面的命令。
  3. 要使用 Quarkus Maven 插件创建项目,请使用以下方法之一:

    • 输入以下命令:

      mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:create \
          -DprojectGroupId=<project_group_id> \
          -DprojectArtifactId=<project_artifact_id> \
          -DplatformGroupId=com.redhat.quarkus.platform \
          -DplatformArtifactId=quarkus-bom \
          -DplatformVersion=3.2.12.SP1-redhat-00003
          -DpackageName=getting.started
      Copy to Clipboard Toggle word wrap

      在这个命令中,替换以下值:

      • <project_group_id > : 项目的唯一标识符
      • <project_artifact_id > : 项目名称和项目目录的名称
    • 以互动模式创建项目:

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

      出现提示时,输入所需的属性值。

      注意

      您还可以输入以下命令使用项目属性的默认值创建项目:

      mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:create -B

    • 使用 Red Hat build of Quarkus CLI 创建项目:

      quarkus create app my-groupId:my-artifactId --package-name=getting.started
      Copy to Clipboard Toggle word wrap
      • 您还可以通过以下方式获取可用选项列表:

        quarkus create app --help
        Copy to Clipboard Toggle word wrap

下表列出了您可以使用 create 命令定义的属性:

Expand
属性默认值描述

projectGroupId

org.acme

项目的唯一标识符。

projectArtifactId

code-with-quarkus

项目和项目目录的名称。如果没有指定 projectArtifactId 属性,Maven 插件会启动交互模式。如果目录已存在,则生成会失败。

projectVersion

1.0-SNAPSHOT

项目的版本。

platformGroupId

com.redhat.quarkus.platform

您的平台组 ID。所有现有的平台都由 com.redhat.quarkus.platform 提供。但是,您可以更改默认值。

platformArtifactId

quarkus-bom

平台 BOM 的工件 ID。

platformVersion

最新平台版本,如 3.2.12.SP1-redhat-00003

您要用于项目的平台版本。当您提供版本范围时,Maven 插件使用最新版本。

packageName

[]

入门软件包 get .started 的名称。

extensions

[]

要添加到项目的扩展列表,用逗号分开。

注意

默认情况下,Quarkus Maven 插件使用最新的 quarkus-bom 文件。quarkus-bom 文件聚合扩展,以便您可以从应用程序中引用它们以匹配依赖项版本。当您离线时,Quarkus Maven 插件使用 quarkus-bom 文件的最新本地可用版本。如果 Maven 找到 quarkus-bom 版本 2.0 或更早版本,它将使用基于 quarkus-bom 的平台。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat