数据卷
卷是保存由 Docker 容器生成和使用的数据的首选机制。虽然绑定挂载依赖于主机的目录结构和操作系统,但卷完全由 Docker 管理。与绑定挂载相比,卷有几个优点:
- 卷比绑定挂载更容易备份或迁移。
- 您可以使用 Docker CLI 命令或 Docker API 管理卷。
- 卷适用于 Linux 和 Windows 容器。
- 卷可以在多个容器之间更安全地共享。
- 卷驱动程序允许您将卷存储在远程主机或云提供商上,以加密卷的内容或添加其他功能。
- 新卷的内容可以由容器预先填充。
- Docker Desktop 上的卷比来自 Mac 和 Windows 主机的绑定挂载具有更高的性能。
此外,与在容器的可写层中持久化数据相比,卷通常是更好的选择,因为卷不会增加使用它的容器的大小,并且卷的内容存在于给定容器的生命周期之外。
如果您的容器生成非持久状态数据,请考虑使用 tmpfs 挂载以避免将数据永久存储在任何地方,并通过避免写入容器的可写层来提高容器的性能。
卷使用rprivate
绑定传播,并且绑定传播不可为卷配置。
选择 -v 或 --mount 标志🔗
一般来说,--mount
更明确和详细。最大的区别是-v
语法将所有选项组合在一个字段中,而--mount
语法将它们分开。这是每个标志的语法比较。
如果需要指定卷驱动程序选项,则必须使用--mount
.
-v
or--volume
:由三个字段组成,由冒号字符 (:
) 分隔。字段必须按正确的顺序排列,每个字段的含义不是很明显。- 在命名卷的情况下,第一个字段是卷的名称,并且在给定的主机上是唯一的。对于匿名卷,省略第一个字段。
- 第二个字段是文件或目录在容器中挂载的路径。
- 第三个字段是可选的,是以逗号分隔的选项列表,例如
ro
. 这些选项将在下面讨论。
--mount
:由多个键值对组成,以逗号分隔,每个由一个<key>=<value>
元组组成。--mount
语法比-v
or更冗长,但键的--volume
顺序并不重要,标志的值更容易理解。- 坐骑的
type
,可以是bind
、volume
或tmpfs
。本主题讨论卷,因此类型始终为volume
. source
坐骑的。对于命名卷,这是卷的名称。对于匿名卷,此字段被省略。可以指定为source
或src
。- 将
destination
文件或目录安装在容器中的路径作为其值。可以指定为destination
、dst
或target
。 - 该
readonly
选项(如果存在)会导致绑定挂载以只读方式挂载到容器中。可以指定为readonly
或ro
。 volume-opt
可以多次指定的选项采用由选项名称及其值组成的键值对。
- 坐骑的
从外部 CSV 解析器中转义值
如果您的卷驱动程序接受以逗号分隔的列表作为选项,则您必须从外部 CSV 解析器中转义该值。要转义 a 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
首先呈现。
-v
和--mount
行为的区别🔗
与绑定挂载相反,卷的所有选项都可用于 --mount
和-v
标志。
将卷与服务一起使用时,仅--mount
支持。
创建和管理卷🔗
与绑定挂载不同,您可以在任何容器范围之外创建和管理卷。
创建卷:
$ 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
启动一个带有卷的容器🔗
如果您使用尚不存在的卷启动容器,Docker 会为您创建卷。以下示例将卷安装myvol2
到 /app/
容器中。
下面的-v
和--mount
示例产生相同的结果。除非在运行第一个容器和卷后删除devtest
容器和卷,否则不能同时运行它们。myvol2
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name devtest </span>
–mount source=myvol2,target=/app </span>
nginx:latest
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name devtest </span>
-v myvol2:/app </span>
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
使用带有 docker-compose 的卷🔗
带有卷的单个 docker compose 服务如下所示:
version: "3.9"
services:
frontend:
image: node:lts
volumes:
- myapp:/home/node/app
volumes:
myapp:
将在第一次调用docker-compose up
卷时创建。相同的卷将在以下调用中重用。
卷可以直接在 compose with 之外创建docker volume create
,然后在内部引用docker-compose.yml
,如下所示:
version: "3.9"
services:
frontend:
image: node:lts
volumes:
- myapp:/home/node/app
volumes:
myapp:
external: true
有关将卷与 compose 一起使用的更多信息,请参阅 compose 参考。
使用卷启动服务🔗
当您启动服务并定义卷时,每个服务容器都使用自己的本地卷。如果您使用卷驱动程序,则没有一个容器可以共享此数据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
删除服务不会删除该服务创建的任何卷。卷删除是一个单独的步骤。
服务的语法差异
该docker service create
命令不支持-v
or--volume
标志。将卷挂载到服务的容器中时,您必须使用该--mount
标志。
使用容器填充卷🔗
如果您启动一个创建新卷的容器,如上,并且该容器在要挂载的目录中有文件或目录(/app/
如上),则该目录的内容将复制到该卷中。然后容器安装并使用该卷,并且使用该卷的其他容器也可以访问预填充的内容。
为了说明这一点,这个例子启动了一个容器并使用容器目录的内容 nginx
填充新卷,这是 Nginx 存储其默认 HTML 内容的地方。nginx-vol
/usr/share/nginx/html
--mount
和-v
示例具有相同的最终结果。
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name=nginxtest </span>
–mount source=nginx-vol,destination=/usr/share/nginx/html </span>
nginx:latest
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name=nginxtest </span>
-v nginx-vol:/usr/share/nginx/html </span>
nginx:latest
运行这些示例中的任何一个后,运行以下命令来清理容器和卷。注意卷删除是一个单独的步骤。
$ docker container stop nginxtest
$ docker container rm nginxtest
$ docker volume rm nginx-vol
使用只读卷🔗
对于某些开发应用程序,容器需要写入绑定挂载,以便将更改传播回 Docker 主机。在其他时候,容器只需要读取数据。请记住,多个容器可以挂载同一个卷,并且可以同时对其中的一些容器进行读写挂载,同时对其他容器进行只读挂载。
此示例修改了上述示例,但将目录安装为只读卷,方法是ro
在容器内的安装点之后添加(默认为空)选项列表。如果存在多个选项,请用逗号分隔它们。
--mount
和-v
示例具有相同的结果。
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name=nginxtest </span>
–mount source=nginx-vol,destination=/usr/share/nginx/html,readonly </span>
nginx:latest
<div class="language-console highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="gp">$</span> docker run <span class="nt">-d</span> <span class="se">\</span>
–name=nginxtest </span>
-v nginx-vol:/usr/share/nginx/html:ro </span>
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
在机器之间共享数据🔗
在构建容错应用程序时,您可能需要配置同一服务的多个副本以访问相同的文件。
在开发应用程序时,有几种方法可以实现这一点。一种是向您的应用程序添加逻辑,以将文件存储在 Amazon S3 等云对象存储系统上。另一种方法是使用支持将文件写入外部存储系统(如 NFS 或 Amazon S3)的驱动程序创建卷。
卷驱动程序允许您从应用程序逻辑中抽象出底层存储系统。例如,如果您的服务使用带有 NFS 驱动程序的卷,您可以更新服务以使用不同的驱动程序,例如在云中存储数据,而无需更改应用程序逻辑。
使用音量驱动程序🔗
当您使用 创建卷docker volume create
时,或者当您启动使用尚未创建的卷的容器时,您可以指定卷驱动程序。以下示例使用vieux/sshfs
卷驱动程序,首先在创建独立卷时,然后在启动创建新卷的容器时。
初始设置🔗
此示例假设您有两个节点,第一个是 Docker 主机,可以使用 SSH 连接到第二个。
在 Docker 主机上,安装vieux/sshfs
插件:
$ docker plugin install --grant-all-permissions vieux/sshfs
使用卷驱动程序创建卷🔗
此示例指定了 SSH 密码,但如果两台主机都配置了共享密钥,则可以省略密码。每个卷驱动程序可能有零个或多个可配置选项,每个选项都使用一个-o
标志指定。
$ docker volume create --driver vieux/sshfs \
-o sshcmd=test@node2:/home/test \
-o password=testpassword \
sshvolume
启动一个使用卷驱动程序创建卷的容器🔗
此示例指定了 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
创建一个创建 NFS 卷的服务🔗
此示例说明如何在创建服务时创建 NFS 卷。此示例10.0.0.10
用作 NFS 服务器和 NFS 服务器/var/docker-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
创建 CIFS/Samba 卷🔗
您可以直接在 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
addr
请注意,如果使用主机名而不是 IP,则需要该选项,以便 docker 可以执行主机名查找。
备份、恢复或迁移数据卷🔗
卷对于备份、恢复和迁移很有用。使用该 --volumes-from
标志创建一个挂载该卷的新容器。
备份卷🔗
例如,创建一个名为 的新容器dbstore
:
$ docker run -v /dbdata --name dbstore ubuntu /bin/bash
然后在下一个命令中,我们:
dbstore
启动一个新容器并从容器挂载卷- 将本地主机目录挂载为
/backup
dbdata
将压缩卷内容的命令传递给backup.tar
我们/backup
目录中的文件。
$ docker run --rm --volumes-from dbstore -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata
当命令完成并且容器停止时,我们留下了dbdata
卷的备份。
从备份中恢复音量🔗
使用刚刚创建的备份,您可以将其还原到同一个容器或您在其他地方创建的另一个容器。
例如,创建一个名为 的新容器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"
您可以使用上述技术,使用您喜欢的工具自动执行备份、迁移和恢复测试。
删除卷🔗
删除容器后,Docker 数据卷仍然存在。有两种类型的卷需要考虑:
- 命名卷具有来自容器外部的特定来源,例如
awesome:/bar
. - 匿名卷没有特定的来源,因此当容器被删除时,指示 Docker 引擎守护进程将其删除。
删除匿名卷🔗
要自动删除匿名卷,请使用该--rm
选项。例如,此命令创建一个匿名/foo
卷。当容器被移除时,Docker 引擎移除/foo
卷而不是awesome
卷。
$ docker run --rm -v /foo -v awesome:/bar busybox top
注意:
如果另一个容器用 绑定卷 --volumes-from
,则复制卷定义,并且在删除第一个容器后匿名卷也将保留。
删除所有卷🔗
要删除所有未使用的卷并释放空间:
$ docker volume prune