Dockerfile详解

环境介绍

1. Dockerfile中所用的所有文件一定要和Dockerfile文件在同一级父目录下，可以为Dockerfile父目录的子目录
2. Dockerfile中相对路径默认都是Dockerfile所在的目录
3. Dockerfile中一定要惜字如金，能写到一行的指令，一定要写到一行，原因是分层构建，联合挂载这个特性。
4. Dockerfile中每一条指令被视为一层
5. Dockerfile中指明大写（约定俗成）

指令介绍

1. 指定基础镜像FROM

功能为指定基础镜像，并且必须是第一条指令。
如果不以任何镜像为基础，那么写法为：FROM scratch。
同时意味着接下来所写的指令将作为镜像的第一层开始

FROM <image>
FROM <image>:<tag>
FROM <image>:<digest> 
三种写法，其中<tag>和<digest> 是可选项，如果没有选择，那么默认值为latest

2.指定作者 MAINTAINER

MAINTAINER <name>

3. 指定标签LABEL

LABEL会继承基础镜像种的LABEL，如遇到key相同，则值覆盖

LABEL <key>=<value> <key>=<value> <key>=<value> ...
 一个Dockerfile种可以有多个LABEL，如下：

LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."
 但是并不建议这样写，最好就写成一行，如太长需要换行的话则使用\符号

如下：

LABEL multi.label1="value1" \
multi.label2="value2" \
other="value3"

4. 复制命令ADD

如果把虚拟机与容器想象成两台linux服务器的话，那么这个命令就类似于scp，只是scp需要加用户名和密码的权限验证，而ADD不用。

ADD ["<src>",... "<dest>"]

• 路径的填写可以是容器内的绝对路径，也可以是相对于工作目录的相对路径，推荐写成绝对路径
• 可以是一个本地文件或者是一个本地压缩文件，还可以是一个url
• 如果把写成一个url，那么ADD就类似于wget命令
  示例

ADD test relativeDir/ 
ADD test /relativeDir
ADD http://example.com/foobar /

src为一个目录的时候，会自动把目录下的文件复制过去，目录本身不会复制
如果src为多个文件，dest一定要是一个目录

5. 复制命令COPY

与ADD的区别：COPY的只能是本地文件，其他用法一致

COPY ["<src>",... "<dest>"]

6. 暴漏容器运行时的监听端口给外部EXPOSE

但是EXPOSE并不会使容器访问主机的端口
如果想使得容器与主机的端口有映射关系，必须在容器启动的时候加上 -P参数

EXPOSE <port>/<tcp/udp>

7. 设置环境变量ENV

 ENV <key> <value>
 ENV <key>=<value> ...

在Dockerfile中使用变量的方式

变量	含义
$varname	使用变量
${varname}	使用变量
${varname:-default value}	当变量不存在使用-号后面的值
$(varname:+default value}	当变量存在时使用+号后面的值（当然不存在也是使用后面的值）

8. 运行指定的命令RUN

RUN <command>
RUN ["executable", "param1", "param2"]

• 第一种后边直接跟shell命令，在linux操作系统上默认 /bin/sh -c
• 第二种是类似于函数调用，可将executable理解成为可执行文件，后面就是两个参数。

9. 容器启动时默认命令或参数CMD

CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1 param2

不要把RUN和CMD搞混了。
RUN是构件容器时就运行的命令以及提交运行结果
CMD是容器启动时执行的命令，在构件时并不运行，构件时紧紧指定了这个命令到底是个什么样子

10. 启动时运行得启动命令ENTRYPOINT

 ENTRYPOINT ["executable", "param1", "param2"]  
 ENTRYPOINT command param1 param2

与CMD比较说明（这俩命令太像了，而且还可以配合使用）：

相同点：

• 只能写一条，如果写了多条，那么只有最后一条生效
• 容器启动时才运行，运行时机相同

不同点：

• ENTRYPOINT不会被运行的command覆盖，而CMD则会被覆盖

• 如果我们在Dockerfile种同时写了ENTRYPOINT和CMD，并且CMD指令不是一个完整的可执行命令，那么CMD指定的内容将会作为ENTRYPOINT的参数

11. 目录挂载VOLUME

VOLUME ["/data"]

12. 启动容器的用户USER

如果设置了容器以daemon用户去运行，那么RUN, CMD 和 ENTRYPOINT 都会以这个用户去运行,
使用这个命令一定要确认容器中拥有这个用户，并且拥有足够权限

USER daemon

13. 设置工作目录WORKDIR

WORKDIR /path

设置工作目录，对RUN,CMD,ENTRYPOINT,COPY,ADD生效。如果不存在则会创建，也可以设置多次。

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

pwd执行的结果是/a/b/c

WORKDIR也可以解析环境变量

ENV DIRPATH /path
WORKDIR $DIRPATH/$DIRNAME
RUN pwd

pwd的执行结果是/path/$DIRNAME