Skip to main content

config.yaml

ipmideck 从 data/config.yaml 读取其设置,该文件在首次运行时以合理的 默认值写入。你可以直接编辑该文件,或在运行时用环境变量 覆盖任意值(对 Docker 很方便,见下文)。
上面的键是 ipmideck 写入 config.yaml 的真实的、无前缀的嵌套键。 环境变量覆盖使用单独的 IPMIDECK_ 前缀,绝不会出现在 YAML 文件本身内部。

环境覆盖

每个设置都可以在运行时用带 IPMIDECK_ 前缀的环境变量覆盖。 这是在 Docker 中配置 ipmideck 最简单的方式,因为你不想 编辑容器内部的文件。 另外两个变量控制文件的位置,而不是 config.yaml 的值: IPMIDECK_DATA_DIR(数据目录,见下文)和 IPMIDECK_CONFIG_PATH(要 加载的 config.yaml 的显式路径)。
环境变量优先于 config.yaml 中的值。在你的 docker run 命令 (-e IPMIDECK_SERVER_PORT=8080)或你的 docker-compose.yml 中设置它们。

配置文件位于何处

ipmideck 如果设置了 IPMIDECK_DATA_DIR 就从中解析其数据目录,否则回退 到平台默认值。config.yaml 始终位于 <data-dir>/config.yaml
  • Docker: /data/config.yaml:镜像设置 IPMIDECK_DATA_DIR=/data;用卷使 /data 持久化。
  • Linux 上的 pip: 默认 /data/config.yaml:设置 IPMIDECK_DATA_DIR 以重新定位。
  • Windows 上的 pip: ./data/config.yaml,相对于你运行 ipmideck 的目录。

后续步骤

  • 安全:凭据和会话如何受到保护。
  • 功能:每个模块做什么。