卷(volumes)是 Docker 容器生产和使用持久化数据的首选机制。绑定挂载(bind mounts)依赖于主机的目录结构,卷(volumes)彻底由 Docker 管理。卷与绑定挂载相比有几个优点:html
此外,与将数据持久化到容器的可写层相比,卷一般是更好的选择,由于卷不会增长使用它的容器的大小,并且卷的内容存在于给定容器的生命周期以外。node
若是容器生成非持久性状态数据,请考虑使用 tmpfs 挂载(tmpfs mount)以免将数据永久存储在任何位置,并经过避免写入容器的可写层来提升容器的性能。nginx
卷使用 rprivate
绑定传播,而且绑定传播对于卷是不可配置的。docker
最初,-v
或 --volume
标记用于独立容器,--mount
标记用于集群服务。可是,从 Docker 17.06 开始,您也能够将 --mount
用于独立容器。一般,--mount
标记表达更加明确和冗长。最大的区别是 -v
语法将全部选项组合在一个字段中,而 --mount
语法将选项分离。下面是每一个标记的语法比较。ubuntu
新用户推荐使用
--mount
语法,它比--volume
语法更简单。安全
若是须要指定卷驱动程序选项,则必须使用 --mount
。bash
-v
或 --volume
: 由三个字段组成,以冒号(:)分隔。字段必须按照正确的顺序排列,且每一个字段的含义不够直观明显。
ro
。这些选项会在本文下面讨论。--mount
:由多个键-值对组成,以逗号分隔,每一个键-值对由一个 <key>=<value>
元组组成。--mount
语法比 -v
或 --volume
更冗长,可是键的顺序并不重要,标记的值也更容易理解。
type
),能够是 bind
、volume
或者 tmpfs
。本主题讨论卷(volume),所以类型(type
)始终为卷(volume
)。source
),对于命名卷,这是卷的名称。对于匿名卷,此字段被省略。能够用 source
或者 src
来指定。destination
),将容器中文件或目录挂载的路径做为其值。能够用 destination
、dst
或者 target
来指定。readonly
选项(若是存在),则会将绑定挂载以只读形式挂载到容器中。volume-opt
选项,能够被指定屡次,接受由选项名及其值组成的键-值对。从外部 CSV 解析器转义值服务器
若是卷驱动程序接受以逗号分隔的列表做为选项,则必须从外部 CSV 解析器转义该值。要转义
volume-opt
, 请使用双引号(")将其括起来,并使用单引号(')将整个挂载参数括起来。app例如,本地(
local
)驱动程序在参数o
中接受以逗号分隔的列表做为挂载选项。下面这个例子展现了转义列表的正确写法。ssh$ 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 # 输出结果: DRIVER VOLUME NAME local my-vol
检查卷:
$ docker volume inspect my-vol # 输出结果: [ { "CreatedAt": "2020-07-04T07:06:47Z", "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/
中。
下面的 --mount
和 -v
示例会产生相同的结果。除非在运行第一个示例以后删除了 devtest
容器和 myvol2
卷,不然不能同时运行它们。
--mount
:
$ docker run -d \ --name devtest \ --mount source=myvol2,target=/app \ nginx:latest
-v
:
$ 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
启动服务并定义卷时,每一个服务容器都使用本身的本地卷。 若是使用本地(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
或 --volume
标记,在将卷挂载到服务的容器中时,必须使用 --mount
标记。
若是您启动了一个建立新卷的容器,如上所述,而且该容器在要挂载的目录(例如上面的 /app/
)中有文件或目录,那么该目录的内容将复制到新卷中。而后容器挂载并使用该卷,使用该卷的其余容器也能够访问预填充的内容。
为了说明这一点,这个例子启动了一个 nginx
容器,并用容器的 /usr/share/nginx/html
目录中的内容填充新的卷 nginx-vol
,这个目录是 Nginx 存储默认的 HTML 内容的地方。
下面的 --mount
和 -v
示例具备相同的最终结果。
--mount
:
$ docker run -d \ --name=nginxtest \ --mount source=nginx-vol,destination=/usr/share/nginx/html \ nginx:latest
-v
:
$ 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
对于某些开发应用程序,容器须要写入绑定挂载,以便更改传播回 Docker 主机。在其余时候,容器只须要对数据进行读访问。记住,多个容器能够挂载相同的卷,而且能够对其中一些容器以读写方式挂载,而对其余容器以只读方式挂载。
这个示例修改了上面的示例,可是经过在容器内的挂载点以后的选项列表(默认为空)中添加 ro
,将目录挂载为只读卷。当有多个选项时,使用逗号分隔它们。
下面 --mount
和 -v
示例有相同的结果。
--mount
:
$ docker run -d \ --name=nginxtest \ --mount source=nginx-vol,destination=/usr/share/nginx/html,readonly \ nginx:latest
-v
:
$ 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
在构建故障容错的应用程序时,您可能须要配置同一服务的多个副本,以访问相同的文件。
在开发应用程序时,有几种方法能够实现这一点。一种方法是向您的应用程序添加逻辑,在云对象存储系统(如 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 卷。本例使用 10.0.0.10
做为 NFS 服务器,使用 /var/docker-nfs
做为 NFS 服务器上的出口目录。请注意,指定的卷驱动程序是 local
。
$ 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
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=10.0.0.10,rw,nfsvers=4,async"' \ nginx:latest
卷对于备份、还原和迁移很是有用。使用 --volumes-from
标记建立一个挂载该卷的新容器。
例如,建立一个名为 dbstore
的新容器:
$ docker run -v /dbdata --name dbstore ubuntu /bin/bash
而后在下一条命令中,咱们:
dbstore
容器挂载卷/backup
/dbdata
卷的内容压缩到目录 /backup
中的 backup.tar
文件。$ 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
。要自动删除匿名卷,请使用 --rm
选项。例如,这个命令建立一个匿名的 /foo
卷。当容器被删除时,Docker 引擎会删除 /foo
卷,但不会删除 awesome
卷。
$ docker run --rm -v /foo -v awesome:/bar busybox top
要删除全部未使用的卷并释放空间,请执行如下操做:
$ docker volume prune