在Docker容器中挂载主机目录的方法

技术背景

在使用Docker时，有时需要将主机上的目录挂载到容器中，以便在主机和容器之间共享数据，使主机上的更新能实时反映到容器中。但不同的操作系统和Docker版本在挂载目录时可能会有不同的方法和注意事项。

实现步骤

使用ADD命令（不推荐用于实时更新场景）

可以在Dockerfile中使用ADD命令将主机目录复制到容器中，但这种方式在构建容器后，主机目录的更改不会反映到容器中。

ADD . /path/inside/docker/container

使用-v选项（适用于大多数场景）

在运行容器时使用-v选项可以将主机目录挂载到容器中。以下是不同操作系统的示例：

• Linux/Mac

docker run -t -i -v <host_dir>:<container_dir>  ubuntu /bin/bash

例如，将主机的/tmp目录挂载到容器的/tmp目录：

docker run -t -i -v /tmp:/tmp ubuntu /bin/bash

• Windows 10

docker run -it -p 12001:80 -v c:\Users\C\Desktop\dockerStorage:/root/sketches

注意要确保主机驱动器已共享。也可以使用以下格式：

docker run -it -p 12001:80 -v //c/Users/C/Desktop/dockerStorage:/root/sketches <your-image-here> /bin/bash

使用--mount选项（Docker 17.06及以上版本）

--mount选项的语法更详细，键值对的顺序不重要，且值更容易理解。

docker run -it --mount src="$(pwd)",target=/test_container,type=bind k3_s3

如果挂载参数没有空格，也可以使用反引号：

docker run -it --mount src=`pwd`,target=/test_container,type=bind k3_s3

对于使用boot2docker或docker-machine的情况

如果在Mac上使用boot2docker，可能需要进行两次挂载：

1. 将主机目录挂载到boot2docker：

sudo mount -t vboxsf hostfolder /boot2dockerfolder

2. 将boot2docker目录挂载到容器：

docker run -v /boot2dockerfolder:/root/containerfolder -i -t imagename

使用docker-compose

在docker-compose.yaml文件中也可以进行目录挂载：

version: '2'
services:
  cms:
    image: <IMAGE>:<TAG>
    ports:
      - <LOCAL_PORT>:<CONTAINER_PORT>
    volumes:
      - <LOCAL_PATH>:<CONTAINER_PATH>

例如：

version: '2'
services:
  cms:
    image: ghost-cms:latest
    ports:
      - 8080:8080
    volumes:
      - /volume-to-mount:/mnt

然后运行：

docker-compose -f docker-compose.yaml up -d

核心代码

以下是一些常见的挂载命令示例：

# 使用 -v 选项挂载
docker run -t -i -v /tmp:/tmp ubuntu /bin/bash

# 使用 --mount 选项挂载
docker run -it --mount src="$(pwd)",target=/test_container,type=bind k3_s3

# 在 docker-compose.yaml 中挂载
version: '2'
services:
  app:
    image: your-image:tag
    volumes:
      - ./host-dir:/container-dir

最佳实践

• 使用绝对路径：在挂载时尽量使用绝对路径，避免使用相对路径，以确保挂载的准确性。
• 权限管理：要注意挂载目录的权限问题，确保容器内的进程有足够的权限访问挂载的目录。
• 开发环境使用：在开发环境中，使用目录挂载可以方便地进行代码调试和更新，避免频繁重建容器。

常见问题

1. 在Mac上使用boot2docker挂载后看不到内容：可能是因为挂载的是boot2docker的目录而不是主机目录，需要进行两次挂载。
2. Windows上挂载失败：要确保主机驱动器已共享，并且使用正确的路径格式（如使用双斜杠）。
3. 无法在容器中更新文件：检查挂载目录的权限，确保容器内的进程有读写权限。
4. 挂载的目录为空：可能是路径错误或Docker配置问题，检查路径是否正确，以及是否需要在Docker设置中共享驱动器。