第 1 章 使用属性文件配置 Quarkus 应用程序
作为应用程序开发人员,您可以使用 Red Hat build of Quarkus 创建使用 Java 在 OpenShift 和无服务器环境中运行的基于微服务的应用程序。编译到原生可执行文件的应用程序具有较少的内存占用率和快速启动时间。
您可以使用以下方法之一配置 Quarkus 应用程序:
-
在
application.properties文件中设置属性 -
通过更新
application.yaml文件以 YAML 格式应用结构化配置
您还可以通过执行以下操作来扩展和自定义应用程序的配置:
- 使用属性表达式替换和组合配置属性值
- 使用自定义配置源转换器实施符合 MicroProfile 规范的类,从不同的外部来源读取配置值
- 使用配置配置集为您的开发、测试和生产环境维护单独的配置值集合
该流程包括使用 Quarkus config-quickstart exercise 创建的配置示例。
先决条件
已安装 OpenJDK 11 或 17,并设置
JAVA_HOME环境变量来指定 Java SDK 的位置。- 要下载红帽构建的 OpenJDK,请登录到红帽客户门户网站,再进入 Software Downloads。
已安装 Apache Maven 3.8.x,其中 x 是 6 或更高版本。
- 从 Apache Maven Project 网站下载 Maven。
您已将 Maven 配置为使用 Quarkus Maven 存储库中的 工件。
- 要了解如何配置 Maven 设置,请参阅开始使用 Quarkus。
1.1. 红帽配置选项 复制链接链接已复制到粘贴板!
配置选项允许您在单个配置文件中更改应用程序的设置。Red Hat build of Quarkus 支持用于对相关属性进行分组的配置文件,并根据需要在配置集间切换。
默认情况下,Quarkus 从 src/main/resources 目录中的 application.properties 文件中读取属性。您还可以将 Quarkus 配置为从 YAML 文件中读取属性。
当您将 quarkus-config-yaml 依赖项添加到项目 pom.xml 文件时,您可以在 application.yaml 文件中配置和管理应用程序属性。如需更多信息,请参阅 添加 YAML 配置支持。
红帽构建的 Quarkus 还支持 MicroProfile Config,它可让您从其他来源加载应用的配置。
您可以使用 Eclipse MicroProfile 项目的 MicroProfile Config 规范将配置属性注入到应用中,并使用代码中定义的方法访问它们。
Quarkus 也可以从不同的来源读取应用程序属性,包括以下源:
- 文件系统
- 数据库
-
Kubernetes 或 OpenShift Container Platform
ConfigMap或 Secret 对象 - Java 应用程序可以加载的任何源