如何通过环境变量为Prometheus.yml配置AWS生成的Jenkins唯一URL？

Prometheus默认不会自动解析配置文件里的环境变量，得通过以下几种方式处理：

方法1：用envsubst替换配置模板 #

1. 把你的prometheus.yml改成模板文件，比如prometheus.yml.tmpl，把需要替换的Jenkins URL换成环境变量占位符，示例：

   scrape_configs:
     - job_name: 'jenkins'
       static_configs:
         - targets: ['${JENKINS_URL}']
   

2. 修改Prometheus容器的启动命令，先通过envsubst把模板替换成实际配置，再启动服务：

   envsubst < /etc/prometheus/prometheus.yml.tmpl > /etc/prometheus/prometheus.yml && prometheus --config.file=/etc/prometheus/prometheus.yml
   

3. 多实例场景下，可以用逗号分隔的环境变量（比如JENKINS_URLS=url1,url2），再用tr命令转成数组格式：

   echo 'scrape_configs:
     - job_name: "jenkins"
       static_configs:
         - targets: ["'$(echo $JENKINS_URLS | tr ',' '\",\"')'"]' | envsubst > /etc/prometheus/prometheus.yml
   

方法2：用动态服务发现（file_sd_configs） #

这种方式不用修改主配置，更灵活：

1. 在prometheus.yml里配置文件服务发现：

   scrape_configs:
     - job_name: 'jenkins'
       file_sd_configs:
         - files:
           - /etc/prometheus/jenkins_targets.json
           refresh_interval: 1m
   

2. 启动容器时，用环境变量生成jenkins_targets.json文件：

   echo '[{"targets": ["'${JENKINS_URL}'"], "labels": {"job": "jenkins"}}]' > /etc/prometheus/jenkins_targets.json
   

3. 多实例的话，直接把多个URL塞进targets数组即可：

   echo '[{"targets": ["'$(echo $JENKINS_URLS | tr ',' '\",\"')'"], "labels": {"job": "jenkins"}}]' > /etc/prometheus/jenkins_targets.json
   

方法3：容器编排工具集成（以Docker Compose为例） #

如果用Compose部署，直接在配置里整合替换逻辑：

version: '3'
services:
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml.tmpl:/etc/prometheus/prometheus.yml.tmpl
    environment:
      - JENKINS_URL=http://aws-jenkins-xxx
    command: >
      sh -c "envsubst < /etc/prometheus/prometheus.yml.tmpl > /etc/prometheus/prometheus.yml &&
             prometheus --config.file=/etc/prometheus/prometheus.yml"

注意事项 #

• 先验证环境变量是否传入容器：进入容器执行echo $JENKINS_URL，确认值正确
• 如果配置里有其他$符号（比如Prometheus内置变量），要给envsubst指定只替换特定变量：envsubst '$JENKINS_URL' < template > config
• 动态配置文件要确保Prometheus有读取权限，默认会每分钟刷新一次文件内容

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