如何一次性将单域下所有通用环境变量传递给Docker Swarm服务？

一、Docker Swarm原生实现方式 #

1. 使用Config存储通用环境变量文件 #

Docker Swarm的config功能可集中存储通用环境变量文件，让所有服务挂载并加载该文件：

• 先创建包含通用环境变量的common.env文件：

  DB_HOST=db.example.com
  REDIS_PORT=6379
  LOG_LEVEL=info
  

• 创建Swarm配置：

  docker config create common-env ./common.env
  

• 部署服务时挂载该配置，并在启动命令中加载变量：

  version: '3.8'
  configs:
    common_env:
      external: true # 引用已创建的config
  services:
    web:
      image: nginx:alpine
      configs:
        - source: common_env
          target: /etc/common.env
      command: sh -c "source /etc/common.env && nginx -g 'daemon off;'"
  

2. 结合.env文件与docker stack deploy #

通过docker stack deploy部署整个栈时，可指定全局环境变量文件，栈内所有服务会继承这些变量：

• 创建stack.env文件：

  COMMON_API_URL=https://api.example.com
  COMMON_TIMEOUT=30s
  

• 部署栈时加载该文件：

  docker stack deploy --env-file stack.env -c docker-compose.yml my-stack
  

  注：若单个服务需要覆盖变量，可在compose文件中单独定义。

二、第三方工具/镜像方案 #

1. Consul + envconsul #

Consul作为服务发现与KV存储工具，配合envconsul可从Consul KV拉取环境变量并启动应用：

• 在Swarm中部署Consul服务：

  services:
    consul:
      image: consul:latest
      deploy:
        mode: replicated
        replicas: 1
      networks:
        - common-net
  

• 将通用环境变量存入Consul KV：

  docker exec -it <consul-container-id> consul kv put common/env/DB_HOST db.example.com
  docker exec -it <consul-container-id> consul kv put common/env/REDIS_PORT 6379
  

• 部署业务服务时用envconsul作为入口，自动拉取变量：

  services:
    app:
      image: your-app-image
      entrypoint: ["envconsul", "-consul", "consul:8500", "-prefix", "common/env", "--"]
      command: ["./your-app"]
      networks:
        - common-net
  

2. HashiCorp Vault + Vault Agent #

若需管理敏感环境变量，Vault更适合。通过Vault Agent可自动将变量注入服务容器：

• 在Swarm中部署Vault服务并配置KV存储，存入通用或敏感变量。
• 业务服务容器中运行Vault Agent，通过模板生成环境变量文件并加载，再启动应用。

三、总结 #

仅需简单统一管理通用环境变量时，Docker Swarm原生的config或--env-file方案足够轻量；若需动态更新变量、敏感数据管理或复杂配置生命周期管理，Consul或Vault这类工具更适配。

内容的提问来源于stack exchange，提问作者Yunus Üstün