From 62aa90a3bfe3e8225bee515f29c71fda687c9c51 Mon Sep 17 00:00:00 2001 From: Zhenkai Jiang Date: Fri, 3 Jul 2015 16:17:28 +0800 Subject: [PATCH 1/3] add/correct lifecycle information for data volumes --- data_management/volume.md | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/data_management/volume.md b/data_management/volume.md index 392cbdb..b93404a 100644 --- a/data_management/volume.md +++ b/data_management/volume.md @@ -3,20 +3,24 @@ * 数据卷可以在容器之间共享和重用 * 对数据卷的修改会立马生效 * 对数据卷的更新，不会影响镜像 -* 数据卷会一直存在，直到没有容器使用 +* 数据卷默认会一直存在，即使容器被删除 -*注意：数据卷的使用，类似于 Linux 下对目录或文件进行 mount。 + +*注意：数据卷的使用，类似于 Linux 下对目录或文件进行 mount，镜像中的被指定为挂载点的目录中的文件会隐藏掉，能显示看的是挂载的数据卷。 ### 创建一个数据卷 在用 `docker run` 命令的时候，使用 `-v` 标记来创建一个数据卷并挂载到容器里。在一次 run 中多次使用可以挂载多个数据卷。 -下面创建一个 web 容器，并加载一个数据卷到容器的 `/webapp` 目录。 +下面创建一个名为 web 的容器，并加载一个数据卷到容器的 `/webapp` 目录。 ``` $ sudo docker run -d -P --name web -v /webapp training/webapp python app.py ``` *注意：也可以在 Dockerfile 中使用 `VOLUME` 来添加一个或者多个新的卷到由该镜像创建的任意容器。 +### 删除数据卷 +数据卷是被设计用来持久化数据的，它的生命周期独立于容器，Docker不会在容器被删除后自动删除数据卷，并且也不存在垃圾回收这样的机制来处理没有任何容器引用的数据卷。如果需要在删除容器的同时移除数据卷。可以在删除容器的时候使用 `docker rm -v` 这个命令。无主的数据卷可能会占据很多空间，要清理会很麻烦。Docker官方正在试图解决这个问题，相关工作的进度可以查看这个[PR](https://github.com/docker/docker/pull/8484) + ### 挂载一个主机目录作为数据卷 使用 `-v` 标记也可以指定挂载一个本地主机的目录到容器中去。 ``` @@ -34,6 +38,25 @@ training/webapp python app.py ``` 加了 `:ro` 之后，就挂载为只读了。 +### 查看数据卷的具体信息 + +在主机里使用以下命令可以查看指定容器的信息 +``` +$ docker inspect web +... +``` + +在输出的内容中找到其中和数据卷相关的部分，可以看到所有的数据卷都是创建在主机的`/var/lib/docker/volumes/`下面的 +``` +"Volumes": { + "/webapp": "/var/lib/docker/volumes/fac362...80535" +}, +"VolumesRW": { + "/webapp": true +} +... +``` + ### 挂载一个本地主机文件作为数据卷 `-v` 标记也可以从主机挂载单个文件到容器中 ``` From 72144f1032918656d72dc4ab58106d1d73d07ecf Mon Sep 17 00:00:00 2001 From: Zhenkai Jiang Date: Fri, 3 Jul 2015 16:19:51 +0800 Subject: [PATCH 2/3] fix a few vague descriptions for data volumes containers and backup/restore --- data_management/container.md | 6 +++--- data_management/management.md | 10 +++++----- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/data_management/container.md b/data_management/container.md index e15ee23..9f8a13a 100644 --- a/data_management/container.md +++ b/data_management/container.md @@ -3,7 +3,7 @@ 数据卷容器，其实就是一个正常的容器，专门用来提供数据卷供其它容器挂载的。 -首先，创建一个命名的数据卷容器 dbdata： +首先，创建一个名为 dbdata 的数据卷容器： ``` $ sudo docker run -d -v /dbdata --name dbdata training/postgres echo Data-only container for postgres ``` @@ -12,8 +12,8 @@ $ sudo docker run -d -v /dbdata --name dbdata training/postgres echo Data-only c $ sudo docker run -d --volumes-from dbdata --name db1 training/postgres $ sudo docker run -d --volumes-from dbdata --name db2 training/postgres ``` -还可以使用多个 `--volumes-from` 参数来从多个容器挂载多个数据卷。 -也可以从其他已经挂载了数据卷的容器来挂载数据卷。 +可以使用超过一个的 `--volumes-from` 参数来指定从多个容器挂载不同的数据卷。 +也可以从其他已经挂载了数据卷的容器来级联挂载数据卷。 ``` $ sudo docker run -d --name db3 --volumes-from db1 training/postgres ``` diff --git a/data_management/management.md b/data_management/management.md index 9847f11..c054dea 100644 --- a/data_management/management.md +++ b/data_management/management.md @@ -2,20 +2,20 @@ 可以利用数据卷对其中的数据进行进行备份、恢复和迁移。 ### 备份 -首先使用 `--volumes-from` 标记来创建一个加载 dbdata 容器卷的容器，并从本地主机挂载当前到容器的 /backup 目录。命令如下： +首先使用 `--volumes-from` 标记来创建一个加载 dbdata 容器卷的容器，并从主机挂载当前目录到容器的 /backup 目录。命令如下： ``` $ sudo docker run --volumes-from dbdata -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata ``` -容器启动后，使用了 `tar` 命令来将 dbdata 卷备份为本地的 `/backup/backup.tar`。 +容器启动后，使用了 `tar` 命令来将 dbdata 卷备份为容器中 /backup/backup.tar 文件，也就是主机当前目录下的名为 `backup.tar` 的文件。 ### 恢复 -如果要恢复数据到一个容器，首先创建一个带有数据卷的容器 dbdata2。 +如果要恢复数据到一个容器，首先创建一个带有空数据卷的容器 dbdata2。 ``` $ sudo docker run -v /dbdata --name dbdata2 ubuntu /bin/bash ``` -然后创建另一个容器，挂载 dbdata2 的容器，并使用 `untar` 解压备份文件到挂载的容器卷中。 +然后创建另一个容器，挂载 dbdata2 容器卷中的数据卷，并使用 `untar` 解压备份文件到挂载的容器卷中。 ``` $ sudo docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar -``` +``` \ No newline at end of file From 977221c5d19a36c3bc1f0deb2d8a319ae905ade2 Mon Sep 17 00:00:00 2001 From: Zhenkai Jiang Date: Fri, 3 Jul 2015 16:23:31 +0800 Subject: [PATCH 3/3] add an example to validate restored data from data volume container --- data_management/management.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/data_management/management.md b/data_management/management.md index c054dea..636d999 100644 --- a/data_management/management.md +++ b/data_management/management.md @@ -18,4 +18,8 @@ $ sudo docker run -v /dbdata --name dbdata2 ubuntu /bin/bash ``` $ sudo docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar +``` +为了查看/验证恢复的数据，可以再启动一个容器挂载同样的容器卷来查看 +``` +$ sudo docker run --volumes-from dbdata2 busybox /bin/ls /dbdata ``` \ No newline at end of file