第 1 章 使用 YAML 文件配置红帽构建的 Quarkus 应用程序
作为应用程序开发人员,您可以使用红帽构建的 Quarkus 来创建在 OpenShift Container Platform 和无服务器环境中运行的 Java 编写的基于微服务的应用程序。编译到原生可执行文件的应用程序占用较小的内存占用和快速启动时间。
通过更新 application.yaml
文件来配置 Quarkus 应用程序来应用结构化配置。
另外,您可以通过在 application.properties
文件中设置属性来配置 Quarkus 应用程序。如需更多信息,请参阅设置配置属性。
该流程包括使用 Quarkus config-quickstart
练习创建的配置示例。
对于应用程序配置练习的完整示例,请下载 Quarkus Quickstarts 存档或克隆 Quarkus Quickstarts Git 存储库,并进入 config-quickstart
目录。
先决条件
已安装 OpenJDK 17 或 21,并设置
JAVA_HOME
环境变量来指定 Java SDK 的位置。- 要下载红帽 OpenJDK 的构建,请登录红帽客户门户网站并转至 软件下载。
已安装 Apache Maven 3.8.6 或更高版本。
您已将 Apache Maven 配置为使用 Quarkus Maven 存储库中的 工件。
- 要了解如何配置 Apache Maven 设置,请参阅开始使用 Quarkus。
1.1. 配置选项 复制链接链接已复制到粘贴板!
您可以在单个配置文件中管理应用程序的设置。另外,您可以定义配置文件来对不同环境相关的设置进行分组,如开发、测试或生产。这样,您可以在配置集间轻松切换并应用特定于环境的属性,而无需更改主配置文件。
默认情况下,Quarkus 从 src/main/resources
目录中的 application.properties
文件中读取属性。如果希望在 application.yaml
文件中配置和管理应用程序属性,请将 quarkus-config-yaml
依赖项添加到项目的 pom.xml
文件中。如需更多信息,请参阅 添加 YAML 配置支持。
红帽构建的 Quarkus 还支持 MicroProfile 配置,可用于从各种来源加载应用的配置。通过使用 Eclipse MicroProfile 项目中的 MicroProfile 配置规范,您可以将配置属性注入到应用中,并使用您的代码中定义的方法访问它们。
Quarkus 可以从不同的来源读取应用程序属性,包括:
- 文件系统
- 数据库
-
Kubernetes 或 OpenShift Container Platform
ConfigMap
或Secret
对象 - Java 应用程序都可以加载的任何源