Rewrite the content

image/README.md

@@ -44,5 +44,6 @@ ubuntu           lucid    3db9c44f4520  4 weeks ago  183 MB
 $ 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。
+如果你不指定具体的发行版，比如仅使用ubuntu，那么docker会使用最新的发行版ubuntu:latest。

image/create.md

@@ -1,28 +1,28 @@
 ##创建我们自己的images
 别人的镜像虽然好，但不一定适合我们。
-我们可以对这些镜像做一些修改，有2个方法：
-###第一个方法：使用docker commit 来扩展一个image
-先使用image启动容器，更新后提交结果到新的image。
+我们可以对这些镜像做一些修改，有2个方法：利用现成的镜像进行修改或者利用dockerfile创建。
+
+###使用docker commit 来扩展一个image
+先使用下载的image启动容器。
 ```
 $ sudo docker run -t -i training/sinatra /bin/bash
 root@0b2616b0e5a8:/#
 ```
-注意：记住容器的ID ，稍后还会用到
+注意：记住容器的ID ，稍后还会用到。
 
-在容器中添加json和gem两个应用
+在容器中添加json和gem两个应用。
 ```
 root@0b2616b0e5a8:/# gem install json
 ```
-当结束后，我们使用exit来退出，现在我们的容器已经被我们改变了，使用docker commint命令来提交相应的副本。
+当结束后，我们使用exit来退出，现在我们的容器已经被我们改变了，使用docker commint命令来提交更新后的副本。
 ```
-$ sudo docker commit -m="Added json gem" -a="Kate Smith" 0b2616b0e5a8 ouruser/sinatra:v2
+$ sudo docker commit -m "Added json gem" -a "Docker Newbee" 0b2616b0e5a8 ouruser/sinatra:v2
 4f177bd27a9ff0f6dc2a830403925b5360bfe0b93d476f7fc3231110e7f71b1c
 ```
--m 来指定提交的信息，跟我们使用的版本控制工具一样。
--a 可以指定我们更新的用户信息，指定我们要从哪个容器ID来创建我们的副本，最后指定目标image的名字。
-这个例子里面，我们指定了一个新用户，ouruser，使用了sinatra的image，最后指定了image的标记v2。
+其中，-m 来指定提交的说明信息，跟我们使用的版本控制工具一样；-a 可以指定更新的用户信息；之后是用来创建镜像的容器的ID；最后指定目标image的仓库名和tag信息。创建成功后会返回这个image的id信息。
 
-使用docker images来查看我们创建的新image。
+
+使用docker images来查看新创建的image。
 ```
 $ sudo docker images
 REPOSITORY          TAG     IMAGE ID       CREATED       VIRTUAL SIZE
@@ -30,34 +30,38 @@ training/sinatra    latest  5bc342fa0b91   10 hours ago  446.7 MB
 ouruser/sinatra     v2      3c59e02ddd1a   10 hours ago  446.7 MB
 ouruser/sinatra     latest  5db5f8471261   10 hours ago  446.7 MB
 ```
-使用新的image来启动容器
+之后，可以使用新的image来启动容器
 ```
 $ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash
 root@78e82f680994:/#
 ```
-###第二个办法：从dockerfile 来创建 image
-使用docker commit 来扩展一个image比较简单，但它不容易在一个团队中分享它。我们使用docker build 来创建一个新的image。为此，我们需要创建一个dockerfile，包含一些如何创建我们的image的指令
 
-现在，我们来创建一个目录和一个dockerfile
+###利用dockerfile 来创建 image
+使用`docker commit` 来扩展一个image比较简单，但它不容易在一个团队中分享它。我们可以使用`docker build` 来创建一个新的image。为此，首先需要创建一个dockerfile，包含一些如何创建image的指令。
+
+新建一个目录和一个dockerfile
 ```
 $ mkdir sinatra
 $ cd sinatra
 $ touch Dockerfile
 ```
