dockerfile 指令解析

1.基础结构

dockerfile 由一行行命令语句组成，并且支持以 # 开头的注释

dockerfile 分为四部分

1. 基础镜像信息

2. 维护者信息

3. 镜像操作指令

4. 容器启动执行指令

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

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

#镜像的操作命令
RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list
RUN apt-get update && apt-get install nginx -y 
RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf

#容器启动时执行指令
CMD  /usr/sbin/nginx

其中，一开始必须指明所基于的镜像名称，接下来一般会说明维护者信息

后面则是镜像操作指令，例如 RUN 指令，RUN指令将对镜像执行跟随额命令。每运行一条RUN指令，镜像添加新的一层，并提交。最后是CMD指令，来指定运行容器时的操作命令。

例子on.1 

在父镜像基础上安装inotify-tools, nginx ,apache2, openssh-server 从而创建一个新的Nginx镜像

例子no.2 s

基于ubuntu 镜像，安装firefox和vnc 软件，启动后可以通过5900 端口通过vnc方式使用firefox;

# Firefox over VNC 
#
# VERSION  0.3

FROM ubuntu

# Install vnc,xvfb in order to create a 'fake' display and firefox
RUN apt-get update && apt-get install -y xllvnc xvfb firefox
RUN mkdir /.vnc

#Autostart firefox (might not be the best way, but it does the trick)
RUN bash -c 'echo "firefox" >> /.bashrc'

EXPOSE 5900
CMD ["xllvnc", "-forever","-usepw","-create"]

2.配置指令

指令的一般格式为 INSTRUCTION arguments,指令包括FROM,MAINTAINER,RUN 等

2.1. ARG 

定义创建镜像过程中使用的变量。

格式为ARG <name>[=<default value>]

        在执行 docker build 时，可以通过-build-arg [=]来为变量赋值。当镜像编译成功后，ARG指定的变量将不再存在（ENV指定的变量将在镜像中保留）

        Docker 内置了一些镜像创建变量，用户可以直接使用而无须声明，包括（不区分大小写）HTTP_PROXY,HTTPS_PROXY,FTP_PROXY,NO_PROXY.

2.2. FROM

格式为FROM <image> 或 FROM<image>:<tag>.
第一条指令必须为FROM指令。并且，如果在同一个Dockerfile钟创建多个镜像时，可以使用多个FROM 指令(每个镜像一次)

2.3. LABEL

LABEL指令可以生成的镜像添加元数据标签消息。这些信息可以用来辅助过滤出特定镜像

格式为： LABEL <key>=<value> <key>=<value> <key>=<value> ...。

如：

LABEL version="1.0.0-rc3"
LABEL author="yeasy@github" date="2020-01-01"
LABEL description="This text illustrates \
      that label-values can span multiple lines."

2.4. EXPOSE

格式为EXPOSE <port> [<port>. . .]

例如：

EXPOSE 22 80 8443

注意：该指令只是起到声明作用，并不会自动完成端口映射

若映射端口出来，在启动容器时需要通过-P，Docker 主机会自动分配一个端口转发到指定的端口;使用-p ,则可以具体指定哪个本地端口映射过来。

2.5. ENV

指定环境变量，在镜像生成过程中会被后续RUN指令使用，在镜像启动的容器中也会存在。

格式为 ENV <key> <value>或ENV  <key>=<value> ... 。
如下: 

ENV APP_VERSION=1.0.0
ENV APP_HOME=/usr/local/app
ENV PATH $PATH:/usr/local/bin

指令指定的环境变量在运行时可以被覆盖掉，如:

docker run --env <key>=<value> built_image

注意当一条ENV指令中同时为多个环境变量赋值并且值也是从环境变量读取时，会为变量都赋值后再更新。

ENV key1=value2

ENV key1=value1 key2=${key1}

结果为：

key1=value1  key2=value2

2.6. ENTRYPOINT

指定镜像的默认入口命令，该入口命令会在启动容器时作为根命令执行，所有传入值作为该命令的参数。

两种格式：

ENTRYPOINT ["exectable","param1","param2"]:exec调用执行;

ENTRYPOINT command param1 param2:(shell 中执行)

此时，CMD指令指定值将作为跟命令的参数。
每个Dockerfile 中只能有一个 ENTRYPOINT ,当指定多个 ENTRYPOINT 时，只有最后一个生效

在运行时，可以被 --entrypoint参数覆盖掉，如 docker run --entrypoint。

2.7. VOLUME

创建一个数据卷挂载点

格式为 VOLUME   ["/data"]
运行容器时可以从本地主机或其他容器挂载数据卷，一般用来存放数据库和需要保持的数据等。

2.8. USER 

格式为 USER daemon.
指定运行容器时的用户名和 UID ，后续的 RUN 也会使用指定用户。

当服务不需要管理员权限时，可以通过该命令指定运行用户。并且可以在Dockerfile创建所需要的用户，

例如:

RUN groupadd -r postpres && useradd --no-log-init -r -g postpres postpres

要临时获取管理员权限可以使用goso，而不推荐sudo

2.9. WORKDIR 

指定当基于所生成镜像创建子镜像时，自动指定的操作指令。

为后续的 RUN,CMD,ENTRYPOINT 指令配置工作目录

格式为 WORKDIR /path/to/workdir.

可以使用多个 WOEKDIR 指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径，例如：

