如何在Docker Compose YAML中通过环境变量配置日志选项名称？

Docker Compose的变量替换仅支持替换YAML值，不支持替换YAML的键（即options内的配置项名称），所以直接在键位置写${VAR-default}无法生效。以下是几种无需修改主YAML即可适配不同日志驱动的可行方案：

1. 用Compose Profiles拆分环境配置 #

通过Profiles为不同环境定义独立的日志配置，启动时指定对应Profile即可切换。

示例配置：

services:
  app:
    image: my-app:latest
    # 基础通用配置
    profiles: ["dev"]
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

  app-prod:
    extends: app
    profiles: ["prod"]
    logging:
      driver: syslog
      options:
        syslog-address: "tcp://logs.example.com:514"
        tag: "{{.Name}}"

启动命令：

• 开发环境：docker compose --profile dev up -d
• 生产环境：docker compose --profile prod up -d

2. 用扩展字段+环境变量选择配置块 #

先定义不同环境的日志配置锚点，再通过环境变量选择加载哪个配置块，实现动态切换。

示例配置：

# 定义不同环境的日志配置锚点
x-logging-dev: &logging-dev
  driver: json-file
  options:
    max-size: "10m"
    max-file: "3"

x-logging-prod: &logging-prod
  driver: syslog
  options:
    syslog-address: "tcp://logs.example.com:514"
    tag: "{{.Name}}"

services:
  app:
    image: my-app:latest
    # 环境变量LOG_CONFIG指定用哪个锚点，默认用dev配置
    logging: ${LOG_CONFIG:-*logging-dev}

启动命令：

• 默认（dev）：docker compose up -d
• 切换到prod：LOG_CONFIG=*logging-prod docker compose up -d

3. 用多Compose文件合并配置 #

创建基础配置文件和环境专属配置文件，通过COMPOSE_FILE环境变量指定加载组合，让环境配置覆盖基础配置。

1. 基础配置docker-compose.yml：

services:
  app:
    image: my-app:latest
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

2. 生产环境配置docker-compose.prod.yml：

services:
  app:
    logging:
      driver: syslog
      options:
        syslog-address: "tcp://logs.example.com:514"

3. 启动时指定组合文件：

# 开发环境直接用基础文件
docker compose up -d

# 生产环境合并两个文件，prod配置覆盖基础
COMPOSE_FILE=docker-compose.yml:docker-compose.prod.yml docker compose up -d

4. 用模板工具预处理配置 #

如果需要更灵活的键替换，可将Compose文件写成模板，用envsubst这类工具预处理后再启动，原模板无需修改。

示例模板docker-compose.template.yml：

services:
  app:
    image: my-app:latest
    logging:
      driver: ${LOG_DRIVER-json-file}
      options:
        ${LOGOPT1_NAME-max-size}: ${LOGOPT1_VALUE-10m}
        ${LOGOPT2_NAME-max-file}: ${LOGOPT2_VALUE-3}

预处理并启动：

# 生成最终配置文件
envsubst < docker-compose.template.yml > docker-compose.yml

# 启动服务
docker compose up -d

内容的提问来源于stack exchange，提问作者Neil C. Obremski