-每一条指令都创建一个image的新的一层，下面是一个简单的例子：
+Dockerfile中每一条指令都创建image的一层，例如：
 ```
 # This is a comment
 FROM ubuntu:14.04
-MAINTAINER Kate Smith <ksmith@example.com>
+MAINTAINER Docker Newbee <newbee@docker.com>
 RUN apt-get -qq update
 RUN apt-get -qqy install ruby ruby-dev
 RUN gem install sinatra
 ```
+Dockerfile基本的语法是
 * 使用#来注释
-* FROM指令告诉docker 使用哪个image源，
+* FROM指令告诉docker 使用哪个image作为源image
 * 接着是维护者的信息
-* 最后，我们指定了3条run指令。每一条run指令在image执行一条命令，比如安装一个软件包，在这里我们使用apt 来安装了一些软件
-现在，让我们来使用docker build来通过dockerfile创建image
+* RUN开头的指令会在创建中运行，比如安装一个软件包，在这里使用apt 来安装了一些软件
+
+编写完成Dockerfile后可以使用docker build来生成image。
+
 ```
 $ sudo docker build -t="ouruser/sinatra:v2" .
 Uploading context  2.56 kB
@@ -92,24 +96,26 @@ Successfully installed sinatra-1.4.5
 Removing intermediate container 5e9d0065c1f7
 Successfully built 324104cde6ad
 ```
-使用-t标记来指定新的image的用户信息和命令
-使用了.来指出dockerfile的位置在当前目录
-注意：你也可以指定一个dockfile的路径
-我们可以看到build进程在执行操作。它要做的第一件事情就是上传这个dockfile内容，因为所有的操作都要依据它来进行。
-然后，我们看到dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器，在容器中执行指令并提交就跟之前介绍过的docker commit一样。当所有的指令都执行完毕之后，返回了一个image id，并且所有的中间步骤所产生的容器都被删除和清理了。
-注意：一个image不能超过127层
+其中-t标记来添加tag，指定新的image的用户信息。
+.是Dockerfile所在的路径（当前目录），也可以替换为一个具体的Dockerfile的路径。
 
-从我们新建的images开启容器
+我们可以看到build进程在执行操作。它要做的第一件事情就是上传这个Dockerfile内容，因为所有的操作都要依据Dockerfile来进行。
+然后，dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器，在容器中执行指令并提交修改（就跟之前介绍过的`docker commit`一样）。当所有的指令都执行完毕之后，返回了最终的image id。所有的中间步骤所产生的容器都被删除和清理了。
+
+*注意一个image不能超过127层
+
+现在可以利用新创建的images来启动一个容器。
 ```
 $ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash
 root@8196968dac35:/#
+
+```
+还可以用tag命令来修改images的tag。
+```
 $ sudo docker tag 5db5f8471261 ouruser/sinatra:devel
-```
-用tag命令标记新的images
-```
 $ sudo docker images ouruser/sinatra
 REPOSITORY          TAG     IMAGE ID      CREATED        VIRTUAL SIZE
 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
-```
+```

image/download.md

@@ -1,8 +1,11 @@
 ##下载images
-现在我们指定了一个image，training/sinatra，我们可以使用docker pull命令来下载它
+现在将尝试下载training/sinatra镜像，可以使用docker pull命令。
 ```
 $ sudo docker pull training/sinatra
-然后我们就可以使用这个image来启动容器了
+```
+
+然后就可以使用这个image来启动容器了
+```
 $ sudo docker run -t -i training/sinatra /bin/bash
 root@a8cb6ce02d85:/#
-```
+```

image/get.md

@@ -1,6 +1,9 @@
 ##获取images
 
-我们如何获取新的images呢？当我们启动容器使用的image不再本地主机上时，docker会自动下载他们。这很耗时，我们可以使用docker pull命令来预先下载我们需要的image。下面的例子下载一个centos镜像。
+我们如何获取新的images呢？当我们启动容器使用的image不在本地时，docker会自动从远端仓库（docker hub）下载它们，这需要消耗一些时间。
+因此，可以使用docker pull命令来预先下载所需要的image。
+
+下面的例子下载一个centos镜像。
 ```
 $ sudo docker pull centos
 Pulling repository centos
@@ -9,8 +12,10 @@ b7de3133ff98: Pulling dependent layers
 511136ea3c5a: Download complete
 ef52fb1fe610: Download complete
 ```
