八、【Docker笔记】使用Dockerfile创建镜像

在前面我们讲解了基于已有的镜像容器创建和基于本地模板导入两种方式来创建镜像，在这里我们就来说说第三种创建镜像的方式。Dockerfile是一个文本格式的配置文件，我们可以通过Dockerfile快速创建自定义的镜像。

一、基本结构

Dockerfile是由多行命令语句组成的，并且在文件中支持以 # 开始的注释行。我们一般将Dockerfile文件分为四部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。其中，第一行（不包含注释行）必须指定基于的基础镜像，例如：FROM ubuntu。之后可以是维护者信息，如：MAINTAINER gongziqi 14155830994@qq.com。再往后可以是镜像的操作指令，如：

RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list

RUN apt-get update && apt-get install -y nginx

RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf

最后可以是容器启动时执行指令，如：CMD /usr/sbin/nginx。

# 0. 在ubuntu镜像的基础上，安装inotify-tools/nginx/apache2/openssh-server等，创建新的Nginx镜像
	# Nginx
	# VERSION 1.0
	FROM ubuntu
	MAINTAINER gongziqi 1415583094@qq.com
	RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server

# 1. 在ubuntu镜像基础上，安装firefox/vnc。启动后，用户可通过5900端口通过vnc方式使用firefox
	# FireFox over VNC
	# VERSION 1.0
	FROM ubuntu
	RUN apt-get update && apt-get install -y x11vnc xvfb firefox
	RUN mkdir ./.vnc
	RUN x11vnc -storepasswd 123456 ~/.vnc/passwd
	RUN bash -c 'echo "firefox" >> /.bashrc'
	EXPOSE 5900
	CMD ["x11vnc","-forever","usepw","-create"]

二、指令

1、FROM

语法为：FROM 或 FROM :。若在同一个Dockerfile中创建多个镜像，可以使用多个FROM即每个镜像一个。

2、MAINTAINER

语法：MAINTAINER ，用来指定维护者信息。

3、RUN

语法：RUN 或 RUN ["executable","param1","param2"]。第一个将在shell终端中运行命令，即 /bin/bash -c；第二个则使用 exec 执行。每条RUN指令将在当前镜像基础上执行指定指令，并提交为新的镜像。若命令行太长可以使用 \ 来换行书写。

4、CMD

支持三种方式：

• CMD ["executable", "param1", "param2"]，使用 exec执行，推荐方式。

• CMD command param1 param2，在 /bin/sh 中执行，提供给需要交互的应用。

• CMD ["param1","param2"]，提供给 ENTRYPOINT的默认参数。

  指定启动容器时执行的命令，每个Dockerfile只能由一条 CMD命令。若指定多条，则只有最后一条有效。若在启动容器时，指定了运行的命令，则CMD命令将会被覆盖。

5、EXPOSE

语法：EXPOSE [ ...]，如：EXPOSE 22 80 8443，即告诉Docker服务器容器暴露的端口，这些端口可供互联使用。此时在容器启动中，可使用 -P 来随机指定一个端口，也可使用 -p 来指定具体的端口映射。

6、ENV

语法：ENV 。指定一个环境变量，会被后面的RUN指令使用，并在容器运行时保持。如：

ENV PG_MAJOR 9.3
ENV PG_VERSION 9.3.4
RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && ...
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH

7、ADD

语法：ADD 。将复制指定的src到容器中的desc。其中，src 可以是Dockerfile所在目录的一个相对路径（文件/目录）；也可为一个URL；还可为一个tar文件。

8、COPY

语法：COPY 。复制本地主机的src（Dockerfile所在目录的相对路径）到容器中的desc。当目标路径不存在时，将自动创建。当使用本地目录为源目录时，推荐使用COPY，不推荐ADD。

9、ENTRYPOINT

语法：ENTRYPOINT ["executable","param1","param2"] 或 ENTRYPOINT command param1 param2(shell中执行)。配置容器启动后执行的命令，并且不可被docker run 提供的参数覆盖。每个Dockerfile只能有一个ENTRYPOINT，当指定多个时，只有最后一个有效。

10、VOLUME

语法：VOLUME ["/data"]。创建一个可以从本地主机或其他容器挂载的挂载点，一般用来存放数据库和需要保持的数据等。

11、USER

语法：USER daemon。指定运行容器时的用户名或UID，后续的RUN指令也会使用指定用户。当服务不需要管理员权限时，可通过该命令指定运行用户，并且可以在之前创建所需要的用户。如：RUN groupadd -r postgres && useradd -r -g postgres postgres。若此时需要临时获取管理员权限，则可使用gosu，不推荐使用sudo。

