一、背景介绍
docker volume 可以使我们在启动docker容器时,动态的挂载一些文件(如配置文件), 以覆盖镜像中原有的文件,但是,挂载一个主机上尚不存在的文件夹或者文件到容器中会怎样呢?LZ在工作中就遇到了这样的问题,故自己实践了一下,记录实验结果如下:
二、文件夹挂载
docker在文件夹挂载上的行为是统一的,具体表现为:
- 若文件夹不存在,则先创建出文件夹(若为多层文件夹,则递归创建)
- 用host上的文件夹内容覆盖container中的文件夹内容
docker run -v /path-to-folder/A:/path-to-folder/B test-image
详细说明如下:
1、host上文件夹存在,且非空
host | container | mount result |
---|---|---|
存在的非空文件夹A | 不存在的文件夹B | 先在contanier中创建文件夹B,再将A文件夹中的所有文件copy到B中 |
存在的非空文件夹A | 存在的非空文件夹B | 先将container中文件夹B的原有内容清空,再将A中文件copy到B中 |
无论container中的文件夹B是否存在, A都会完全覆盖B的内容
2、host上文件夹存在,但为空
host | container | mount result |
---|---|---|
存在的空文件夹A | 存在的非空文件夹B | container中文件夹B的内容被清空 |
container中对应的文件夹内容被清空
3、host上文件夹不存在
host | container | mount result |
---|---|---|
不存在的文件夹A | 存在的非空文件夹B | 在host上创建文件夹A,container中文件夹B的内容被清空 |
不存在的文件夹A/B/C | 存在的非空文件夹B | 在host上创建文件夹A/B/C,container中文件夹B的内容被清空 |
container中对应的文件夹内容被清空
总结:
host上文件夹一定会覆盖container中文件夹:
host | container | mount result |
---|---|---|
文件夹不存在/文件夹存在但为空 | 文件夹不存在/存在但为空/存在且不为空 | container中文件被覆盖(清空) |
文件夹存在且不为空 | 文件夹不存在/存在但为空/存在且不为空 | container中文件夹内容被覆盖(原内容清空, 覆盖为host上文件夹内容) |
三、文件挂载
文件挂载与文件夹挂载最大的不同点在于:
- docker 禁止用主机上不存在的文件挂载到container中已经存在的文件
- 文件挂载不会对同一文件夹下的其他文件产生任何影响
除此之外, 其覆盖行为与文件夹挂载一致,即:
- 用host上的文件的内容覆盖container中的文件的内容
docker run -v /path-to-folder/non-existent-config.js:/path-to-folder/config.js test-image # forbidden
详细说明如下:
1、host上文件不存在
host | container | mount result |
---|---|---|
host | container | mount result |
---|---|---|
不存在的文件configA.js | 已经存在的文件congfigB.js | 报错,Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type. 同时会在host上生成两个空目录 configA.js 和 configB.js, 但是container无法启动 |
2、host上文件存在
host | container | mount result |
---|---|---|
存在的文件configA.js | 存在的文件congfigB.js | container中文件名configB.js保持不变,但是文件内容被congfigA.js的内容覆盖了 |
存在的文件configA.js | 不存在的文件congfigB.js | container中新建一个文件configB.js,其内容为configA.js的文件内容, configB.js所在文件下的所有其他文件维持不变 |
总结:
host上文件一定会覆盖container中文件夹
host | container | mount result |
---|---|---|
不存在的文件 | 已经存在的文件 | 禁止行为 |
存在的文件 | 不存在的文件/已经存在的文件 | 新增/覆盖 (若目录不存在则会创建目录) |
四、结论:
文件夹挂载
- 允许不存在的文件夹或者存在的空文件夹挂载进container, container中对应的文件夹将被清空
- 非空文件夹挂载进container将会覆盖container中原有文件夹
文件挂载
- 禁止将不存在的文件挂载进container中已经存在的文件上
- 存在的文件挂载进container中将会覆盖container中对应的文件, 若文件不存在则新建
应用场景
- 从上面的分析可知,文件夹挂载以整个文件夹为单位进行文件覆盖,故可在需要将大量文件挂载进container时使用,另外,如果挂载一个空文件夹或者不存在的文件夹,一般是做逆向使用: 即容器启动后,可能会在容器内挂载点的文件夹下生成一些文件(如日志),此时,在对应的host上的文件夹内就能直接看到。
- 文件挂载由于只会覆盖单个文件而不会影响container中同一文件夹下的其他文件,常常被用来挂载配置文件,以在运行时,动态的修改默认配置。