如何使用docker-compose向所有Docker服务批量注入环境变量

存在两种常用的实现方案，都不需要在每个服务中单独逐一声明环境变量：

方案1：使用YAML扩展字段统一定义环境变量 #

利用docker compose支持的x-开头的自定义扩展字段，搭配YAML锚点语法实现配置复用，仅需定义一次全局环境变量组，所有服务直接引用即可，也支持叠加服务独有的环境变量：

# 顶部定义全局环境变量扩展锚点
x-global-envs: &global-envs
  TZ: Asia/Shanghai
  RUNTIME_ENV: production
  LOG_LEVEL: info

services:
  web:
    image: nginx:alpine
    environment:
      # 直接继承所有全局变量
      <<: *global-envs
      # 可额外添加服务独有变量
      NGINX_LISTEN_PORT: 80
  api:
    image: node:18-alpine
    environment:
      <<: *global-envs

方案2：统一挂载全局环境变量文件 #

如果全局变量较多，建议统一存放到独立的环境变量文件（例如common.env）中，文件格式为每行一条KEY=VALUE配置，示例：

# common.env内容
TZ=Asia/Shanghai
RUNTIME_ENV=production
LOG_LEVEL=info

同样通过扩展字段批量引用，无需在每个服务中单独填写文件路径，也无需逐行声明变量：

# 顶部定义全局环境变量文件锚点
x-common-env-file: &common-env-file
  env_file: common.env

services:
  web:
    image: nginx:alpine
    <<: *common-env-file
  db:
    image: mysql:8.0
    <<: *common-env-file
    # 可额外叠加服务专属的环境变量文件
    env_file:
      - common.env
      - mysql/mysql.env

补充说明 #

• 以上两种方案中，全局配置的优先级都低于服务单独声明的同名配置，不会覆盖服务自定义的环境变量，符合常规使用逻辑。
• 如果你需要实现完全无需在服务配置中添加任何引用代码的自动全局注入，目前docker compose原生不支持该能力，可以自行编写预处理脚本动态生成compose配置文件实现，不过上述两种方案已经可以满足绝大多数场景下「无需单独显式声明每一条全局环境变量」的需求。

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