WOEKDIR /a
WOEKDIR b
WOEKDIR c
RUN pwd 

则最终路径为 /a/b/c  

为了避免出错，WORKDIR指令中使用绝对命令

2.10. ONBUILD 

指定当基于所生成镜像创建子镜像时，自动执行的操作指令

格式为 ONBUILD [INSTRUCTION]

例如，使用如下的 Dockerfile 创建父镜像 Parent Image ，指定 ONBUILD指令；

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

使用 docker build 命令创建子镜像ChildImage时（FROM Parent Image），会首先执行ParentImage中配置的ONBUILD指令；

# Dockerfile for ChildImage
From ParentImage

等价于ChildImage的Dockerfile中添加了如下指令；

#Automatically run the following
ADD . /app/src
RUN /usr/local/bin/python-build --dir /app/src

由于 ONBUILD 指令是隐式执行的，推荐在使用它的镜像标签中进行标注， 例如 ruby:2.l-onbuild

ONBUILD 指令在创建专门用于自动编译、检查等操作的基础镜像时，十分有用.

2.11 STOPSIGNAL

指定所创建镜像启动的容器接收退出的信号值

STOPSIGNAL signal

2.12 HEALTHCHECK

配置所启动容器如何进行健康检查

HEALTHCHECK [OPTIONS] CMD command ：根据所执行命令返回值是否为0来判断

HEALTHCHECK NONE ：禁止基础镜像中的健康检查

OPTION支持如下参数:

-interval=DURATION (default: 30s ）：过多久检查一次

-timeout=DURATION (default: 30s 每次检查等待结果的超时

－retries=N (default :3 ）：如果失败了，重试几次才最终确定失败

2.13 SHELL

指定其他命令使用shell时默认shell类型:

SHELL ["executable","parameters"]

默认值为[ "/bin/sh","-c" ]

3.操作指令

3.1 RUN

运行指定命令。

        格式为 RUN <command>或RUN ["executable","param2","param2"].注意后者指令会被解析为JSON数组，因此必须用双引号。前者将在shell终端中运行命令，即/bin/sh -c ; 后者则使用exec执行。

指定使用其他终端可以通过第二种方式实现，例如：

 RUN ["/bin/bash","-c"，"echo hello"]

每条RUN指令将在当前镜像基础上执行指定命令，并提交为新的镜像层。当命令较长时可以使用 \ 来换行

RUN apt-get update \
    && apt-get install -y libsnappy-dev zliblg-dev libbz2-dev \
    && rm -rf /vat/cache/apt \
    && rm -rf /var/lib/apt/lists/*

3.2 .CMD 

 CMD指令用来指定启动容器时默认执行的命令。

支持三种格式
1. CMD ["executable","param1","param2"] ： ］：相当于执行 executable param 1 param2 ，推荐方式；
2. CMD command param1 param2 在/bin/bash 中执行，提供给需要交互的应用
3. CMD ["param1","param2"]提供给ENTRYPOINT的默认参数

每个Dockerfile 只能有一条CMD命令。如果指定了多条命令，只有最有一条会被执行

如果用户启动容器时候指定了运行的命令(作为run命令的参数)，则会覆盖掉CMD指令的命令

3.3 .ADD 

添加内容到镜像。

格式为ADD <src>  <dest>

复制本地主机的<src>到容器中的<dest>路径下.

其中<src>可以是Dockerfile 所在目录的一个相对路径（文件或目录）；也可以是一个URL ；还可以是一个 tar 文件(自动解压为目录) <dest>可以使镜像内的绝对路径，或者相对于工作目录(WORKDIR)的相对路径

路径支持正则格式，

ADD *.c /code/

3.4 . COPY

复制内容到镜像。

格式为COPY <src> <dest>

复制本地主机的<src>(为Dockerfile 所在目录的相对路径，文件或目录)为容器中的<dest>.目标路径不存在时，会自动创建

路径支持正则格式

当使用本地目录为源目录时，推荐使用COPY

4. 创建镜像

    编写完成Dockerfile 之后，可以通过docker build 命令创建镜像
    基于的格式为 docker build [选项] 路径

    该命令读取指定路径下(包括子目录)的Dockfile ,并将该路径下所有内容发送给 Docker 服务端，并由服务器创建镜像。因此一般建议放置 Docker 的目录为空目录
另外，可以通过 .dockerignore 文件(每一行添加一条匹配模式) 来让 Docker 忽略路径下的目录和文件。
要指定镜像的标签信息 可以通过 -t 选项
例如，指定 Dockerfile 所在路径为 /data/docker/, 并且希望生成镜像标签为 build_repo/fire_image ,可以使用以下命令

docker build -t build_repo/first_image /data/docker/

4.1 命令选项

docker [image] build命令支持一系列的选项，可以调整创建镜像过程的行为

4.2 使用.dockerignore文件

    可以通过.dockerignore文件(每一行添加一条匹配模式)来让Docker忽略匹配路径或文件，在创建镜像时不将五官数据发送到服务端。

    如：6行忽略的模式(第一行为注释)

# .dockerignore 文件中可以定义忽略模式
*/temp*
*/*/t emp*
tmp?
-*
Dockerfile
!README.md 

dockerignore 文件中模式语法支持 Golang 风格的路径正则格式：
"*"表示任意多个字符；
"?"代表单个字符；
"!"表示不匹配（即不忽略指定的路径或文件）