Spring Boot项目中Alertmanager无法读取.env配置值至alertmanager.yml的解决方法

问题根源：Alertmanager本身不支持自动将配置文件中的${变量名}替换为环境变量值，它会把${ALERT_RESOLVE_TIMEOUT}当成字面量字符串解析，导致时长格式错误。

以下是两种可行的解决方案：

方案一：使用envsubst实时替换配置模板 #

这是最常用的轻量方案，利用Linux自带的envsubst工具在容器启动时完成变量替换：

1. 重命名配置文件为模板
   将原alertmanager.yml改名为alertmanager.yml.tmpl，保留原内容中的${变量}占位符不变。

2. 修改docker-compose.yml的Alertmanager配置
   更新command部分，先通过envsubst生成实际配置文件，再启动Alertmanager：

alertmanager:
    image: prom/alertmanager:latest
    container_name: alertmanager
    restart: unless-stopped
    ports:
      - "9093:9093"
    volumes:
      - ./data/alertmanager/config:/etc/alertmanager
    env_file:
      - .env
    command:
      - sh
      - -c
      - 'envsubst < /etc/alertmanager/alertmanager.yml.tmpl > /etc/alertmanager/alertmanager.yml && alertmanager --config.file=/etc/alertmanager/alertmanager.yml'
    networks:
      - pdfcompare_network

可选优化：如果担心envsubst误替换配置中其他$符号（比如正则表达式），可以指定仅替换需要的变量：

envsubst '$ALERT_RESOLVE_TIMEOUT $SMTP_SMARTHOST $SMTP_FROM $SMTP_AUTH_USERNAME $SMTP_AUTH_PASSWORD $SMTP_REQUIRE_TLS $ALERT_EMAIL_TO' < /etc/alertmanager/alertmanager.yml.tmpl > /etc/alertmanager/alertmanager.yml

方案二：使用自定义启动脚本 #

如果需要更复杂的逻辑，可编写启动脚本：

1. 创建启动脚本start.sh
   在./data/alertmanager/config目录下创建脚本：

#!/bin/sh
# 替换模板变量生成配置文件
envsubst < /etc/alertmanager/alertmanager.yml.tmpl > /etc/alertmanager/alertmanager.yml
# 启动Alertmanager
exec alertmanager --config.file=/etc/alertmanager/alertmanager.yml

2. 给脚本添加执行权限
   在宿主机执行：

chmod +x ./data/alertmanager/config/start.sh

3. 修改docker-compose.yml的command

alertmanager:
    # 其他配置不变
    command: ["/etc/alertmanager/start.sh"]

验证解决方案 #

启动容器后，可进入容器检查生成的alertmanager.yml：

docker exec -it alertmanager cat /etc/alertmanager/alertmanager.yml

确认所有${变量}都已被.env中的实际值替换即可。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu