Use volumes

预计阅读时间:18分钟

卷是保存由 Docker 容器生成和使用的数据的首选机制. 虽然绑定挂载依赖于主机的目录结构和操作系统,但卷完全由 Docker 管理. 与绑定挂载相比,卷有几个优点:

  • 卷比绑定挂载更容易备份或迁移.
  • 您可以使用 Docker CLI 命令或 Docker API 管理卷.
  • 卷适用于 Linux 和 Windows 容器.
  • 卷可以在多个容器之间更安全地共享.
  • 卷驱动程序允许您将卷存储在远程主机或云提供商上,以加密卷的内容或添加其他功能.
  • 新卷的内容可以由容器预先填充.
  • Docker Desktop 上的卷比来自 Mac 和 Windows 主机的绑定挂载具有更高的性能.

此外,与在容器的可写层中持久化数据相比,卷通常是更好的选择,因为卷不会增加使用它的容器的大小,并且卷的内容存在于给定容器的生命周期之外.

volumes on the Docker host

如果您的容器生成非持久状态数据,请考虑使用tmpfs 挂载以避免将数据永久存储在任何地方,并通过避免写入容器的可写层来提高容器的性能.

卷使用rprivate绑定传播,并且无法为卷配置绑定传播.

Choose the -v or --mount flag

通常, --mount更加明确和详细. 最大的区别是-v语法将所有选项组合在一个字段中,而--mount语法将它们分开. 这是每个标志的语法比较.

如果需要指定卷驱动程序选项,则必须使用--mount .

  • -v--volume :由三个字段组成,由冒号字符 ( : ) 分隔. 字段必须按正确的顺序排列,每个字段的含义不是很明显.
    • 在命名卷的情况下,第一个字段是卷的名称,并且在给定的主机上是唯一的. 对于匿名卷,省略第一个字段.
    • 第二个字段是文件或目录在容器中挂载的路径.
    • 第三个字段是可选的,是以逗号分隔的选项列表,例如ro . 这些选项将在下面讨论.
  • --mount :由多个键值对组成,以逗号分隔,每个由<key>=<value>元组组成. --mount语法比-v--volume更冗长,但键的顺序并不重要,标志的值更容易理解.
    • 挂载type ,可以是bindvolumetmpfs . 本主题讨论卷,因此类型始终为volume .
    • 坐骑的source . 对于命名卷,这是卷的名称. 对于匿名卷,此字段被省略. 可以指定为sourcesrc .
    • destination将文件或目录安装在容器中的路径作为其值. 可以指定为destinationdsttarget .
    • readonly选项(如果存在)会导致绑定挂载以只读方式挂载到容器中. 可以指定为readonlyro .
    • 可以多次指定的volume-opt选项采用由选项名称及其值组成的键值对.

从外部 CSV 解析器中转义值

如果您的卷驱动程序接受以逗号分隔的列表作为选项,则您必须从外部 CSV 解析器中转义该值. 要转义volume-opt ,请用双引号 ( " ) 将其括起来,并用单引号 ( ' ) 将整个安装参数括起来.

例如, local驱动程序接受挂载选项作为o参数中的逗号分隔列表. 此示例显示了转义列表的正确方法.

$ docker service create \
    --mount 'type=volume,src=<VOLUME-NAME>,dst=<CONTAINER-PATH>,volume-driver=local,volume-opt=type=nfs,volume-opt=device=<nfs-server>:<nfs-path>,"volume-opt=o=addr=<nfs-address>,vers=4,soft,timeo=180,bg,tcp,rw"'
    --name myservice \
    <IMAGE>

下面的示例在可能的情况下同时显示了--mount-v语法,并且首先显示了--mount .

Differences between -v and --mount behavior

与绑定挂载相反,卷的所有选项都可用于--mount-v标志.

将卷与服务一起使用时,仅支持--mount .

Create and manage volumes

与绑定挂载不同,您可以在任何容器范围之外创建和管理卷.

Create a volume:

$ docker volume create my-vol

列出卷:

$ docker volume ls

local               my-vol

检查卷:

$ docker volume inspect my-vol
[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/my-vol/_data",
        "Name": "my-vol",
        "Options": {},
        "Scope": "local"
    }
]

删除卷:

$ docker volume rm my-vol

Start a container with a volume

如果您使用尚不存在的卷启动容器,Docker 会为您创建卷. 以下示例将卷myvol2挂载到容器中的/app/中.

下面的-v--mount示例产生相同的结果. 除非在运行第一个容器后删除devtest容器和myvol2卷,否则不能同时运行它们.

$ docker run -d \
  --name devtest \
  --mount source=myvol2,target=/app \
  nginx:latest
$ docker run -d \
  --name devtest \
  -v myvol2:/app \
  nginx:latest

使用docker inspect devtest验证卷是否已正确创建和安装. 查找Mounts部分:

"Mounts": [
    {
        "Type": "volume",
        "Name": "myvol2",
        "Source": "/var/lib/docker/volumes/myvol2/_data",
        "Destination": "/app",
        "Driver": "local",
        "Mode": "",
        "RW": true,
        "Propagation": ""
    }
],

