Fix issue#20, format following the guidelines

This commit is contained in:
Baohua Yang
2014-10-14 13:25:01 +08:00
parent 9d26f96ba2
commit cb903202ba
81 changed files with 682 additions and 679 deletions

View File

@@ -1,8 +1,8 @@
# Docker镜像
# Docker 镜像
在之前的介绍中我们知道镜像是Docker的三大组件之一。
在之前的介绍中,我们知道镜像是 Docker 的三大组件之一。
Docker运行容器前需要本地存在对应的镜像如果镜像不存在本地Docker会从镜像仓库下载默认是Docker Hub公共注册服务器中的仓库
Docker 运行容器前需要本地存在对应的镜像如果镜像不存在本地Docker 会从镜像仓库下载(默认是 Docker Hub 公共注册服务器中的仓库)。
本章将介绍更多关于镜像的内容,包括:
* 从仓库获取镜像;

View File

@@ -1,6 +1,6 @@
##创建镜像
创建镜像有很多方法用户可以从Docker Hub获取已有镜像并更新也可以利用本地文件系统创建一个。
创建镜像有很多方法,用户可以从 Docker Hub 获取已有镜像并更新,也可以利用本地文件系统创建一个。
### 修改已有镜像
先使用下载的镜像启动容器。
@@ -8,21 +8,21 @@
$ sudo docker run -t -i training/sinatra /bin/bash
root@0b2616b0e5a8:/#
```
注意记住容器的ID ,稍后还会用到。
注意:记住容器的 ID稍后还会用到。
在容器中添加jsongem两个应用。
在容器中添加 jsongem 两个应用。
```
root@0b2616b0e5a8:/# gem install json
```
当结束后我们使用exit来退出现在我们的容器已经被我们改变了使用docker commit命令来提交更新后的副本。
当结束后,我们使用 exit 来退出,现在我们的容器已经被我们改变了,使用 `docker commit` 命令来提交更新后的副本。
```
$ sudo docker commit -m "Added json gem" -a "Docker Newbee" 0b2616b0e5a8 ouruser/sinatra:v2
4f177bd27a9ff0f6dc2a830403925b5360bfe0b93d476f7fc3231110e7f71b1c
```
其中,-m 来指定提交的说明信息,跟我们使用的版本控制工具一样;-a 可以指定更新的用户信息之后是用来创建镜像的容器的ID最后指定目标镜像的仓库名和tag信息。创建成功后会返回这个镜像的id信息。
其中,`-m` 来指定提交的说明信息,跟我们使用的版本控制工具一样;`-a` 可以指定更新的用户信息;之后是用来创建镜像的容器的 ID最后指定目标镜像的仓库名和 tag 信息。创建成功后会返回这个镜像的 ID 信息。
使用docker images来查看新创建的镜像。
使用 `docker images` 来查看新创建的镜像。
```
$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
@@ -36,16 +36,16 @@ $ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash
root@78e82f680994:/#
```
###利用dockerfile 来创建镜像
使用`docker commit` 来扩展一个镜像比较简单,但它不容易在一个团队中分享它。我们可以使用`docker build` 来创建一个新的镜像。为此,首先需要创建一个dockerfile包含一些如何创建镜像的指令。
###利用 Dockerfile 来创建镜像
使用 `docker commit` 来扩展一个镜像比较简单,但它不容易在一个团队中分享它。我们可以使用 `docker build` 来创建一个新的镜像。为此,首先需要创建一个 Dockerfile包含一些如何创建镜像的指令。
新建一个目录和一个dockerfile
新建一个目录和一个 Dockerfile
```
$ mkdir sinatra
$ cd sinatra
$ touch Dockerfile
```
Dockerfile中每一条指令都创建镜像的一层例如
Dockerfile 中每一条指令都创建镜像的一层,例如:
```
# This is a comment
FROM ubuntu:14.04
@@ -54,13 +54,13 @@ RUN apt-get -qq update
RUN apt-get -qqy install ruby ruby-dev
RUN gem install sinatra
```
Dockerfile基本的语法是
* 使用#来注释
* FROM指令告诉docker 使用哪个镜像作为基础
Dockerfile 基本的语法是
* 使用`#`来注释
* `FROM` 指令告诉 Docker 使用哪个镜像作为基础
* 接着是维护者的信息
* RUN开头的指令会在创建中运行比如安装一个软件包在这里使用apt 来安装了一些软件
* `RUN`开头的指令会在创建中运行,比如安装一个软件包,在这里使用 apt-get 来安装了一些软件
编写完成Dockerfile后可以使用docker build来生成镜像。
编写完成 Dockerfile 后可以使用 `docker build` 来生成镜像。
```
$ sudo docker build -t="ouruser/sinatra:v2" .
@@ -96,15 +96,15 @@ Successfully installed sinatra-1.4.5
Removing intermediate container 5e9d0065c1f7
Successfully built 324104cde6ad
```
其中-t标记来添加tag指定新的镜像的用户信息。
“.”Dockerfile所在的路径当前目录也可以替换为一个具体的Dockerfile的路径。
其中 `-t` 标记来添加 tag指定新的镜像的用户信息。
“.”Dockerfile 所在的路径(当前目录),也可以替换为一个具体的 Dockerfile 的路径。
我们可以看到build进程在执行操作。它要做的第一件事情就是上传这个Dockerfile内容因为所有的操作都要依据Dockerfile来进行。
然后,dockfile中的指令被一条一条的执行。每一步都创建了一个新的容器在容器中执行指令并提交修改就跟之前介绍过的`docker commit`一样)。当所有的指令都执行完毕之后,返回了最终的镜像 id。所有的中间步骤所产生的容器都被删除和清理了。
可以看到 build 进程在执行操作。它要做的第一件事情就是上传这个 Dockerfile 内容,因为所有的操作都要依据 Dockerfile 来进行。
然后,Dockfile 中的指令被一条一条的执行。每一步都创建了一个新的容器,在容器中执行指令并提交修改(就跟之前介绍过的 `docker commit` 一样)。当所有的指令都执行完毕之后,返回了最终的镜像 id。所有的中间步骤所产生的容器都被删除和清理了。
*注意一个镜像不能超过127层
*注意一个镜像不能超过 127
此外,还可以利用ADD命令复制本地文件到镜像用EXPOSE命令来向外部开放端口CMD命令来描述容器启动后运行的程序等。例如
此外,还可以利用 `ADD` 命令复制本地文件到镜像;用 `EXPOSE` 命令来向外部开放端口;用 `CMD` 命令来描述容器启动后运行的程序等。例如
```
# put my local web site in myApp folder to /var/www
ADD myApp /var/www
@@ -119,7 +119,7 @@ CMD ["/usr/sbin/apachectl", "-D", "FOREGROUND"]
$ sudo docker run -t -i ouruser/sinatra:v2 /bin/bash
root@8196968dac35:/#
```
还可以用`docker tag`命令来修改镜像的标签。
还可以用 `docker tag` 命令来修改镜像的标签。
```
$ sudo docker tag 5db5f8471261 ouruser/sinatra:devel
$ sudo docker images ouruser/sinatra
@@ -129,13 +129,13 @@ ouruser/sinatra devel 5db5f8471261 11 hours ago 446.7 MB
ouruser/sinatra v2 5db5f8471261 11 hours ago 446.7 MB
```
*注:更多用法,请参考dockerfile章节。
*注:更多用法,请参考 [Dockerfile](../dockerfile/README.md) 章节。
### 从本地文件系统导入
要从本地文件系统导入一个镜像可以使用openvz容器虚拟化的先锋技术的模板来创建
openvz的模板下载地址为http://openvz.org/Download/templates/precreated。
要从本地文件系统导入一个镜像,可以使用 openvz容器虚拟化的先锋技术的模板来创建
openvz 的模板下载地址为 http://openvz.org/Download/templates/precreated。
比如先下载了一个ubuntu14.04的镜像,之后使用以下命令导入:
比如先下载了一个 ubuntu-14.04 的镜像,之后使用以下命令导入:
```
sudo cat ubuntu-14.04-x86_64-minimal.tar.gz |docker import - ubuntu:14.04
```
@@ -147,7 +147,7 @@ ubuntu 14.04 05ac7c0b9383 17 seconds ago
```
###上传镜像
用户可以通过`docker push`命令把自己创建的镜像上传到仓库中来共享。例如用户在Docker Hub上完成注册后可以推送自己的镜像到仓库中。
用户可以通过 `docker push` 命令,把自己创建的镜像上传到仓库中来共享。例如,用户在 Docker Hub 上完成注册后,可以推送自己的镜像到仓库中。
```
$ sudo docker push ouruser/sinatra
The push refers to a repository [ouruser/sinatra] (len: 1)