12、WORKDIR

语法：WORKDIR /path/to/workdir。为后续的 RUN、CMD、ENTRYPOINT指令配置工作目录。可使用多个WORKDIR，若后面的WORKDIR指定的是相对路径，则是基于前一个WORKDIR指定的路径。如：

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
# 结果为：/a/b/c

13、ONBUILD

语法：ONBUILD [INSTRUCTION]。配置当所创建的镜像作为其他新创建镜像的基础镜像时，所执行的操作指令。如：Dockerfile使用如下的内容创建了镜像 image-A。

[...]
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
[...]

若基于image-A创建新的镜像时，新的Dockerfile中使用 FROM image-A指定基础镜像时，会自动执行 ONBUILD 指令内容，即等价于在 FROM指令后添加了以上的两条指令。在使用ONBUILD指令的镜像，我们推荐在标签中注明，如：ruby:1.9-onbuild。

三、创建镜像

在编写完Dockerfile之后，可以通过 Docker build 命令来创建镜像。语法为：docker build [选项] 路径，即读取指定路径下的Dockerfile，并将该路径下所有内容发送给Docker服务端，由服务端来创建镜像。因此我们建议放置Dockerfile的目录为空目录。若为非空目录，希望忽略路径下的某些目录或文件，可通过 .dockerignore文件来配置。

# 指定Dockerfile路径所在路径为 /tmp/docker_builder/,希望生成镜像标签为 build_repo/first_image， # 在标签命名时需要注意，所有字母必须为小写
$ sudo docker build -t build_repo/first_image /tmp/docker_builder/

四、一个实例

根据以上信息，我们来自己创建一个Nginx镜像。

# 0. 创建Dockerfile所在目录
$ sudo mkdir /opt/tmp_dockerbuilder

# 1. 创建Dockerfile文件并编写内容
$ sudo vim Dockerfile
	# Nginx
	# VERSION 1.0
	FROM ubuntu
	MAINTAINER gongziqi 1415583094@qq.com
	RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server

# 2. 查看当前本地镜像
$ sudo docker images
REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE

# 3. build Dockerfile文件，创建镜像
$ sudo docker build -t nginx/mynginx /opt/tmp_dockerbuilder/Dockerfile
Sending build context to Docker daemon  2.048kB
Step 1/3 : FROM ubuntu
 ---> 4e5021d210f6
Step 2/3 : MAINTAINER gongziqi 1415583094@qq.com
 ---> Running in 8dc5269da475
Removing intermediate container 8dc5269da475
 ---> e27af3f3a447
Step 3/3 : RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server
 ---> Running in 2ec0f5b9fc81
 ........
 ........
 ........
Successfully built d27de6c7896d
Successfully tagged nginx/mynginx:latest

# 4. 再次查看本地镜像
$ sudo docker images
REPOSITORY           TAG                 IMAGE ID            CREATED             SIZE
nginx/mynginx        latest              d27de6c7896d        6 minutes ago       275MB

# 5. 以当前创建的镜像运行容器
$ sudo docker run -ti d27de6c7896d /bin/bash
root@a505965d1b84:/#

# 6. 查看当前的容器中是否有我们刚才需要安装的相关软件
root@a505965d1b84:/# find / -name apache2
/etc/cron.daily/apache2
/etc/init.d/apache2
/etc/logrotate.d/apache2
/etc/apache2
/etc/ufw/applications.d/apache2
find: '/proc/1/map_files': Operation not permitted
find: '/proc/12/map_files': Operation not permitted
/usr/lib/apache2
/usr/sbin/apache2
/usr/share/bug/apache2
/usr/share/doc/apache2
/usr/share/lintian/overrides/apache2
/usr/share/apache2
/var/cache/apache2
/var/lib/apache2
/var/log/apache2

# 7. 查看ubuntu镜像运行的容器中是否有apache2
$ sudo docker run -tid ubuntu /bin/bash
$ sudo docker exec -ti 6df8ff14f57f /bin/bash
root@6df8ff14f57f:/# find / -name apache2
find: '/proc/1/map_files': Operation not permitted
find: '/proc/10/map_files': Operation not permitted
find: '/proc/19/map_files': Operation not permitted
root@6df8ff14f57f:/#

# 说明：我们会发现刚才的配置的 apache2 软件已被安装，而基于的 ubuntu镜像本身是没有apache2的