From 71adb73dbbec14ffd63a4c12b572dce4228b366b Mon Sep 17 00:00:00 2001 From: Baohua Yang Date: Fri, 12 Sep 2014 16:18:24 +0800 Subject: [PATCH] Rewrite the content --- image/README.md | 3 ++- image/create.md | 68 ++++++++++++++++++++++++++--------------------- image/download.md | 9 ++++--- image/get.md | 11 +++++--- image/push.md | 3 ++- image/rmi.md | 5 ++-- image/search.md | 14 +++++++--- 7 files changed, 68 insertions(+), 45 deletions(-) diff --git a/image/README.md b/image/README.md index b03a1eb..b1f65d7 100644 --- a/image/README.md +++ b/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。 \ No newline at end of file +如果你不指定具体的发行版，比如仅使用ubuntu，那么docker会使用最新的发行版ubuntu:latest。 diff --git a/image/create.md b/image/create.md index 5102f07..7cacf16 100644 --- a/image/create.md +++ b/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 +MAINTAINER Docker Newbee 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 -``` \ No newline at end of file +``` diff --git a/image/download.md b/image/download.md index 01d535e..ab40fcb 100644 --- a/image/download.md +++ b/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:/# -``` \ No newline at end of file +``` diff --git a/image/get.md b/image/get.md index f0f37e4..8580baa 100644 --- a/image/get.md +++ b/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# -``` \ No newline at end of file +``` diff --git a/image/push.md b/image/push.md index ac5b71f..df35683 100644 --- a/image/push.md +++ b/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) -``` \ No newline at end of file +``` diff --git a/image/rmi.md b/image/rmi.md index 44abf6d..d89febe 100644 --- a/image/rmi.md +++ b/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的容器 \ No newline at end of file +*注意：在删除images之前要先用`docker rm`删掉依赖于这个images的所有容器。 diff --git a/image/search.md b/image/search.md index c2c1050..6628a36 100644 --- a/image/search.md +++ b/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。 \ No newline at end of file +现在可以下载使用training/sinatra镜像。 + +到目前为止，我们看到了2种images资源。 +一种是类似ubuntu这样的基础镜像，被称为基础或根镜像。这些基础镜像是由docker公司创建、验证、支持、提供。这样的镜像往往使用单个单词作为名字。 +还有一种类型，比如training/sinatra镜像。它是由docker的用户创建并维护的，你可以通过指定image名字的前缀来指定使用某个用户的镜像，比如training。