1.3. 在命令行中创建红帽构建的 Quarkus 项目
在命令行中使用 Red Hat build of Quarkus Maven 插件创建一个 Quarkus 项目,方法是在命令行上提供属性和值,或者在交互模式中使用插件。您还可以使用 Quarkus 命令行界面(CLI)创建 Quarkus 项目。生成的项目包括以下元素:
- Maven 结构
- 关联的单元测试
-
启动应用程序后,可在
http://localhost:8080上访问的登录页面 -
src/main/docker中的 JVM 和原生模式的Dockerfile文件示例 - 应用程序配置文件
先决条件
已安装 OpenJDK 17 或 21。
- 要下载红帽构建的 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 17 或 21,并且 Maven 版本是否为 3.8.6 或更高版本:
mvn --version
mvn --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 如果前面的命令没有返回 OpenJDK 17 或 21,请将到 OpenJDK 17 或 21 的路径添加到 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.8.6.SP1-redhat-00002:create
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.8.6.SP1-redhat-00002:createCopy to Clipboard Copied! Toggle word wrap Toggle overflow 出现提示时,输入所需的属性值。
注意您还可以输入以下命令使用项目属性的默认值创建项目:
mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.8.6.SP1-redhat-00002:create -B使用 Quarkus CLI。输入以下命令:
quarkus create app my-groupId:my-artifactId --package-name=getting.started
quarkus create app my-groupId:my-artifactId --package-name=getting.startedCopy to Clipboard Copied! Toggle word wrap Toggle overflow 您还可以通过以下方式获取可用选项列表:
quarkus create app --help
quarkus create app --helpCopy to Clipboard Copied! Toggle word wrap Toggle overflow
默认情况下,Quarkus Maven 插件使用最新的 quarkus-bom 版本。quarkus-bom 文件聚合扩展,以便您可以从应用程序中引用它们以匹配依赖项版本。当您离线时,Quarkus Maven 插件使用从 Maven 存储库拉取更新的最新 quarkus-bom 版本。