From 2c939cf20f9d4dcaf11a279e712d7ea11e15427e Mon Sep 17 00:00:00 2001 From: Baohua Yang Date: Mon, 15 Sep 2014 21:28:09 +0800 Subject: [PATCH] Fix word in image chapter --- image/create.md | 30 +++++++++++++++--------------- image/download.md | 11 ----------- image/get.md | 21 --------------------- image/internal.md | 10 +++++----- image/pull.md | 19 +++++++++++++++++++ image/push.md | 2 +- image/rmi.md | 4 ++-- image/search.md | 10 +++++----- 8 files changed, 47 insertions(+), 60 deletions(-) delete mode 100644 image/download.md delete mode 100644 image/get.md create mode 100644 image/pull.md diff --git a/image/create.md b/image/create.md index 7cb502f..bf2e126 100644 --- a/image/create.md +++ b/image/create.md @@ -2,8 +2,8 @@ 别人的镜像虽然好，但不一定适合我们。 我们可以对这些镜像做一些修改，有2个方法：利用现成的镜像进行修改或者利用dockerfile创建。 -###使用docker commit 来扩展一个image -先使用下载的image启动容器。 +###使用docker commit 来扩展一个镜像 +先使用下载的镜像启动容器。 ``` $ sudo docker run -t -i training/sinatra /bin/bash root@0b2616b0e5a8:/# @@ -19,10 +19,10 @@ root@0b2616b0e5a8:/# gem install json $ sudo docker commit -m "Added json gem" -a "Docker Newbee" 0b2616b0e5a8 ouruser/sinatra:v2 4f177bd27a9ff0f6dc2a830403925b5360bfe0b93d476f7fc3231110e7f71b1c ``` -其中，-m 来指定提交的说明信息，跟我们使用的版本控制工具一样；-a 可以指定更新的用户信息；之后是用来创建镜像的容器的ID；最后指定目标image的仓库名和tag信息。创建成功后会返回这个image的id信息。 +其中，-m 来指定提交的说明信息，跟我们使用的版本控制工具一样；-a 可以指定更新的用户信息；之后是用来创建镜像的容器的ID；最后指定目标镜像的仓库名和tag信息。创建成功后会返回这个镜像的id信息。 -使用docker images来查看新创建的image。 +使用docker images来查看新创建的镜像。 ``` $ sudo docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE @@ -30,14 +30,14 @@ 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来启动容器 +之后，可以使用新的镜像来启动容器 ``` $ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash root@78e82f680994:/# ``` -###利用dockerfile 来创建 image -使用`docker commit` 来扩展一个image比较简单，但它不容易在一个团队中分享它。我们可以使用`docker build` 来创建一个新的image。为此，首先需要创建一个dockerfile，包含一些如何创建image的指令。 +###利用dockerfile 来创建镜像 +使用`docker commit` 来扩展一个镜像比较简单，但它不容易在一个团队中分享它。我们可以使用`docker build` 来创建一个新的镜像。为此，首先需要创建一个dockerfile，包含一些如何创建镜像的指令。 新建一个目录和一个dockerfile ``` @@ -45,7 +45,7 @@ $ mkdir sinatra $ cd sinatra $ touch Dockerfile ``` -Dockerfile中每一条指令都创建image的一层，例如： +Dockerfile中每一条指令都创建镜像的一层，例如： ``` # This is a comment FROM ubuntu:14.04 @@ -56,11 +56,11 @@ RUN gem install sinatra ``` Dockerfile基本的语法是 * 使用#来注释 -* FROM指令告诉docker 使用哪个image作为源image +* FROM指令告诉docker 使用哪个镜像作为基础 * 接着是维护者的信息 * RUN开头的指令会在创建中运行，比如安装一个软件包，在这里使用apt 来安装了一些软件 -编写完成Dockerfile后可以使用docker build来生成image。 +编写完成Dockerfile后可以使用docker build来生成镜像。 ``` $ sudo docker build -t="ouruser/sinatra:v2" . @@ -96,13 +96,13 @@ Successfully installed sinatra-1.4.5 Removing intermediate container 5e9d0065c1f7 Successfully built 324104cde6ad ``` -其中-t标记来添加tag，指定新的image的用户信息。 +其中-t标记来添加tag，指定新的镜像的用户信息。 .是Dockerfile所在的路径（当前目录），也可以替换为一个具体的Dockerfile的路径。 我们可以看到build进程在执行操作。它要做的第一件事情就是上传这个Dockerfile内容，因为所有的操作都要依据Dockerfile来进行。 -然后，dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器，在容器中执行指令并提交修改（就跟之前介绍过的`docker commit`一样）。当所有的指令都执行完毕之后，返回了最终的image id。所有的中间步骤所产生的容器都被删除和清理了。 +然后，dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器，在容器中执行指令并提交修改（就跟之前介绍过的`docker commit`一样）。当所有的指令都执行完毕之后，返回了最终的镜像 id。所有的中间步骤所产生的容器都被删除和清理了。 -*注意一个image不能超过127层 +*注意一个镜像不能超过127层 此外，还可以利用ADD命令复制本地文件到镜像；用EXPOSE命令来向外部开放端口；用CMD命令来描述容器启动后运行的程序等。例如 ``` @@ -115,13 +115,13 @@ CMD ["/usr/sbin/apachectl", "-D", "FOREGROUND"] ``` -现在可以利用新创建的images来启动一个容器。 +现在可以利用新创建的镜像来启动一个容器。 ``` $ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash root@8196968dac35:/# ``` -还可以用tag命令来修改images的tag。 +还可以用tag命令来修改镜像的tag。 ``` $ sudo docker tag 5db5f8471261 ouruser/sinatra:devel $ sudo docker images ouruser/sinatra diff --git a/image/download.md b/image/download.md deleted file mode 100644 index ab40fcb..0000000 --- a/image/download.md +++ /dev/null @@ -1,11 +0,0 @@ -##下载images -现在将尝试下载training/sinatra镜像，可以使用docker pull命令。 -``` -$ sudo docker pull training/sinatra -``` - -然后就可以使用这个image来启动容器了 -``` -$ sudo docker run -t -i training/sinatra /bin/bash -root@a8cb6ce02d85:/# -``` diff --git a/image/get.md b/image/get.md deleted file mode 100644 index 8580baa..0000000 --- a/image/get.md +++ /dev/null @@ -1,21 +0,0 @@ -##获取images - -我们如何获取新的images呢？当我们启动容器使用的image不在本地时，docker会自动从远端仓库（docker hub）下载它们，这需要消耗一些时间。 -因此，可以使用docker pull命令来预先下载所需要的image。 - -下面的例子下载一个centos镜像。 -``` -$ sudo docker pull centos -Pulling repository centos -b7de3133ff98: Pulling dependent layers -5cc9e91966f7: Pulling fs layer -511136ea3c5a: Download complete -ef52fb1fe610: Download complete -``` -下载过程中，会输出获取image的每一层信息。 - -下载完成后，即可随时创建并启动一个容器了。 -``` -$ sudo docker run -t -i centos /bin/bash -bash-4.1# -``` diff --git a/image/internal.md b/image/internal.md index 0d323ad..d956d4f 100644 --- a/image/internal.md +++ b/image/internal.md @@ -1,10 +1,10 @@ -##工作原理 +##镜像的工作原理 -docker image是怎么实现增量的修改和维护的？ -每个docker都有很多层次构成，docker使用 [Union FS](http://en.wikipedia.org/wiki/UnionFS) 将这些不同的层结合到一个image中去。 +Docker镜像是怎么实现增量的修改和维护的？ +每个docker都有很多层次构成，docker使用 [Union FS](http://en.wikipedia.org/wiki/UnionFS) 将这些不同的层结合到一个镜像中去。 Union FS是一种特殊的文件系统，它支持将不同目录挂载到同一个虚拟文件系统下(unite several directories into a single virtual filesystem), AUFS (AnotherUnionFS) 就是一种 Union FS, AUFS支持为每一个成员目录(类似Git Branch)设定readonly、readwrite 和 whiteout-able 权限, 同时 AUFS 里有一个类似分层的概念, 对 readonly 权限的 branch 可以逻辑上进行修改(增量地, 不影响 readonly 部分的)。 -通常 Union FS 有两个用途, 一方面可以实现不借助 LVM、RAID 将多个disk挂到同一个目录下, 另一个更常用的就是将一个 readonly 的 branch 和一个 writeable 的 branch 联合在一起，Live CD正是基于此方法可以允许在 OS image 不变的基础上允许用户在其上进行一些写操作。 -Docker 在 AUFS 上构建的 container image 也正是如此。 +通常 Union FS 有两个用途, 一方面可以实现不借助 LVM、RAID 将多个disk挂到同一个目录下, 另一个更常用的就是将一个 readonly 的 branch 和一个 writeable 的 branch 联合在一起，Live CD正是基于此方法可以允许在 OS 镜像不变的基础上允许用户在其上进行一些写操作。 +Docker 在 AUFS 上构建的容器也正是如此。 diff --git a/image/pull.md b/image/pull.md new file mode 100644 index 0000000..6503310 --- /dev/null +++ b/image/pull.md @@ -0,0 +1,19 @@ +##获取镜像 +可以使用docker pull命令来预先下载所需要的镜像。 + +下面的例子下载一个centos镜像。 +``` +$ sudo docker pull centos +Pulling repository centos +b7de3133ff98: Pulling dependent layers +5cc9e91966f7: Pulling fs layer +511136ea3c5a: Download complete +ef52fb1fe610: Download complete +``` +下载过程中，会输出获取镜像的每一层信息。 + +下载完成后，即可随时创建一个容器了。 +``` +$ sudo docker run -t -i centos /bin/bash +bash-4.1# +``` diff --git a/image/push.md b/image/push.md index 5c7d480..c7e6594 100644 --- a/image/push.md +++ b/image/push.md @@ -1,5 +1,5 @@ ##上传镜像 -用户也可以把自己创建的image上传到docker hub中来共享。 +用户也可以把自己创建的镜像上传到docker hub中来共享。 ``` $ sudo docker push ouruser/sinatra The push refers to a repository [ouruser/sinatra] (len: 1) diff --git a/image/rmi.md b/image/rmi.md index 3f28bcc..b54fe82 100644 --- a/image/rmi.md +++ b/image/rmi.md @@ -1,5 +1,5 @@ ##移除本地镜像 -如果要移除本地的image，可以使用rmi命令。注意rm命令是移除容器。 +如果要移除本地的镜像，可以使用`docker rmi`命令。注意`docker rm`命令是移除容器。 ``` $ sudo docker rmi training/sinatra Untagged: training/sinatra:latest @@ -8,4 +8,4 @@ Deleted: ed0fffdcdae5eb2c3a55549857a8be7fc8bc4241fb19ad714364cbfd7a56b22f Deleted: 5c58979d73ae448df5af1d8142436d81116187a7633082650549c52c3a2418f0 ``` -*注意：在删除images之前要先用`docker rm`删掉依赖于这个images的所有容器。 +*注意：在删除镜像之前要先用`docker rm`删掉依赖于这个镜像的所有容器。 diff --git a/image/search.md b/image/search.md index 6628a36..0fece29 100644 --- a/image/search.md +++ b/image/search.md @@ -1,8 +1,8 @@ ##查找images -docker hub是一个公共仓库，供用户上传和下载制作好的不同用途的image，我们可以在docker hub的网站上来查找满足自己需求的image。 +docker hub是一个公共仓库，供用户上传和下载制作好的不同用途的镜像，我们可以在docker hub的网站上来查找满足自己需求的镜像。 -使用docker search命令。比如，当开发团队需要ruby和sinatra作为web应用程序的开发时，可以使用docker search 来搜索合适的image，使用关键字sinatra +使用docker search命令。比如，当开发团队需要ruby和sinatra作为web应用程序的开发时，可以使用docker search 来搜索合适的镜像，使用关键字sinatra ``` $ sudo docker search sinatra @@ -17,11 +17,11 @@ bmorearty/sinatra ``` -可以看到返回了很多包含sinatra的images。其中包括image名字、描述、星级（表示该image的受欢迎程度）、是否官方创建、是否自动创建。 -官方的images是由stackbrew项目组创建和维护的，autimated 资源允许用户验证image的来源和内容。 +可以看到返回了很多包含sinatra的镜像。其中包括镜像名字、描述、星级（表示该image的受欢迎程度）、是否官方创建、是否自动创建。 +官方的镜像是由stackbrew项目组创建和维护的，autimated 资源允许用户验证image的来源和内容。 现在可以下载使用training/sinatra镜像。 -到目前为止，我们看到了2种images资源。 +到目前为止，我们看到了2种镜像资源。 一种是类似ubuntu这样的基础镜像，被称为基础或根镜像。这些基础镜像是由docker公司创建、验证、支持、提供。这样的镜像往往使用单个单词作为名字。 还有一种类型，比如training/sinatra镜像。它是由docker的用户创建并维护的，你可以通过指定image名字的前缀来指定使用某个用户的镜像，比如training。