Dockerfile详解

环境

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

 

指令

FROM

功能为指定基础镜像，并且必须是第一条指令。

如果不以任何镜像为基础，那么写法为：FROM scratch。

同时意味着接下来所写的指令将作为镜像的第一层开始
语法：

1 2 3 4

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

MAINTAINER

指定作者。新版本中使用 LABEL 指明

1	MAINTAINER <name>

LABEL

功能是为镜像指定标签

语法：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

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"

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

 

ADD

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

语法：

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

• 路径的填写可以是容器内的绝对路径，也可以是相对于工作目录的相对路径，推荐写成绝对路径

• 可以是一个本地文件或者是一个本地压缩文件，还可以是一个url

如果把写成一个url，那么ADD就类似于wget命令
示例：

1 2 3

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

注意事项

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

 

COPY

复制本地文件

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

 

EXPOSE

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

但是EXPOSE并不会使容器访问主机的端口

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

EXPOSE <port>/<tcp/udp>

 

ENV

设置环境变量

1 2	ENV <key> <value> ENV <key>=<value> ...

 

RUN

运行指定的命令

1 2	1. RUN <command> 2. RUN ["executable", "param1", "param2"]

第一种后边直接跟shell命令

• 在linux操作系统上默认 /bin/sh -c
• 在windows操作系统上默认 cmd /S /C

第二种是类似于函数调用。

• 可将executable理解成为可执行文件，后面就是两个参数

 

CMD

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

1 2 3

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

 

RUN&&CMD

1 2 3 4 5

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

 

ENTRYPOINT

容器启动时运行得启动命令

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

 

VOLUME

将宿主机目录挂载到容器中

1	VOLUME ["/data"]

例子：

1 2 3

VOLUME ["/var/log/"] VOLUME /var/log VOLUME /var/log /var/db

 

USER

设置启动容器的用户，可以是用户名或UID

例子：

1 2	USER daemo USER UID

 

WORKDIR

设置工作目录，不存在则创建

1	WORKDIR /path/to/workdir

 

ARG

设置变量命令

1	ARG <name>[=<default value>]

例子：

1 2 3

FROM busybox ARG user1=someuser ARG buildno=1

 

ONBUILD

这个命令只对当前镜像的子镜像生效。

例子: 

1	ONBUILD RUN ls -al

不会对本镜像执行，会在基于本镜像构建的镜像进行执行。

STOPSIGNAL

容器健康状况检查命令

1 2	HEALTHCHECK [OPTIONS] CMD command HEALTHCHECK NONE

 

例子：

1 2	HEALTHCHECK --interval=5m --timeout=3s \ CMD curl -f http://localhost/ || exit 1

健康检查命令是：curl -f http://localhost/ || exit 1

两次检查的间隔时间是5秒

命令超时时间为3秒