View File

@@ -1,7 +1,7 @@
## 镜像的实现原理
Docker镜像是怎么实现增量的修改和维护的
每个镜像都由很多层次构成Docker使用 [Union FS](http://en.wikipedia.org/wiki/UnionFS) 将这些不同的层结合到一个镜像中去。
Docker 镜像是怎么实现增量的修改和维护的?
每个镜像都由很多层次构成Docker 使用 [Union FS](http://en.wikipedia.org/wiki/UnionFS) 将这些不同的层结合到一个镜像中去。
通常Union FS有两个用途, 一方面可以实现不借助 LVM、RAID 将多个disk挂到同一个目录下,另一个更常用的就是将一个只读的分支和一个可写的分支联合在一起Live CD正是基于此方法可以允许在镜像不变的基础上允许用户在其上进行一些写操作。
DockerAUFS上构建的容器也是利用了类似的原理。
通常 Union FS 有两个用途, 一方面可以实现不借助 LVM、RAID 将多个 disk 挂到同一个目录下,另一个更常用的就是将一个只读的分支和一个可写的分支联合在一起Live CD 正是基于此方法可以允许在镜像不变的基础上允许用户在其上进行一些写操作。
DockerAUFS 上构建的容器也是利用了类似的原理。

View File

@@ -1,5 +1,5 @@
## 列出本地镜像
使用`docker images`显示本地已有的镜像。
使用 `docker images` 显示本地已有的镜像。
```
$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
@@ -13,17 +13,17 @@ ubuntu trusty 99ec81b80c55 4 weeks ago 266 MB
在列出信息中,可以看到几个字段信息
* 来自于哪个仓库比如ubuntu
* 来自于哪个仓库,比如 ubuntu
* 镜像的标记,比如 14.04
* 它的`ID`号(唯一)
* 它的 `ID` 号(唯一)
* 创建时间
* 镜像大小
其中镜像的`ID`唯一标识了镜像,注意到`ubuntu:14.04``ubuntu:trusty`具有相同的镜像`ID`,说明它们实际上是同一镜像。
其中镜像的 `ID` 唯一标识了镜像,注意到 `ubuntu:14.04``ubuntu:trusty` 具有相同的镜像 `ID`,说明它们实际上是同一镜像。
`TAG`信息用来标记来自同一个仓库的不同镜像。例如`ubuntu`仓库中有多个镜像,通过`TAG`信息来区分发行版本例如10.04、12.04、12.10、13.04、14.04等。例如下面的命令指定使用镜像`ubuntu:14.04`来启动一个容器。
`TAG` 信息用来标记来自同一个仓库的不同镜像。例如 `ubuntu` 仓库中有多个镜像,通过 `TAG` 信息来区分发行版本,例如 `10.04``12.04``12.10``13.04``14.04` 等。例如下面的命令指定使用镜像 `ubuntu:14.04` 来启动一个容器。
```
$ sudo docker run -t -i ubuntu:14.04 /bin/bash
```
如果不指定具体的标记,则默认使用`latest`标记信息。
如果不指定具体的标记,则默认使用 `latest` 标记信息。

View File

@@ -1,8 +1,8 @@
## 获取镜像
可以使用`docker pull`命令来从仓库获取所需要的镜像。
可以使用 `docker pull` 命令来从仓库获取所需要的镜像。
下面的例子将从Docker Hub仓库下载一个Ubuntu 12.04操作系统的镜像。
下面的例子将从 Docker Hub 仓库下载一个 Ubuntu 12.04 操作系统的镜像。
```
$ sudo docker pull ubuntu:12.04
Pulling repository ubuntu
@@ -15,7 +15,8 @@ ffdaafd1ca50: Download complete
d047ae21eeaf: Download complete
```
下载过程中,会输出获取镜像的每一层信息。
该命令实际上相当于`$ sudo docker pull registry.hub.docker.com/ubuntu:12.04`命令,即从注册服务器`registry.hub.docker.com`中的`ubuntu`仓库来下载标记为`12.04`的镜像。
该命令实际上相当于 `$ sudo docker pull registry.hub.docker.com/ubuntu:12.04` 命令,即从注册服务器 `registry.hub.docker.com` 中的 `ubuntu` 仓库来下载标记为 `12.04` 的镜像。
有时候官方仓库注册服务器下载较慢,可以从其他仓库下载。
从其它仓库下载时需要指定完整的仓库注册服务器地址。例如
@@ -31,7 +32,7 @@ ffdaafd1ca50: Download complete
d047ae21eeaf: Download complete
```
完成后即可随时使用该镜像了例如创建一个容器让其中运行bash应用。
完成后,即可随时使用该镜像了,例如创建一个容器,让其中运行 bash 应用。
```
$ sudo docker run -t -i ubuntu:12.04 /bin/bash
root@fe7fc4bd8fc9:/#

View File

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

View File

@@ -1,7 +1,7 @@
## 存出和载入镜像
### 存出镜像
如果要导出镜像到本地文件,可以使用`docker save`命令。
如果要导出镜像到本地文件,可以使用 `docker save` 命令。
```
$ sudo docker images
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
@@ -11,7 +11,7 @@ $sudo docker save -o ubuntu_14.04.tar ubuntu:14.04
```
### 载入镜像
可以使用`docker load`从导出的本地文件中再导入到本地镜像库,例如
可以使用 `docker load` 从导出的本地文件中再导入到本地镜像库,例如
```
$ sudo docker load --input ubuntu_14.04.tar
```