diff --git a/README.md b/README.md index 4a60b7d..4ecc726 100644 --- a/README.md +++ b/README.md @@ -6,16 +6,15 @@ v0.1.6 [Docker](docker.com)是个伟大的项目,它彻底释放了虚拟化的威力! 本书最初源于[WaitFish](mailto:dwj_wz@163.com)的"Docker学习手册v1.0" pdf内容,后来,[yeasy](github.com/yeasy) -根据最新Docker版本对内容进行了修订,并增加了部分内容;与[WaitFish](mailto:dwj_wz@163.com)协商,将所有内容开源,采用互联网合作的方式进行创作和维护。 +根据最新Docker版本对内容进行了修订和重写,并增加了部分内容;与[WaitFish](mailto:dwj_wz@163.com)协商,将所有内容开源,采用互联网合作的方式进行创作和维护。 本书既适用于具备基础Linux知识的Docker初学者,也可供希望理解原理和底层实现的高级用户参考。同时,本书中给出的实践案例,可供在进行实际部署时借鉴。 -在线阅读:[https://www.gitbook.io/book/yeasy/docker_practice](https://www.gitbook.io/book/yeasy/docker_practice) +在线阅读:[https://www.gitbook.io/book/yeasy/docker_practice](https://www.gitbook.io/book/yeasy/docker_practice)。 -维护本书的Github项目: [https://github.com/yeasy/docker_practice](https://github +维护本书的Github项目: [https://github.com/yeasy/docker_practice](https://github .com/yeasy/docker_practice)。 - -欢迎大家提交pull request。 +欢迎大家参与,提交pull request。 另外,欢迎大家加入QQ群(341410255)一起交流学习,共同提高。 diff --git a/SUMMARY.md b/SUMMARY.md index 5ee38e7..734a589 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -43,7 +43,7 @@ * [数据管理](data_management/README.md) * [数据卷](data_management/volume.md) * [数据卷容器](data_management/container.md) - * [备份、恢复、移动数据卷](data_management/management.md) + * [备份、恢复、迁移数据卷](data_management/management.md) * [容器安全](container_security/README.md) * [内核名字空间](container_security/kernel_ns.md) * [控制组](container_security/control_group.md) diff --git a/data_management/README.md b/data_management/README.md index 9914cee..20446fa 100644 --- a/data_management/README.md +++ b/data_management/README.md @@ -1,5 +1,4 @@ #Docker 数据管理 -这一章介绍如何在Docker内部以及容器之间管理数据 -在容器中管理数据的2个主要方式: +这一章介绍如何在Docker内部以及容器之间管理数据,在容器中管理数据主要有两种方式: * 数据卷(Data volumes) * 数据卷容器(Data volume containers) diff --git a/data_management/container.md b/data_management/container.md index 86f5eaf..2596ed2 100644 --- a/data_management/container.md +++ b/data_management/container.md @@ -1,16 +1,23 @@ ##数据卷容器 -如果你有一些持续更新的数据需要在容器之间共享,最好创建Data Volume Container,然后加载它。现在就来创建一个命名的数据卷容器: +如果你有一些持续更新的数据需要在容器之间共享,最好创建数据卷容器。 + +数据卷容器,其实就是一个正常的容器,专门用来提供数据卷供其它容器挂载的。 + +首先,创建一个命名的数据卷容器dbdata: ``` $ sudo docker run -d -v /dbdata --name dbdata training/postgres echo Data-only container for postgres ``` -然后,你可以在其他容器中使用--volumes-from 来挂载/dbdata卷 +然后,在其他容器中使用`--volumes-from`来挂载dbdata容器中的数据卷。 ``` $ 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 ``` -如果你移除了挂载的容器,包括初始容器,或者后来的db1 db2,这些卷在有容器使用它的时候不会被删除。这可以让我们在容器之间升级和移动数据。 \ No newline at end of file +*注意:使用`--volumes-from`参数所挂载数据卷的容器自己并不需要保持在运行状态。 + +如果删除了挂载的容器(包括dbdata、db1和db2),数据卷并不会被自动删除。如果要删除一个数据卷,必须在删除最后一个还挂载着它的容器时使用`docker rm -v`命令来指定同时删除关联的容器。 +这可以让用户在容器之间升级和移动数据卷。具体的操作将在下一节中进行讲解。 diff --git a/data_management/management.md b/data_management/management.md index 7336f78..94d8e21 100644 --- a/data_management/management.md +++ b/data_management/management.md @@ -1,19 +1,21 @@ -##利用Data Volume Container 来备份、恢复、移动数据卷 -数据卷另外一个功能是使用他们来备份、恢复、移动数据。使用--volume标记来创建一个加载了卷的新的容器,命令如下: +##利用数据卷容器来备份、恢复、迁移数据卷 +可以利用数据卷对其中的数据进行进行备份、恢复和迁移。 + +###备份 +首先使用`--volume--from`标记来创建一个加载dbdata容器卷的容器,并从本地主机挂载当前到容器的/backup目录。命令如下: ``` $ sudo docker run --volumes-from dbdata -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata ``` -这里我们创建了一个容器,先从dbdata容器来挂载数据卷。然后从本地主机挂载当前到容器的/backup目录。最后,使用tar命令来将dbdata -卷备份为back.tar。当命令执行完、容器停止之后,我们就备份了dbdata数据卷。 +容器启动后,使用了`tar`命令来将dbdata卷备份为本地的`/backup/backup.tar`。 -你可以使用这个备份来恢复这个容器。 +###恢复 +如果要恢复数据到一个容器,首先创建一个带有数据卷的容器dbdata2。 ``` $ sudo docker run -v /dbdata --name dbdata2 ubuntu /bin/bash ``` -然后使用untar解压这个备份文件到新容器卷中。 +然后创建另一个容器,挂载dbdata2的容器,并使用`untar`解压备份文件到挂载的容器卷中。 ``` -$ sudo docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf +$ sudo docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar ``` -你可以用上述技术实现数据卷的备份、移动、恢复。 \ No newline at end of file diff --git a/data_management/volume.md b/data_management/volume.md index ddf9016..6002fb0 100644 --- a/data_management/volume.md +++ b/data_management/volume.md @@ -5,36 +5,41 @@ * 对数据卷的更新,不会影响镜像 * 卷会一直存在,直到没有容器使用 -###添加一个数据卷 -在用`docker run`命令的时候,使用-v标记来添加一个数据卷。在一次run中多次使用可以挂载多个数据卷,下面加载一个卷到web容器上。 +*数据卷的使用,类似于Linux下对目录或文件进行mount。 + + +###创建一个数据卷 +在用`docker run`命令的时候,使用`-v`标记来创建一个数据卷并挂载到容器里。在一次run中多次使用可以挂载多个数据卷。 + +下面创建一个web容器,并加载一个数据卷到容器的`/webapp`目录。 ``` $ sudo docker run -d -P --name web -v /webapp training/webapp python app.py ``` -创建一个新的卷到容器的/webapp -*注意:也可以在dockerfile中使用volume来添加一个或者多个新的卷到由该image创建的任意容器 +*注意:也可以在dockerfile中使用volume来添加一个或者多个新的卷到由该镜像创建的任意容器。 ###挂载一个主机目录作为数据卷 -使用-v标记也可以挂载一个主机的目录到容器中去 +使用`-v`标记也可以指定挂载一个本地主机的目录到容器中去。 ``` -$ sudo docker run -d -P --name web -v /src/webapp:/opt/webapp -training/webapp python app.py +$ sudo docker run -d -P --name web -v /src/webapp:/opt/webapp training/webapp python app.py ``` -上面的命令加载主机的/src/webapp到容器的/opt/webapp -目录。这个在测试的时候特别好用,比如我们可以加载我们的源码到容器中,来查看他们是否正常工作。目录的路径必须是主机上的绝对路径,如果目录不存在docker会自动为你创建它。 -*注意:dockerfile 中不能用,各种操作系统的文件路径格式不一样,所以不一定适合所有的主机。 +上面的命令加载主机的`/src/webapp`目录到容器的`/opt/webapp` +目录。这个功能在进行测试的时候十分方便,比如用户可以放置一些程序到本地目录中,来查看容器是否正常工作。本地目录的路径必须是绝对路径,如果目录不存在docker会自动为你创建它。 -docker 加载的数据卷默认是读写权限,但我们可以把它加载为只读。 +*注意:dockerfile中不支持这种用法,这是因为dockerfile是为了移植和分享用的。然而,不同操作系统的路径格式不一样,所以目前还不能支持。 + +Docker挂载数据卷的默认权限是读写,用户也可以通过`:ro`指定为只读。 ``` $ sudo docker run -d -P --name web -v /src/webapp:/opt/webapp:ro training/webapp python app.py ``` -加了ro之后,就挂载为只读了。 +加了`:ro`之后,就挂载为只读了。 -###挂载一个宿主主机文件作为数据卷 --v标记也可以从主机挂载单个文件到容器中 +###挂载一个本地主机文件作为数据卷 +`-v`标记也可以从主机挂载单个文件到容器中 ``` $ sudo docker run --rm -it -v ~/.bash_history:/.bash_history ubuntu /bin/bash ``` 这样就可以记录在容器输入过的命令了。 -*注意:很多工具子在使用vi或者sed --in-place的时候会导致inode的改变,从docker 1.1 -.0起,它会报错,所以最简单的办法就直接mount父目录。 + +*注意:如果直接挂载一个文件,很多文件编辑工具,包括`vi`或者`sed --in-place`,可能会造成文件inode的改变,从docker 1.1 +.0起,这会导致报错误信息。所以最简单的办法就直接挂载文件的父目录。 diff --git a/repository/README.md b/repository/README.md index 79d670f..9d107a8 100644 --- a/repository/README.md +++ b/repository/README.md @@ -1 +1,3 @@ # 仓库 + +TODO