第八章 使用Dockerfile创建镜像

Dockerfile 是一个文本格式的配置文件，用户可以使用Dockerfile快速创建自定义的镜像。
本章介绍Dockerfile典型的基本结构及其支持的众多指令，并具体讲解通过这些指令来编写定制的Dockerfile。并介绍使用Dockerfile创建镜像的过程。

1 基本结构

Dockerfile由一行行命令语句组成，并且支持以#开头的注释行。
一般，Dockerfile分为四个部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。例如：

# This dockerfile uses the ubuntu image
# VERSION 2 - EDITION 1
# Author: docker_user
# Command format: Instruction [arguments / command] ..

# 第一行必须指定基于的基础镜像
FROM ubuntu

# 维护者信息
MAINTAINER docker_user docker_user@eamil.com

# 镜像的操作指令
RUN eho "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
2. 指令

一般格式：INSTRUCTION arguments，指令包括FROM、MAINTAINER、RUN等。

1. FROM

格式：FROM <image>或FROM <image>:<tag>
第一条指令必须为FROM指令，且若同一个Dockerfile中创建多个镜像时，可使用多个FROM指令（每个镜像一次）。

2. MAINTAINER

格式：MAINTAINER <name>，指定维护者信息

3. RUN

格式：RUN <command>或RUN ["executable","param1","param2"].
前者将在shell终端中运行指令，即 /bin/sh -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 <port> [<port>...]。
告诉Docker服务器容器暴露的端口号，供互联系统使用。

6. ENV

格式：ENV <key> <value>.指定环境变量，会被后续RUN指令使用，并在容器运行时保持。

7. ADD

格式：ADD <src> <dest>.
该指令将复制指定的 < src > 到容器中的 < dest >。
< src >可以是Dockerfile所在目录的一个相对路径（文件或目录）；也可以是一个URL；还可以是一个tar文件（自动解压为目录）。

8. COPY

格式：COPY <src> <dest>.
复制本地主机的 < src >（为Dockerfile所在目录的相对路径，文件或目录）为容器中的< dest >。目标路径不存在时会自动创建。
当使用本地目录为源目录时，推荐。

9. ENTRYPOINT

两种格式：
ENTRYPOINT ["executable","param1","param2"]
ENTRYPOINT command param1 param2（shell中执行）。
配置容器启动后执行的命令，且不可被docker run提供的参数覆盖。
每个Dockerfile中只能有一个，当指定多个该命令时，仅最后一个生效。

10. VOLUME

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

11. USER

格式：USER daemon.
指定运行容器时的用户名或UID，后续的RUN也会使用指定用户。
当服务不需要管理员权限时，可通过该命令指定运行用户。且可以在之前创建所需要的用户。要临时获取管理员权限可以gosu，不推荐sudo。

12. WORKDIR

格式：WORKDIR /path/to/workdir
为后续的RUN、CMD、ENTRYPOINT指定配置工作目录。
可以使用多个WORKDIR指令，后续命令如果参数为相对路径，则会基于之前命令指定的路径。

13. ONBUILD

格式：ONBUILD [INSTRUCTION]
配置当所创建的镜像作为其他新创建镜像的基础镜像时，所执行的操作指令。

3. 创建镜像

编写完Dockerfile后，可通过docker build 命令创建镜像。
基本格式为docker build [选项] 路径，该命令将读取指定路径下（包括子目录）的Dockerfile，并将该路径下所有内容发送到Docker服务端，由服务端创建镜像。因此建议放置Dockerfile的目录为空目录。
通过.dockerignor文件（每一行添加一个匹配模式）来让Docker忽略路径下的目录和文件。
要指定镜像的标签信息，可通过 - t 选项。