第 1 章 使用属性文件配置红帽构建的 Quarkus 应用程序
作为应用程序开发人员,您可以使用红帽构建的 Quarkus 来创建在 OpenShift 和无服务器环境中运行的 Java 编写的基于微服务的应用程序。编译到原生可执行文件的应用程序占用较小的内存占用和快速启动时间。
您可以使用以下方法之一配置 Quarkus 应用程序:
-
在
application.properties
文件中设置属性 -
通过更新
application.yaml
文件以 YAML 格式应用结构化配置
您还可以通过执行以下操作为应用程序扩展和自定义配置:
- 使用属性表达式替换和制作配置属性值
- 使用自定义配置源转换器实施符合 MicroProfile 规范的类,从不同的外部来源读取配置值
- 使用配置配置集为开发、测试和生产环境保留一组配置值
该流程包括使用 Quarkus config-quickstart
练习创建的配置示例。
先决条件
已安装 OpenJDK 17 或 21,并设置
JAVA_HOME
环境变量来指定 Java SDK 的位置。- 要下载 Red Hat build of OpenJDK,请登录红帽客户门户网站并进入 Software Downloads。
已安装 Apache Maven 3.9.9。
您已将 Maven 配置为使用 Quarkus Maven 存储库中的 工件。
- 要了解如何配置 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 应用程序都可以加载的任何源