兼容docker-compose、docker compose与docker stack的环境变量配置方案问询

针对三种部署工具的环境变量解析差异，以下是经过验证的通用兼容方案：

1. 区分变量类型选择语法 #

注入宿主机环境变量 #

直接使用${VAR:-默认值}语法，三种工具均支持从部署时的Shell环境读取变量，缺失时使用默认值：

services:
  app:
    environment:
      - DB_HOST=${DB_HOST:-db}
      - REDIS_PORT=${REDIS_PORT:-6379}

• 所有工具都会优先读取当前Shell的对应变量，无值时使用默认值
• docker stack deploy会直接使用部署时Shell的环境变量，与Compose工具行为一致

容器内保留$符号（如Shell内置变量） #

用单引号包裹环境变量值，阻止Compose/Swarm解析$，完全交由容器内的Shell处理：

services:
  app:
    environment:
      - 'APP_HOME=$HOME'
      - 'PATH_OVERRIDE=$PATH:/app/bin'

这种写法下，三个工具都会把$HOME原封不动传递给容器，由容器启动后的Shell解析为自身的环境变量。

2. 替代.env文件：用Swarm Config兼容全场景 #

如果依赖.env文件但docker stack deploy不支持该文件，可以将环境变量存入Swarm Config，同时让Compose工具兼容：

1. 创建Swarm Config（需先初始化Swarm：docker swarm init）：

docker config create app_env .env

2. 在docker-compose.yml中挂载Config并让容器加载：

services:
  app:
    image: my-app-image
    configs:
      - source: app_env
        target: /app/.env
    command: ["/bin/sh", "-c", "set -a; . /app/.env; exec /app/start.sh"]

• docker stack deploy：直接使用Swarm Config加载环境变量
• docker-compose/docker compose：会自动识别Config并挂载为文件，容器通过脚本加载

3. 统一转义$符号的兼容技巧 #

如果需要在容器内传递带$的字符串（如$FOO），避免转义冲突：
在部署前设置环境变量COMPOSE_INTERPOLATION_DEPTH=1，让docker compose（v2）的转义行为与docker-compose（v1）、docker stack deploy对齐：

# 统一设置后执行部署
export COMPOSE_INTERPOLATION_DEPTH=1

# 三种部署命令均可正常使用
docker-compose up -d
docker stack deploy -c docker-compose.yml my-stack
docker compose up -d

此时在yaml中写$$FOO，所有工具都会将其解析为容器内的$FOO。

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