这表明挂载是一个卷,它显示了正确的源和目标,并且挂载是读写的.

停止容器并移除卷. 注意卷删除是一个单独的步骤.

$ docker container stop devtest

$ docker container rm devtest

$ docker volume rm myvol2

Use a volume with docker-compose

带有卷的单个 docker compose 服务如下所示:

version: "3.9"
services:
  frontend:
    image: node:lts
    volumes:
      - myapp:/home/node/app
volumes:
  myapp:

在第一次调用docker-compose up ,将创建卷. 相同的卷将在以下调用中重用.

可以使用 docker docker volume create在 compose 之外直接创建卷,然后在docker-compose.yml中引用如下:

version: "3.9"
services:
  frontend:
    image: node:lts
    volumes:
      - myapp:/home/node/app
volumes:
  myapp:
    external: true

有关将卷与 compose 一起使用的更多信息,请参阅compose 参考.

Start a service with volumes

当您启动服务并定义卷时,每个服务容器都使用自己的本地卷. 如果您使用local卷驱动程序,则没有一个容器可以共享此数据,但某些卷驱动程序确实支持共享存储. Docker for AWS 和 Docker for Azure 都支持使用 Cloudstor 插件的持久存储.

下面的示例启动一个具有四个副本的nginx服务,每个副本都使用一个名为myvol2的本地卷.

$ docker service create -d \
  --replicas=4 \
  --name devtest-service \
  --mount source=myvol2,target=/app \
  nginx:latest

使用docker service ps devtest-service验证服务是否正在运行:

$ docker service ps devtest-service

ID                  NAME                IMAGE               NODE                DESIRED STATE       CURRENT STATE            ERROR               PORTS
4d7oz1j85wwn        devtest-service.1   nginx:latest        moby                Running             Running 14 seconds ago

删除该服务,这将停止其所有任务:

$ docker service rm devtest-service

删除服务不会删除该服务创建的任何卷. 卷删除是一个单独的步骤.

Syntax differences for services

docker docker service create命令不支持-v--volume标志. 将卷挂载到服务的容器中时,必须使用--mount标志.

Populate a volume using a container

如果你启动一个容器来创建一个新的卷,如上,并且容器在要挂载的目录中有文件或目录(如上面的/app/ ),则目录的内容将被复制到卷中. 然后容器安装并使用该卷,并且使用该卷的其他容器也可以访问预填充的内容.

为了说明这一点,这个例子启动了一个nginx容器,并使用容器的/usr/share/nginx/html目录的内容填充新卷nginx-vol ,这是 Nginx 存储其默认 HTML 内容的地方.

--mount-v示例具有相同的最终结果.

$ docker run -d \
  --name=nginxtest \
  --mount source=nginx-vol,destination=/usr/share/nginx/html \
  nginx:latest
$ docker run -d \
  --name=nginxtest \
  -v nginx-vol:/usr/share/nginx/html \
  nginx:latest

运行这些示例中的任何一个后,运行以下命令来清理容器和卷. 注意卷删除是一个单独的步骤.

$ docker container stop nginxtest

$ docker container rm nginxtest

$ docker volume rm nginx-vol

Use a read-only volume

对于某些开发应用程序,容器需要写入绑定挂载,以便将更改传播回 Docker 主机. 在其他时候,容器只需要读取数据. 请记住,多个容器可以挂载同一个卷,并且可以同时对其中的一些容器进行读写挂载,同时对其他容器进行只读挂载.

此示例修改了上面的示例,但将目录安装为只读卷,方法是将ro添加到(默认为空)选项列表中,在容器内的安装点之后. 如果存在多个选项,请用逗号分隔它们.

--mount-v示例具有相同的结果.

$ docker run -d \
  --name=nginxtest \
  --mount source=nginx-vol,destination=/usr/share/nginx/html,readonly \
  nginx:latest
$ docker run -d \
  --name=nginxtest \
  -v nginx-vol:/usr/share/nginx/html:ro \
  nginx:latest

使用docker inspect nginxtest验证只读挂载是否已正确创建. 查找Mounts部分:

"Mounts": [
    {
        "Type": "volume",
        "Name": "nginx-vol",
        "Source": "/var/lib/docker/volumes/nginx-vol/_data",
        "Destination": "/usr/share/nginx/html",
        "Driver": "local",
        "Mode": "",
        "RW": false,
        "Propagation": ""
    }
],

停止并移除容器,然后移除卷. 卷删除是一个单独的步骤.

$ docker container stop nginxtest

$ docker container rm nginxtest

$ docker volume rm nginx-vol

Share data among machines

在构建容错应用程序时,您可能需要配置同一服务的多个副本以访问相同的文件.

shared storage

在开发应用程序时,有几种方法可以实现这一点. 一种是向您的应用程序添加逻辑,以将文件存储在 Amazon S3 等云对象存储系统上. 另一种方法是使用支持将文件写入外部存储系统(如 NFS 或 Amazon S3)的驱动程序创建卷.

卷驱动程序允许您从应用程序逻辑中抽象出底层存储系统. 例如,如果您的服务使用带有 NFS 驱动程序的卷,您可以更新服务以使用不同的驱动程序,例如在云中存储数据,而无需更改应用程序逻辑.

