运行配置与环境变量
管理员可以通过接口查看和修改 ems.yaml 中的受支持配置,保留原文件注释;批量部署时也可以用环境变量覆盖。
看清配置来源
Section titled “看清配置来源”查询结果同时提供文件值、运行值、覆盖来源和可编辑状态:
| 字段 | 用途 |
|---|---|
value |
文件中保存的值,敏感项会掩码显示 |
runtimeValue |
当前进程内的值 |
effectiveSource / envName |
是否由环境变量覆盖,以及对应变量名 |
editable |
当前是否允许通过配置接口修改 |
环境变量覆盖的配置不能从页面或配置接口修改;应在部署环境调整对应变量,并按要求重启。
修改后的生效方式
Section titled “修改后的生效方式”配置项可能立即生效、需要重启,或仅写入文件。以接口元数据和返回提示为准;运行值改变不一定意味着连接池、目录等启动期资源已重新创建。
敏感项的掩码不是实际凭据,不应把掩码作为新值提交。
使用 GET /ems-yaml-config/list 查询,POST /ems-yaml-config/update 提交 {"values":{"<配置键>":"<新值>"}}。两者均需要管理员权限。