5.4. 使用环境变量覆盖管理属性

您知道，您可以使用 Java 系统属性或环境变量解析通过表达式定义的管理属性，但您也可以修改其他属性，即使它们不使用表达式。

为了更轻松地将 JBoss EAP 服务器配置适应您的服务器环境，您可以使用环境变量覆盖任何管理属性的值，而无需编辑配置文件。此功能（从 JBoss EAP 版本 8.0 开始）可用于以下原因：

JBoss EAP 仅为其最常见的管理属性提供表达式。现在，您可以更改没有定义表达式的属性值。
有些管理属性将 JBoss EAP 服务器与其他服务（如数据库）连接，您可以提前知道其值，或者您无法存储在配置中的值；例如，在数据库凭证中。通过使用环境变量，您可以在 JBoss EAP 服务器运行时延迟这些属性的配置。

重要

此功能默认为启用，从 JBoss EAP 版本 8.0 OpenShift 运行时镜像开始。要在其他平台上启用它，您必须将 WILDFLY_OVERRIDING_ENV_VARS 环境变量设置为任何值；例如，导出 WILDFLY_OVERRIDING_ENV_VARS=1。

注意

您不能覆盖其 类型为 LIST、OBJECT 或 PROPERTY 的管理属性。

先决条件

流程

要使用环境变量覆盖 management 属性，请完成以下步骤：

识别您要更改的资源和属性的路径。例如，将资源 /subsystem=undertow/server=default-server/http-listener=default 的 proxy-address-forwarding 属性的值设置为 true。
通过映射资源地址和管理属性来创建环境变量名称来覆盖此属性，如下所示：
1. 从资源地址中删除第一个斜杠(/)： /subsystem=undertow/server=default-server/http-listener=default 变为 subsystem=undertow/server=default-server/http-listener=default。
2. 附加两个下划线(__)和属性名称；例如： subsystem=undertow/server=default-server/http-listener=default__proxy-address-forwarding。
3. 将所有非字母数字字符替换为下划线(_)，并将整个代码行放在所有大写字母中： SUBSYSTEM_UNDERTOW_SERVER_DEFAULT_SERVER_HTTP_LISTENER_DEFAULT__PROXY_ADDRESS_FORWARDING。
设置环境值： SUBSYSTEM_UNDERTOW_SERVER_DEFAULT_SERVER_HTTP_LISTENER_DEFAULT__PROXY_ADDRESS_FORWARDING=true。

注意

这些值是必须替换为您的实际配置值的示例。

返回顶部