使用docker compose convert --no-interpolate合并配置文件时出现未定义卷错误的求助

我明白你的困扰——你想合并主配置和override文件，同时保留所有环境变量不被插值，但用--no-interpolate参数时却遇到了卷未定义的错误。让我来帮你分析问题原因并给出解决方案。

问题根源 #

当你加上--no-interpolate参数时，Docker Compose会完全跳过所有环境变量的解析，包括你在挂载路径里的${PWD}。这时候，Docker Compose会把${PWD}/config/gateway/gateway-configuration.ini当成一个命名卷的名称，而不是绑定挂载的路径。但你的配置文件里并没有定义这个名称的卷，所以就抛出了"undefined volume"的错误。

解决方案 #

解决思路很简单：把挂载路径里的${PWD}/替换成相对路径./，这样即使不插值，Docker Compose也能识别出这是一个绑定挂载（而不是命名卷），同时其他变量（比如${REPO}、${ALGO}）依然会被保留下来。

步骤1：修改原配置文件里的挂载路径

打开你的docker-compose.yaml，把所有带${PWD}的挂载项替换成相对路径：

# redis-db挂载修改后
- ./config/redis/redis.conf:/usr/local/etc/redis/redis.conf:ro

# runner挂载修改后
- ./config/runner/runner-configuration.ini:/configuration.ini:ro
- "./solutions/${ALGO}:/home/scripts/algorithmic_solutions_list.txt:ro"

# gateway挂载修改后
- ./config/gateway/gateway-configuration.ini:/configuration.ini:ro

步骤2：重新运行合并命令

修改完成后，再执行你原来的命令：

docker compose -f docker-compose.yaml -f docker-compose.override.yaml convert --no-interpolate > new-docker-compose.yaml

这样生成的new-docker-compose.yaml会保留所有你需要的变量（比如${REPO}、${ALGO}、${RUNNER_GPU_IMAGE}等），同时挂载路径会以相对路径./的形式保留，不会触发命名卷的错误。

为什么这个方法有效？ #

Docker Compose对绑定挂载的识别规则是：

• 如果路径以/开头（绝对路径）或者.//../开头（相对路径），会被识别为绑定挂载；
• 如果路径是纯字符串（比如${PWD}/xxx在不插值的情况下），会被识别为命名卷的名称。

用./替换${PWD}/后，即使不插值，Docker Compose也能正确识别这是相对路径的绑定挂载，自然就不会报错了。

备注：内容来源于stack exchange，提问作者XDavidT