Docker挂载配置文件却变成目录:检查宿主路径
适用范围:Docker Engine和Compose绑定挂载;不要直接删除未知目录或数据库挂载。
本来想把一个配置文件挂进容器,结果容器看到的却是目录,通常先检查宿主源路径。使用某些简写挂载形式时,不存在的源路径可能被自动创建成目录;这不是配置文件成功生成了。
先看源路径和目标类型
在Docker守护进程所在机器执行,不是在随便一台运行客户端的电脑上检查:
ls -ld -- /srv/app/config.yml
file -- /srv/app/config.yml
docker inspect --format '{{json .Mounts}}' app
把容器名和路径换成实际值。检查Type、Source、Destination,以及目标是文件还是目录。不要为看挂载而把完整inspect输出公开,其中可能含环境变量凭据。[1]
分清-v与--mount的缺失路径行为
Docker Engine的 -v 宿主路径:容器路径 在缺失源路径时可能创建目录。--mount type=bind 默认会对不存在的源路径报错,能更早暴露拼写问题。[1]
需要挂载单个文件时,先明确创建和检查该文件,再配置只读挂载。配置文件丢失不能用空文件占位掩盖,否则程序可能按不安全的默认值启动。
在Compose中避免无意创建目录
可在现有文件的volumes片段采用长语法:
volumes:
- type: bind
source: /srv/app/config.yml
target: /app/config.yml
read_only: true
bind:
create_host_path: false
该片段需放到具体服务下。用当前Compose版本验证是否支持,并先确认源文件存在;相对路径还要核对配置文件基准目录。[2]
已经生成的错误目录怎样处理
先停止或迁移受影响的测试服务,查看目录是否被其他容器使用、里面是否有数据,再备份。只有确认是本次错误生成且无业务内容,才按变更流程移走或清理,并恢复正确文件。不要直接执行递归删除。
绑定挂载还会遮住镜像目标位置原有的内容;看到空目录,不代表镜像内的配置已经消失。修正源后重新创建对应容器,不能只在旧容器里临时补文件当成永久修复。
验收
检查挂载类型和路径,验证运行用户能读取、程序加载了正确配置。只读文件应不能被容器内进程改写。再重建一次测试容器确认修复可重复,才把同样的变更应用到生产。
继续排查
容器重建后数据还在吗?数据卷与目录挂载的使用方法;Docker挂载目录无权访问,先核对运行身份。
技术依据:[1] Docker bind mounts语法与路径行为;[2] Compose volumes长语法与create_host_path。适用版本见本文说明。