Use a volume driver

当您使用docker volume create时,或者当您启动使用尚未创建的卷的容器时,您可以指定卷驱动程序. 以下示例使用vieux/sshfs卷驱动程序,首先在创建独立卷时,然后在启动创建新卷的容器时.

Initial set-up

此示例假设您有两个节点,第一个是 Docker 主机,可以使用 SSH 连接到第二个.

在 Docker 主机上,安装vieux/sshfs插件:

$ docker plugin install --grant-all-permissions vieux/sshfs

Create a volume using a volume driver

此示例指定了 SSH 密码,但如果两台主机都配置了共享密钥,则可以省略密码. 每个卷驱动程序可能有零个或多个可配置选项,每个选项都使用-o标志指定.

$ docker volume create --driver vieux/sshfs \
  -o sshcmd=test@node2:/home/test \
  -o password=testpassword \
  sshvolume

Start a container which creates a volume using a volume driver

此示例指定了 SSH 密码,但如果两台主机都配置了共享密钥,则可以省略密码. 每个卷驱动程序可能有零个或多个可配置选项. 如果卷驱动程序要求您传递选项,则必须使用--mount标志来挂载卷,而不是-v .

$ docker run -d \
  --name sshfs-container \
  --volume-driver vieux/sshfs \
  --mount src=sshvolume,target=/app,volume-opt=sshcmd=test@node2:/home/test,volume-opt=password=testpassword \
  nginx:latest

Create a service which creates an NFS volume

此示例说明如何在创建服务时创建 NFS 卷. 此示例使用10.0.0.10作为 NFS 服务器,使用/var/docker-nfs作为 NFS 服务器上的导出目录. 请注意,指定的卷驱动程序是local .

NFSv3

$ docker service create -d \
  --name nfs-service \
  --mount 'type=volume,source=nfsvolume,target=/app,volume-driver=local,volume-opt=type=nfs,volume-opt=device=:/var/docker-nfs,volume-opt=o=addr=10.0.0.10' \
  nginx:latest

NFSv4

$ docker service create -d \
    --name nfs-service \
    --mount 'type=volume,source=nfsvolume,target=/app,volume-driver=local,volume-opt=type=nfs,volume-opt=device=:/var/docker-nfs,"volume-opt=o=addr=10.0.0.10,rw,nfsvers=4,async"' \
    nginx:latest

Create CIFS/Samba volumes

您可以直接在 docker 中挂载 Samba 共享,而无需在主机上配置挂载点.

$ docker volume create \
	--driver local \
	--opt type=cifs \
	--opt device=//uxxxxx.your-server.de/backup \
	--opt o=addr=uxxxxx.your-server.de,username=uxxxxxxx,password=*****,file_mode=0777,dir_mode=0777 \
	--name cif-volume

请注意,如果使用主机名而不是 IP,则需要addr选项,以便 docker 可以执行主机名查找.

Backup, restore, or migrate data volumes

卷对于备份、恢复和迁移很有用. 使用--volumes-from标志创建一个挂载该卷的新容器.

Back up a volume

例如,创建一个名为dbstore的新容器:

$ docker run -v /dbdata --name dbstore ubuntu /bin/bash

然后在下一个命令中,我们:

  • 启动一个新容器并从dbstore容器挂载卷
  • 将本地主机目录挂载为/backup
  • 将一个将dbdata卷的内容 tar 的命令传递到/backup目录中的backup.tar文件中.
$ docker run --rm --volumes-from dbstore -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata

当命令完成并且容器停止时,我们留下了dbdata卷的备份.

Restore volume from backup

使用刚刚创建的备份,您可以将其还原到同一个容器或您在其他地方创建的另一个容器.

例如,创建一个名为dbstore2的新容器:

$ docker run -v /dbdata --name dbstore2 ubuntu /bin/bash

然后在新容器的数据卷中解压备份文件:

$ docker run --rm --volumes-from dbstore2 -v $(pwd):/backup ubuntu bash -c "cd /dbdata && tar xvf /backup/backup.tar --strip 1"

您可以使用上述技术,使用您喜欢的工具自动执行备份、迁移和恢复测试.

Remove volumes

删除容器后,Docker 数据卷仍然存在. 有两种类型的卷需要考虑:

  • 命名卷具有来自容器外部的特定来源,例如awesome:/bar .
  • 匿名卷没有特定的来源,因此当容器被删除时,指示 Docker 引擎守护进程将其删除.

Remove anonymous volumes

要自动删除匿名卷,请使用--rm选项. 例如,此命令创建一个匿名/foo卷. 当容器被移除时,Docker 引擎会移除/foo卷,但不会移除awesome卷.

$ docker run --rm -v /foo -v awesome:/bar busybox top

Note:

如果另一个容器使用--volumes-from绑定卷,则会复制卷定义,并且在删除第一个容器后匿名卷也会保留.

Remove all volumes

要删除所有未使用的卷并释放空间:

$ docker volume prune

Next steps

storage, persistence, 数据持久化, volumes

by  icopy.site