-我们可以看到下载的image的每一个层次，这样当我们使用这个image来启动容器的时候，它就可以马上启动了。
+下载过程中，会输出获取image的每一层信息。
+
+下载完成后，即可随时创建并启动一个容器了。
 ```
 $ sudo docker run -t -i centos /bin/bash
 bash-4.1#
-```
+```

image/push.md

@@ -1,7 +1,8 @@
 ##使用docker push上传images
+用户也可以把自己创建的image上传到docker hub中来共享。
 ```
 $ sudo docker push ouruser/sinatra
 The push refers to a repository [ouruser/sinatra] (len: 1)
 Sending image list
 Pushing repository ouruser/sinatra (3 tags)
-```
+```

image/rmi.md

@@ -1,4 +1,5 @@
-##用dcoker rmi 移除本地images
+##用docker rmi 移除本地images
+如果要移除本地的image，可以使用rmi命令。注意rm命令是移除容器。
 ```
 $ sudo docker rmi training/sinatra
 Untagged: training/sinatra:latest
@@ -7,4 +8,4 @@ Deleted: ed0fffdcdae5eb2c3a55549857a8be7fc8bc4241fb19ad714364cbfd7a56b22f
 Deleted: 5c58979d73ae448df5af1d8142436d81116187a7633082650549c52c3a2418f0
 ```
 
-*注意：在删除images之前要先用docker rm  删掉依赖于这个images的容器
+*注意：在删除images之前要先用`docker rm`删掉依赖于这个images的所有容器。

image/search.md

@@ -1,6 +1,8 @@
 ##查找images
 
-docker的一个特点是很多人因为各种不同的用途创建了各种不同的images。它们都被上传到了docker hub共有仓库上，我们可以在docker hub的网站上来查找它们。使用docker search命令。比如，当我们的团队需要ruby和sinatra作为web应用程序的开发时，我们使用docker search 来搜索合适的image，使用关键字sinatra
+docker hub是一个公共仓库，供用户上传和下载制作好的不同用途的image，我们可以在docker hub的网站上来查找满足自己需求的image。
+
+使用docker search命令。比如，当开发团队需要ruby和sinatra作为web应用程序的开发时，可以使用docker search 来搜索合适的image，使用关键字sinatra
 
 ```
 $ sudo docker search sinatra
@@ -14,8 +16,12 @@ subwiz/sinatra
 bmorearty/sinatra                                                                      0
 ```
 
-我们看到返回了很多包含sinatra的images。其中包括image名字、描述、星级（表示该image的受欢迎程度）、是否官方创建、是否自动创建。官方的images是stackbrew项目组创建和维护的，autimated 资源允许你验证image的来源和内容。
 
-现在我们已经回顾了可用的images，并决定使用training/sinatra镜像。到目前为止，我们看到了2种images 资源。比如ubuntu，被称为基础或则根镜像。这些基础镜像是docker公司创建、验证、支持、提供。他们往往使用一个单词作为他们的名字。
+可以看到返回了很多包含sinatra的images。其中包括image名字、描述、星级（表示该image的受欢迎程度）、是否官方创建、是否自动创建。
+官方的images是由stackbrew项目组创建和维护的，autimated 资源允许用户验证image的来源和内容。
 
-还有一种类型，比如我们选择的training/sinatra镜像。它是由docker的用户创建并维护的，你可以通过指定image名字的前缀来指定他们，比如training。
+现在可以下载使用training/sinatra镜像。
+
+到目前为止，我们看到了2种images资源。
+一种是类似ubuntu这样的基础镜像，被称为基础或根镜像。这些基础镜像是由docker公司创建、验证、支持、提供。这样的镜像往往使用单个单词作为名字。
+还有一种类型，比如training/sinatra镜像。它是由docker的用户创建并维护的，你可以通过指定image名字的前缀来指定使用某个用户的镜像，比如training。