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 或更高版本。
- 要下载 Maven,请转至 Apache Maven 项目网站。
- 已安装 Quarkus 命令行界面(CLI),这是可用于创建 Quarkus 项目的方法之一。如需更多信息 ,请参阅安装 Quarkus CLI。
Quarkus CLI 仅用于 dev 模式。红帽不支持在生产环境中使用 Quarkus CLI。
流程
在命令终端中,输入以下命令验证 Maven 是否使用 OpenJDK 11 或 17,并且 Maven 版本是否为 3.8.6 或更高版本:
mvn --version
mvn --version
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 如果前面的命令没有返回 OpenJDK 11 或 17,请将到 OpenJDK 11 或 17 的路径添加到 PATH 环境变量中,然后再次输入前面的命令。
要使用 Quarkus Maven 插件创建项目,请使用以下方法之一:
输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在这个命令中,替换以下值:
-
<project_group_id
> : 项目的唯一标识符 -
<project_artifact_id
> : 项目名称和项目目录的名称
-
以互动模式创建项目:
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:create
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:create
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出现提示时,输入所需的属性值。
注意您还可以输入以下命令使用项目属性的默认值创建项目:
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
quarkus create app my-groupId:my-artifactId --package-name=getting.started
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 您还可以通过以下方式获取可用选项列表:
quarkus create app --help
quarkus create app --help
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
下表列出了您可以使用 create
命令定义的属性:
属性 | 默认值 | 描述 |
---|---|---|
|
| 项目的唯一标识符。 |
|
|
项目和项目目录的名称。如果没有指定 |
|
| 项目的版本。 |
|
|
您的平台组 ID。所有现有的平台都由 |
|
| 平台 BOM 的工件 ID。 |
|
最新平台版本,如 | 您要用于项目的平台版本。当您提供版本范围时,Maven 插件使用最新版本。 |
| [] |
入门软件包 get |
| [] | 要添加到项目的扩展列表,用逗号分开。 |
默认情况下,Quarkus Maven 插件使用最新的 quarkus-bom
文件。quarkus-bom
文件聚合扩展,以便您可以从应用程序中引用它们以匹配依赖项版本。当您离线时,Quarkus Maven 插件使用 quarkus-bom
文件的最新本地可用版本。如果 Maven 找到 quarkus-bom
版本 2.0 或更早版本,它将使用基于 quarkus-bom
的平台。