rewrite the container, network chapters

README.md

@@ -1,13 +1,14 @@
 Docker —— 从入门到实践
 ===============
 
-v0.1.4
+v0.1.5
 
 [Docker](docker.com)是个伟大的项目！
 
-本书最初源于[WaitFish](mailto:dwj_wz@163.com)
+本书最初源于[WaitFish](mailto:dwj_wz@163.com)的"Docker学习手册v1.0" pdf内容，后来，[yeasy](github.com/yeasy)
-的<Docker学习手册v1.0> pdf内容，后来，[yeasy](github.com/yeasy)
+根据最新Docker版本对内容进行了修订，并增加了部分内容；与[WaitFish](mailto:dwj_wz@163.com)协商，将所有内容开源，采用互联网合作的方式进行创作和维护。
-根据最新的官方文档对内容进行了修订，重写和增加了部分内容，并与作者[WaitFish](mailto:dwj_wz@163.com)协商，将内容开源，采用互联网合作的方式进行创作和维护。
+
+本书既适用于具备基础Linux知识的Docker初学者，也可供希望理解原理和底层实现的高级用户参考。同时，本书中给出的实践案例，可供在进行实际部署时借鉴。
 
 在线阅读：[https://www.gitbook.io/book/yeasy/docker_practice](https://www.gitbook.io/book/yeasy/docker_practice)
 

SUMMARY.md

@@ -5,7 +5,7 @@
    * [快速交付应用程序](introduction/fast_deployment.md)
    * [更容易部署和扩展](introduction/easy_deployment.md)
    * [效率更高](introduction/high_efficiency.md)
-   * [快速部署也意味着更简单的管理](introduction/easy_management.md)
+   * [更简单的管理](introduction/easy_management.md)
 * [基本概念](basic_concept/README.md)
    * [镜像](basic_concept/internal.md)
    * [容器](basic_concept/container.md)
@@ -14,18 +14,22 @@
    * [Ubuntu](install/ubuntu144.md)
    * [CentOS](install/centos.md)
 * [镜像](image/README.md)
-   * [获取镜像](image/get.md)
+   * [列出](image/list.md)
-   * [查找镜像](image/search.md)
+   * [获取](image/pull.md)
-   * [下载镜像](image/download.md)
+   * [查找](image/search.md)
-   * [创建镜像](image/create.md)
+   * [创建](image/create.md)
-   * [上传镜像](image/push.md)
+   * [上传](image/push.md)
-   * [移除镜像](image/rmi.md)
+   * [移除](image/rmi.md)
    * [底层原理](image/internal.md)
 * [容器](container/README.md)
+   * [启动](container/run.md)
+   * [守护态运行](container/daemon.md)
+   * [终止](container/stop.md)
+   * [删除](container/rm.md)
 * [仓库](repository/README.md)
-* [网络介绍](network/README.md)
+* [网络和互联](network/README.md)
    * [端口映射](network/port_mapping.md)
-   * [docker中的容器互联-linking系统](network/linking.md)
+   * [容器互联](network/linking.md)
 * [高级网络配置](advanced_network/README.md)
    * [快速配置](advanced_network/fast_config.md)
    * [配置DNS](advanced_network/dns.md)
@@ -47,6 +51,7 @@
    * [内核权限](container_security/kernel_capability.md)
    * [其他内核安全特性](container_security/other_feature.md)
    * [结论](container_security/summary.md)
+* [Dockerfile](dockerfile/README.md)
 * [底层实现](arch/README.md)
 * [实战案例](practice/README.md)
    * [部署本地仓库](practice/local_repo.md)

container/README.md

@@ -1,38 +1,3 @@
-# 容器
+# Docker容器
-##启动容器
+容器是Docker又一核心概念。
-所需要的命令主要为`docker run`
+本章将具体介绍如何来管理一个容器，包括创建、启动和停止等。
-
-例如，下面的命令输出一个"Hello World"，之后终止容器。
-```
-$ sudo docker run ubuntu:14.04 /bin/echo 'Hello world'
-Hello world
-```
-
-下面的命令则启动一个bash终端，可以让用户进行交互。
-```
-$ sudo docker run -t -i ubuntu:14.04 /bin/bash
-root@af8bae53bdd3:/#
-```
-其中，`-t`选项让Docker分配一个伪终端（pseudo-tty）并绑定到容器的标准输入上， `-i`则让容器的标准输入保持打开。
-
-在交互模式下，用户可以通过所创建的终端来输入命令，例如
-```
-root@af8bae53bdd3:/# pwd
-/
-root@af8bae53bdd3:/# ls
-bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr var
-```
-
-当利用`docker run`来创建容器时，Docker在后台运行的标准操作包括：
-
-* 检查本地是否存在指定的镜像，不存在就从公有仓库下载
-* 利用镜像创建并启动一个容器
-* 分配一个文件系统，并在只读的镜像层外面挂载一层可读写层
-* 从宿主主机配置的网桥接口中桥接一个虚拟接口到容器中去
-* 从地址池配置一个ip地址给容器
-* 执行用户指定的应用程序
-
-##终止容器
-
-当Docker容器中指定的应用终结时，容器也自动终止。
-例如用户通过`exit`命令或`Ctrl+d`来退出终端时，所创建的容器立刻终止。

container/rm.md

@@ -1,5 +1,9 @@
-##终止容器
+##删除容器
-可以使用`docker stop`来终止一个运行中的容器。
+可以使用`docker rm`来删除一个处于终止状态的容器。
+例如
+```
+$sudo docker rm  trusting_newton
+trusting_newton
+```
+如果要删除一个运行中的容器，可以添加`-f`参数。Docker会发送SIGKILL信号给容器。
 
-此外，当Docker容器中指定的应用终结时，容器也自动终止。
-例如对于上一章节中只启动了一个终端的容器，用户通过`exit`命令或`Ctrl+d`来退出终端时，所创建的容器立刻终止。

container/run.md

@@ -1,5 +1,7 @@
-# 容器
 ##启动容器
+启动容器有两种方式，一种是基于镜像新建一个容器并启动，另外一个是将在终止状态（stopped）的容器重新启动。
+
+###新建并启动
 所需要的命令主要为`docker run`。
 
 例如，下面的命令输出一个"Hello World"，之后终止容器。
@@ -32,8 +34,10 @@ bin boot dev etc home lib lib64 media mnt opt proc root run sbin srv sys tmp usr
 * 从地址池配置一个ip地址给容器
 * 执行用户指定的应用程序
 
+###启动已终止容器
+可以利用`docker start`命令，直接将一个已经终止的容器启动运行。
 
-容器的核心为所执行的应用程序，所需要的资源都是应用程序运行所必需的。除此之外，并没有其它的资源。可以在伪终端中查看进程信息。
+容器的核心为所执行的应用程序，所需要的资源都是应用程序运行所必需的。除此之外，并没有其它的资源。可以在伪终端中利用`ps`或`top`来查看进程信息。
 ```
 root@ba267838cc1b:/# ps
   PID TTY          TIME CMD

container/stop.md

@@ -3,3 +3,15 @@
 
 此外，当Docker容器中指定的应用终结时，容器也自动终止。
 例如对于上一章节中只启动了一个终端的容器，用户通过`exit`命令或`Ctrl+d`来退出终端时，所创建的容器立刻终止。
+
+终止状态的容器可以用`docker ps -a`命令看到。例如
+```
+sudo docker ps -a
+CONTAINER ID        IMAGE                    COMMAND                CREATED             STATUS                          PORTS               NAMES
+ba267838cc1b        ubuntu:14.04             "/bin/bash"            30 minutes ago      Exited (0) About a minute ago                       trusting_newton
+98e5efa7d997        training/webapp:latest   "python app.py"        About an hour ago   Exited (0) 34 minutes ago                           backstabbing_pike
+```
+
+处于终止状态的容器，可以通过`docker start`命令来重新启动。
+
+此外，`docker restart`命令会将一个运行态的容器终止，然后再重新启动它。

image/README.md

@@ -1,49 +1,10 @@
-#Docker image详细介绍
+#Docker镜像
 
-在之前的介绍中，我们知道docker images是docker的三大组件之一。
+在之前的介绍中，我们知道镜像是Docker的三大组件之一。
 
-docker把下载的images存储到docker主机上，如果一个image不在主机上，docker会从一个镜像仓库下载，默认的仓库是 DOCKER HUB 公共仓库。
+Docker把下载的镜像存储到本地，如果一个镜像不在本地，docker会从一个镜像仓库下载，默认的仓库是 Docker Hub 公共仓库。
 
-接下来将介绍更多关于docker images的内容，包括：
+接下来将介绍更多关于镜像的内容，包括：
-* 使用和管理本地主机上的images
+* 使用和管理本地主机上的镜像
-* 创建一个基础的images
+* 创建一个基础的镜像
-* 上传images到docker hub（公共images仓库）
+* 上传镜像到Docker Hub（公共镜像仓库）
-
-
-使用 docker images 显示本机上的images
-```
-$ sudo docker images
-REPOSITORY       TAG      IMAGE ID      CREATED      VIRTUAL SIZE
-training/webapp  latest   fc77f57ad303  3 weeks ago  280.5 MB
-ubuntu           13.10    5e019ab7bf6d  4 weeks ago  180 MB
-ubuntu           saucy    5e019ab7bf6d  4 weeks ago  180 MB
-ubuntu           12.04    74fe38d11401  4 weeks ago  209.6 MB
-ubuntu           precise  74fe38d11401  4 weeks ago  209.6 MB
-ubuntu           12.10    a7cf8ae4e998  4 weeks ago  171.3 MB
-ubuntu           quantal  a7cf8ae4e998  4 weeks ago  171.3 MB
-ubuntu           14.04    99ec81b80c55  4 weeks ago  266 MB
-ubuntu           latest   99ec81b80c55  4 weeks ago  266 MB
-ubuntu           trusty   99ec81b80c55  4 weeks ago  266 MB
-ubuntu           13.04    316b678ddf48  4 weeks ago  169.4 MB
-ubuntu           raring   316b678ddf48  4 weeks ago  169.4 MB
-ubuntu           10.04    3db9c44f4520  4 weeks ago  183 MB
-ubuntu           lucid    3db9c44f4520  4 weeks ago  183 MB
-```
-
-在列出信息中，可以看到几个字段信息
-
-* 来自于哪个仓库，比如ubuntu
-* image的标记，比如 14.04
-* 它的ID号（唯一）
-* 什么时候被创建的
-* 镜像大小
-
-仓库中可能有同一个images的多个发行版，比如ubuntu镜像，就有10.04、12.04、12.10、13.04、14.04等发行版,每个发行版的标记都不同，可以使用tag信息来指定images
-使用一个images的标记来启动容器
-```
-$ sudo docker run -t -i ubuntu:14.04 /bin/bash
-$ sudo docker run -t -i ubuntu:12.04 /bin/bash
-```
-上面的命令会从指定image启动一个容器，并提供用户控制台来交互。用户登录进入后可以看到系统内运行了一个bash进程。
-
-如果你不指定具体的发行版，比如仅使用ubuntu，那么docker会使用最新的发行版ubuntu:latest。

image/create.md

@@ -97,7 +97,7 @@ Removing intermediate container 5e9d0065c1f7
 Successfully built 324104cde6ad
 ```
 其中-t标记来添加tag，指定新的镜像的用户信息。
-.是Dockerfile所在的路径（当前目录），也可以替换为一个具体的Dockerfile的路径。
+“.”是Dockerfile所在的路径（当前目录），也可以替换为一个具体的Dockerfile的路径。
 
 我们可以看到build进程在执行操作。它要做的第一件事情就是上传这个Dockerfile内容，因为所有的操作都要依据Dockerfile来进行。
 然后，dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器，在容器中执行指令并提交修改（就跟之前介绍过的`docker commit`一样）。当所有的指令都执行完毕之后，返回了最终的镜像 id。所有的中间步骤所产生的容器都被删除和清理了。
@@ -130,3 +130,5 @@ ouruser/sinatra     latest  5db5f8471261  11 hours ago   446.7 MB
 ouruser/sinatra     devel   5db5f8471261  11 hours ago   446.7 MB
 ouruser/sinatra     v2      5db5f8471261  11 hours ago   446.7 MB
 ```
+
+更多用法，请参考dockerfile章节。

image/list.md

@@ -0,0 +1,37 @@
+##列出本地镜像
+使用`docker images`显示本机上的镜像
+```
+$ sudo docker images
+REPOSITORY       TAG      IMAGE ID      CREATED      VIRTUAL SIZE
+training/webapp  latest   fc77f57ad303  3 weeks ago  280.5 MB
+ubuntu           13.10    5e019ab7bf6d  4 weeks ago  180 MB
+ubuntu           saucy    5e019ab7bf6d  4 weeks ago  180 MB
+ubuntu           12.04    74fe38d11401  4 weeks ago  209.6 MB
+ubuntu           precise  74fe38d11401  4 weeks ago  209.6 MB
+ubuntu           12.10    a7cf8ae4e998  4 weeks ago  171.3 MB
+ubuntu           quantal  a7cf8ae4e998  4 weeks ago  171.3 MB
+ubuntu           14.04    99ec81b80c55  4 weeks ago  266 MB
+ubuntu           latest   99ec81b80c55  4 weeks ago  266 MB
+ubuntu           trusty   99ec81b80c55  4 weeks ago  266 MB
+ubuntu           13.04    316b678ddf48  4 weeks ago  169.4 MB
+ubuntu           raring   316b678ddf48  4 weeks ago  169.4 MB
+ubuntu           10.04    3db9c44f4520  4 weeks ago  183 MB
+ubuntu           lucid    3db9c44f4520  4 weeks ago  183 MB
+```
+
+在列出信息中，可以看到几个字段信息
+
+* 来自于哪个仓库，比如ubuntu
+* 镜像的标记，比如 14.04
+* 它的ID号（唯一）
+* 什么时候被创建的
+* 镜像大小
+
+仓库中可能有同一个镜像的多个发行版，比如ubuntu镜像，就有10.04、12.04、12.10、13.04、14.04等发行版,每个发行版的标记都不同，可以使用tag信息来指定使用某一个镜像来启动容器
+```
+$ sudo docker run -t -i ubuntu:14.04 /bin/bash
+$ sudo docker run -t -i ubuntu:12.04 /bin/bash
+```
+上面的命令会从指定镜像启动一个容器，并提供用户控制台来交互。用户登录进入后可以看到系统内运行了一个bash进程。
+
+如果你不指定具体的发行版，比如仅使用ubuntu，那么Docker会使用最新的发行版ubuntu:latest。

introduction/easy_management.md

@@ -1 +1,2 @@
+##快速部署也意味着更简单的管理
 * 通常只需要小小的改变就可以替代以往巨型和大量的更新工作。所有的修改以增量的方式被分发和更新，可以实现自动化并且高效的管理。

network/linking.md

@@ -1,29 +1,38 @@
-##docker中的容器互联-linking系统
+##容器互联
-docker有一个linking 系统可以连接多个容器。它会创建一对父子关系，父容器可以看到所选择的子容器的信息。
+容器的连接（linking）系统是除了端口映射外，另一种跟容器中应用交互的方式。
-###容器的命名系统
+
-linking系统依据容器的名称来执行。当我们创建容器的时候，系统会随机分配一个名字。当然用户也可以自己来命名容器，这样做有2个好处：
+该系统会在源和接收容器之间创建一个隧道，接收容器可以看到源容器指定的信息。
-* 当我们自己指定名称的时候，比较好记，比如一个web应用我们可以给它起名叫web
+
-* 当我们要连接其他容器时候，可以作为一个有用的参考点，比如连接web容器到db容器
+###自定义容器命名
-使用--name标记可以为容器命名
+连接系统依据容器的名称来执行。因此，首先需要自定义一个好记的容器命名。
+
+虽然当创建容器的时候，系统默认会分配一个名字。自定义命名容器有2个好处：
+* 自定义的命名，比较好记，比如一个web应用容器我们可以给它起名叫web
+* 当要连接其他容器时候，可以作为一个有用的参考点，比如连接web容器到db容器
+
+
+使用`--name`标记可以为容器自定义命名。
 ```
 $ sudo docker run -d -P --name web training/webapp python app.py
 ```
-使用docker -ps 来验证设定的命名
+
+使用`docker ps`来验证设定的命名。
 ```
 $ sudo docker ps -l
 CONTAINER ID  IMAGE                  COMMAND        CREATED       STATUS       PORTS                    NAMES
 aed84ee21bde  training/webapp:latest python app.py  12 hours ago  Up 2 seconds 0.0.0.0:49154->5000/tcp  web
 ```
-也可以使用docker inspect来查看容器的名字
+也可以使用`docker inspect`来查看容器的名字
 ```
 $ sudo docker inspect -f "{{ .Name }}" aed84ee21bde
 /web
 ```
-注意：容器的名称是唯一的。如果你命名了一个叫web的容器，当你要再次使用web这个名称的时候，你需要用docker
+注意：容器的名称是唯一的。如果已经命名了一个叫web的容器，当你要再次使用web这个名称的时候，需要先用`docker rm`来删除之前创建的同名容器。
-rm来删除之前创建的容器，也可以再执行docker run的时候 加—rm标记来停止旧的容器，并删除，rm 和-d 参数是不兼容的。
+
+在执行`docker run`的时候如果添加`--rm`标记，则容器在终止后会立刻删除。注意，`--rm`和`-d`参数是不兼容的。
 
 ###容器互联
-links可以让容器之间安全的交互，使用--link标记。下面先创建一个新的数据库容器，
+使用`--link`参数可以让容器之间安全的交互。下面先创建一个新的数据库容器，
 ```
 $ sudo docker run -d --name db training/postgres
 ```
@@ -31,25 +40,32 @@ $ sudo docker run -d --name db training/postgres
 ```
 $ docker rm -f web
 ```
-创建一个新的web容器，并将它link到db容器
+然后创建一个新的web容器，并将它连接到db容器
 ```
 $ sudo docker run -d -P --name web --link db:db training/webapp python app.py
 ```
---link标记的格式：--link name:alias，name是我们要链接的容器的名称，alias是这个链接的别名。
+此时，db容器和web容器建立父子关系。
 
-使用docker ps来查看容器的链接
+`--link`参数的格式为`--link name:alias`，其中`name`是要链接的容器的名称，`alias`是这个连接的别名。
+
+使用`docker ps`来查看容器的连接
 ```
 $ docker ps
 CONTAINER ID  IMAGE                     COMMAND               CREATED             STATUS             PORTS                    NAMES
 349169744e49  training/postgres:latest  su postgres -c '/usr  About a minute ago  Up About a minute  5432/tcp                 db, web/db
 aed84ee21bde  training/webapp:latest    python app.py         16 hours ago        Up 2 minutes       0.0.0.0:49154->5000/tcp  web
-我们可以看到我们命名的容器，db和web，db容器的names列有db也有web/db。这表示web容器链接到db容器，他们是一个父子关系。在这个link中，2个容器中有一对父子关系。docker在2个容器之间创建了一个安全的连接，而且不用映射他们的端口到宿主主机上。在启动db容器的时候也不用-p和-P标记。使用link之后我们就可以不用暴露数据库端口到网络上。
+```
-docker 通过2种方式为父子关系的容器公开连接信息：
+可以看到自定义命名的容器，db和web，db容器的names列有db也有web/db。这表示web容器链接到db容器，web容器将被允许访问db容器的信息。
+
+Docker在两个互联的容器之间创建了一个安全隧道，而且不用映射它们的端口到宿主主机上。在启动db容器的时候并没有使用-p和-P标记，从而避免了暴露数据库端口到外部网络上。
+
+Docker 通过2种方式为父子关系的容器公开连接信息：
 * 环境变量
 * 更新/etc/hosts文件
 
-使用env命令来查看容器的环境变量
+使用`env`命令来查看web容器的环境变量
-```$ sudo docker run --rm --name web2 --link db:db training/webapp env
+```
+$ sudo docker run --rm --name web2 --link db:db training/webapp env
 . . .
 DB_NAME=/web2/db
 DB_PORT=tcp://172.17.0.5:5432
@@ -59,7 +75,9 @@ docker 通过2种方式为父子关系的容器公开连接信息：
 DB_PORT_5000_TCP_ADDR=172.17.0.5
 . . .
 ```
-除了环境变量，docker还添加host信息到父容器的/etc/hosts的文件。下面是父容器web的hosts文件
+其中DB_开头的环境变量是供web容器连接db容器使用，前缀采用大写的连接别名。
+
+除了环境变量，docker还添加host信息到父容器的`/etc/hosts`的文件。下面是父容器web的hosts文件
 ```
 $ sudo docker run -t -i --rm --link db:db training/webapp /bin/bash
 root@aed84ee21bde:/opt/webapp# cat /etc/hosts
@@ -67,7 +85,8 @@ root@aed84ee21bde:/opt/webapp# cat /etc/hosts
 . . .
 172.17.0.5  db
 ```
-这里有2个hosts，第一个是web容器，web容器用id作为他的主机名，第二个是db容器的ip和主机名
+这里有2个hosts，第一个是web容器，web容器用id作为他的主机名，第二个是db容器的ip和主机名。
+可以在web容器中安装ping命令来测试跟db容器的连通。
 ```
 root@aed84ee21bde:/opt/webapp# apt-get install -yqq inetutils-ping
 root@aed84ee21bde:/opt/webapp# ping db
@@ -75,7 +94,8 @@ PING db (172.17.0.5): 48 data bytes
 56 bytes from 172.17.0.5: icmp_seq=0 ttl=64 time=0.267 ms
 56 bytes from 172.17.0.5: icmp_seq=1 ttl=64 time=0.250 ms
 56 bytes from 172.17.0.5: icmp_seq=2 ttl=64 time=0.256 ms
-用ping来ping db容器，它会解析成172.17.0.5
 ```
+用ping来ping db容器，它会解析成172.17.0.5。
+
 注意：官方的ubuntu镜像默认没有安装ping
-注意：你可以链接多个子容器到父容器，比如我们可以链接多个web到db容器上。
+注意：用户可以链接多个子容器到父容器，比如可以链接多个web到db容器上。

network/port_mapping.md

@@ -1,14 +1,22 @@
 ##端口映射
-当我们使用-P 标记时，docker 会随机映射一个49000 到49900的端口到内部容器开放的端口。
+容器中可以运行一些网络应用，要让外部也可以访问这些应用，可以通过`-P`或`-p`参数。
-使用`docker ps`可以看到，本地主机的49155映射到了容器的5000端口。
+
+当使用-P 标记时，docker 会随机映射一个49000~49900的端口到内部容器开放的网络端口。
+
+使用`docker ps`可以看到，本地主机的49155被映射到了容器的5000端口。此时访问本机的49115端口即可访问容器内web应用提供的界面。
 ```
 $ sudo docker run -d -P training/webapp python app.py
 $ sudo docker ps -l
 CONTAINER ID  IMAGE                   COMMAND       CREATED        STATUS        PORTS                    NAMES
 bc533791f3f5  training/webapp:latest  python app.py 5 seconds ago  Up 2 seconds  0.0.0.0:49155->5000/tcp  nostalgic_morse
 ```
-其中，-d是告诉docker在后台启动容器。-P会让docker将容器内必需的网络端口映射到本地主机。
+同样的，可以通过`docker logs`命令来查看应用的信息。
-
+```
+$ sudo docker logs -f nostalgic_morse
+* Running on http://0.0.0.0:5000/
+10.0.2.2 - - [23/May/2014 20:16:31] "GET / HTTP/1.1" 200 -
+10.0.2.2 - - [23/May/2014 20:16:31] "GET /favicon.ico HTTP/1.1" 404 -
+```
 
 -p（小写的P）则可以指定要映射的端口，并且，在一个指定端口上只可以绑定一个容器。支持的格式有`ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort`。
 
@@ -42,7 +50,8 @@ $ docker port nostalgic_morse 5000
 注意：
 * 容器有自己的内部网络和ip地址（使用 docker inspect 可以获取所有的变量，docker还可以有一个可变的网络配置。）
 * -p标记可以多次使用来绑定多个端口
-比如：
+
+例如
 ```
 $ sudo docker run -d -p 5000:5000  -p 3000:80 training/webapp python app.py
 ```