运行docker-compose up时telegraf配置文件挂载卷格式错误如何解决

问题原因 #

该报错的核心诱因有两个：

1. 本地待挂载的./telegraf.conf不是普通文件：如果本地不存在该文件、或者误创建为目录，Docker Compose会默认将其识别为目录挂载，短格式挂载字符串的解析逻辑会匹配失败。
2. 短格式挂载字符串的解析歧义：旧版Compose对包含特殊字符、或者路径层级较多的短格式挂载，偶尔会出现解析错误。
   你之前将version字段修改为Docker引擎版本的操作是错误的：version字段对应Docker Compose文件的格式版本，和Docker引擎版本无直接对应关系。

修复步骤 #

步骤1：确认本地配置文件存在且正确 #

首先在docker-compose.yml所在目录执行以下命令，确认telegraf.conf是普通文件：

ls -l ./telegraf.conf

如果文件不存在，直接从官方镜像中导出默认配置到本地：

docker run --rm telegraf:1.19.2-alpine cat /etc/telegraf/telegraf.conf > ./telegraf.conf

如果本地是同名目录，先删除目录再执行上述导出命令。

步骤2：修改挂载格式为长格式（避免解析歧义） #

将docker-compose.yml的version字段从"2"修改为"2.4"（v2格式的最终稳定版，完全兼容你当前的环境），同时将telegraf服务的短格式挂载替换为长格式配置：

telegraf:
  image: telegraf:1.19.2-alpine
  container_name: telegraf
  platform: linux/x86_64
  mem_limit: 128M
  depends_on:
    - influxdb
  links:
    - influxdb
  ports:
    - "8125:8125/udp"
  volumes:
    # 替换原来的短格式挂载
    - type: bind
      source: ./telegraf.conf
      target: /etc/telegraf/telegraf.conf
      read_only: true

步骤3：校验配置并启动 #

修改完成后先执行配置校验命令，确认无语法错误：

docker-compose config

校验通过后再正常启动服务即可：

docker-compose up -d

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