求助：Prometheus Blackbox http_2xx模块如何正确使用K8s容器环境变量

问题根源 #

BlackBox Exporter的YAML配置文件不原生支持直接解析shell风格的环境变量（比如$(username)），你写在配置里的$(username)会被当作纯字符串处理，不会自动替换成容器内的环境变量值。

两种可行的解决办法 #

方法1：启动容器时用envsubst替换配置模板占位符

1. 先准备BlackBox配置模板（存为ConfigMap），用${变量名}作为占位符：

basic_auth:
  username: ${USERNAME}
  password: ${PASSWORD}

2. 在K8s Deployment中，修改容器启动逻辑，先通过envsubst将模板中的占位符替换为实际环境变量值，再启动BlackBox：

containers:
- name: blackbox-exporter
  image: prom/blackbox-exporter:latest
  # 先替换模板生成配置文件，再启动 exporter
  command: ["/bin/sh", "-c"]
  args:
  - envsubst < /etc/blackbox/config-template.yaml > /etc/blackbox/config.yaml && /bin/blackbox_exporter --config.file=/etc/blackbox/config.yaml
  # 挂载配置模板
  volumeMounts:
  - name: config-template
    mountPath: /etc/blackbox/config-template.yaml
    subPath: config-template.yaml
  # 从secret注入环境变量
  env:
  - name: USERNAME
    valueFrom:
      secretKeyRef:
        name: my_sec
        key: username
  - name: PASSWORD
    valueFrom:
      secretKeyRef:
        name: my_sec
        key: password
volumes:
- name: config-template
  configMap:
    name: blackbox-config-template  # 上面的配置模板要先创建成这个ConfigMap

注意：官方的prom/blackbox-exporter镜像默认不带envsubst命令，需要自行构建镜像时安装gettext包（比如在Dockerfile中添加apk add --no-cache gettext），或者使用包含该命令的基础镜像。

方法2：将完整配置存入Secret并直接挂载

如果你的BlackBox配置仅有basic auth需要动态值，可直接把包含真实用户名密码的完整配置存入Vault，同步到K8s Secret后，挂载为BlackBox的配置文件：

containers:
- name: blackbox-exporter
  image: prom/blackbox-exporter:latest
  args:
  - --config.file=/etc/blackbox/config.yaml
  volumeMounts:
  - name: blackbox-config
    mountPath: /etc/blackbox/config.yaml
    subPath: config.yaml
volumes:
- name: blackbox-config
  secret:
    secretName: my_sec  # 该Secret中需包含完整的config.yaml内容

这种方式无需额外的替换逻辑，适合配置内容固定、仅敏感信息动态生成的场景。

额外验证点 #

• 确认容器内的USERNAME、PASSWORD环境变量确实存在（你已经通过printenv验证，这一步没问题）
• 使用方法1时，注意环境变量名的大小写（shell环境变量通常为大写，模板中的占位符要对应一致）

内容的提问来源于stack exchange，提问作者NiveditaK