Dockfile 的语法

Dockerfile是由一系列命令和参数构成的脚本，这些命令应用于基础镜像并最终创建一个新的镜像。它们简化了从头到尾的流程并极大的简化了部署工作。Dockerfile从FROM命令开始，紧接着跟随者各种方法，命令和参数。其产出为一个新的可以用于创建容器的镜像。

Dockerfile 语法

在我们深入讨论Dockerfile之前，让我们快速过一下Dockerfile的语法和它们的意义。

什么是语法？

非常简单，在编程中，语法意味着一个调用命令，输入参数去让应用执行程序的文法结构。这些语法被规则或明或暗的约束。程序员遵循语法规范以和计算机交互。如果一段程序语法不正确，计算机将无法识别。Dockerfile使用简单的，清楚的和干净的语法结构，极为易于使用。这些语法可以自我释义，支持注释。

Dockerfile 语法示例：

Dockerfile语法由两部分构成，注释和命令+参数：

# Line blocks used for commenting

command argument argument ..

一个简单的例子：

# Print "Hello docker!"

RUN echo "Hello docker!"

Dockerfile命令

Dockerfile有十几条命令可用于构建镜像，下文将简略介绍这些命令：

1.FROM ，该命令指定基于哪个基础镜像，因为你要指定一个基础镜像才能基于这个镜像之上进行其他操作，因为你不可能凭空创建出一个镜像吧，如果基础镜像没有被发现，Docker将试图从Docker image index来查找该镜像，而且DockerFile第一条必须为From指令。如果同一个DockerFile创建多个镜像时，可使用多个From指令（每个镜像一次）：

语法：

FROM <image>

FROM <image>:<tag>

FROM <image>:<digest>

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

例如：

FROM centos

FROM centos:latest

2.MAINTAINER ，指定作者信息：

格式：

MAINTAINER <name>

例如：

MAINTAINER test test @example.com

3.RUN ，镜像操作指令：

格式：

1. RUN <command>

2. RUN ["executable", "param1", "param2"]

第一种后边直接跟shell命令

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

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

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

两种写法比对：

RUN /bin/bash -c 'source $HOME/.bashrc; echo $HOME
RUN ["/bin/bash", "-c", "echo hello"]

注意：多行命令不要写多个RUN，原因是Dockerfile中每一个指令都会建立一层.

多少个RUN就构建了多少层镜像，会造成镜像的臃肿、多层，不仅仅增加了构件部署的时间，还容易出错。

RUN书写时的换行符是\

例如：

RUN yum install httpd

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

4.CMD ，

功能为容器启动时要运行的命令

语法有三种写法

1. CMD ["executable","param1","param2"]

2. CMD ["param1","param2"]

3. CMD command param1 param2

第三种比较好理解了，就时shell这种执行方式和写法

第一种和第二种其实都是可执行文件加上参数的形式

举例说明两种写法：

CMD [ "sh", "-c", "echo $HOME"
CMD [ "echo", "$HOME" ]

补充细节：这里边包括参数的一定要用双引号，就是",不能是单引号。千万不能写成单引号。

原因是参数传递后，docker解析的是一个JSON array

有三种格式：

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

CMD command param1 param2

CMD [ "param1" , "param2" ]

RUN和CMD看起来挺像，但是CMD只能用来指定容器启动时用到的命令，所以只能有一条。例如：

CMD [ "/bin/bash" , "/usr/local/nginx/sbin/nginx" , "-c" , "/usr/local/nginx/conf/nginx.conf" ]

RUN & CMD

不要把RUN和CMD搞混了。

RUN是构件容器时就运行的命令以及提交运行结果

CMD是容器启动时执行的命令，在构建时仅仅指定了这个命令到底是个什么样子

5.EXPOSE ，这个是用来暴露端口的

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

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

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

格式：

EXPOSE <port> [<port>...]

例如，我要将22、80、8443端口暴露出来：

EXPOSE 22 80 8443

这个用来指定要映射出去的端口，比如容器内部我们启动了sshd和nginx，所以我们需要把22和80端口暴漏出去。这个需要配合-P（大写）来工作，也就是说在启动容器时，需要加上-P，让它自动分配。如果想指定具体的端口，也可以使用-p（小写）来指定。

6.ENV ，是用于定义环境变量的：

语法有两种

1. ENV <key> <value>

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

两者的区别就是第一种是一次设置一个，第二种是一次设置多个

格式：

ENV <key> <value>

例如：

ENV PATH /usr/ local /mysql/bin: $PATH

它主要是为后续的RUN指令提供一个环境变量，我们也可以定义一些自定义的变量：

ENV MYSQL_version 5.6

7.ADD ，可以将本地的一个文件或目录拷贝到容器的某个目录里。其中src为Dockerfile所在目录的相对路径，它也可以是一个url：

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

语法如下：

1. ADD <src>... <dest>

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

<dest>路径的填写可以是容器内的绝对路径，也可以是相对于工作目录的相对路径

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

如果把<src>写成一个url，那么ADD就类似于wget命令

如以下写法都是可以的：

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

尽量不要把<src>写成一个文件夹，如果<src>是一个文件夹了，复制整个目录的内容,包括文件系统元数据

格式：

add <src> <dest>

例如：

ADD <conf/vhosts> </usr/ local /nginx/conf>

8.COPY ，

语法如下：

1. COPY <src>... <dest>

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

与ADD的区别

COPY的<src>只能是本地文件，其他用法一致

格式同ADD，语法格式和ADD一样，不同的是，它不支持url。

9.ENTRYPOINT ，格式类似CMD：

容器启动时要执行的命令，它和CMD很像，也是只有一条生效，如果写多个只有最后一条有效。和CMD不同是：

CMD 是可以被 docker run 指令覆盖的，而ENTRYPOINT不能覆盖。

功能是启动时的默认命令

语法如下：

1. ENTRYPOINT ["executable", "param1", "param2"]

2. ENTRYPOINT command param1 param2

如果从上到下看到这里的话，那么你应该对这两种语法很熟悉啦。

第二种就是写shell

第一种就是可执行文件加参数

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

1. 相同点：

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

2. 不同点：

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

如下：

FROM ubuntu

ENTRYPOINT ["top", "-b"]

CMD ["-c"]

如果我们在Dockerfile种同时写了ENTRYPOINT和CMD，并且CMD是一个完整的指令，那么它们两个会互相覆盖，谁在最后谁生效

如下：

FROM ubuntu

ENTRYPOINT ["top", "-b"]

CMD ls -al

那么将执行ls -al ,top -b不会执行。

比如，容器名字为test，我们在Dockerfile中指定如下CMD：

CMD [ "/bin/echo" , "testOne" ]

启动容器的命令是 docker run test 这样会输出 testOne

假如启动容器的命令是 docker run -it test /bin/bash 则什么都不会输出，因为 /bin/bash 把 /bin/echo testOne 给覆盖了。

而 ENTRYPOINT 则不会被覆盖，并且会比CMD或者docker run指定的命令要靠前执行：

ENTRYPOINT [ "echo" , "testOne" ]

docker run -it test 123

则会输出 testOne 123 ，这相当于要执行命令 echo testOne 123

Docker官方使用一张表格来展示了ENTRYPOINT 和CMD不同组合的执行情况

（下方表格来自docker官网）

	NO ENTRYPOINT	ENTRYPOINT exec_entry p1_entry	ENTRYPOINT ["exec_entry", "p1_entry"]
No CMD	error, not allowed	/bin/sh -c exec_entry p1_entry	exec_entry p1_entry
CMD ["exec_cmd", "p1_cmd"]	exec_cmd p1_cmd	/bin/sh -c exec_entry p1_entry	exec_entry p1_entry exec_cmd p1_cmd
CMD ["p1_cmd", "p2_cmd"]	p1_cmd p2_cmd	/bin/sh -c exec_entry p1_entry	exec_entry p1_entry p1_cmd p2_cmd
CMD exec_cmd p1_cmd	/bin/sh -c exec_cmd p1_cmd	/bin/sh -c exec_entry p1_entry	exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd

10.VOLUME ，这个是用来指定挂载点的

可实现挂载功能，可以将内地文件夹或者其他容器种得文件夹挂在到这个容器中

语法为：

VOLUME ["/data"]

说明：

["/data"]可以是一个JsonArray ，也可以是多个值。所以如下几种写法都是正确的

VOLUME ["/var/log/"]

VOLUME /var/log

VOLUME /var/log /var/db

一般的使用场景为需要持久化存储数据时

容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失。

所以当数据需要持久化时用这个命令。

格式：

VOLUME [ "/data" ]

VOLUME命令将创建一个可以从本地主机或其他容器挂载的挂载点，与我们之前使用的-v选项是一样的。

11.USER ，指定运行容器的用户：

设置启动容器的用户，可以是用户名或UID，所以，只有下面的两种写法是正确的

USER daemo
USER UID

注意：如果设置了容器以daemon用户去运行，那么RUN, CMD 和 ENTRYPOINT 都会以这个用户去运行

格式：

USER daemon

12.WORKDIR ，指定命令的工作目录：

语法：

WORKDIR /path/to/workdir

设置工作目录，对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

格式：

WORKDIR /path/to/workdir

为后续的RUN、CMD或者ENTRYPOINT执行的命令指定一个工作目录。

ARG

语法：

ARG <name>[=<default value>]

设置变量命令，ARG命令定义了一个变量，在docker build创建镜像的时候，使用 --build-arg <varname>=<value>来指定参数

如果用户在build镜像时指定了一个参数没有定义在Dockerfile中，那么将有一个Warning

提示如下：

[Warning] One or more build-args [foo] were not consumed.

我们可以定义一个或多个参数，如下：

FROM busybox

ARG user1

ARG buildno

...

也可以给参数一个默认值：

FROM busybox

ARG user1=someuser

ARG buildno=1

...

如果我们给了ARG定义的参数默认值，那么当build镜像时没有指定参数值，将会使用这个默认值

ONBUILD

语法：

ONBUILD [INSTRUCTION]

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

比如当前镜像为A，在Dockerfile种添加：

ONBUILD RUN ls -al

这个 ls -al 命令不会在A镜像构建或启动的时候执行

此时有一个镜像B是基于A镜像构建的，那么这个ls -al 命令会在B镜像构建的时候被执行。

STOPSIGNAL

语法：

STOPSIGNAL signal

STOPSIGNAL命令是的作用是当容器推出时给系统发送什么样的指令

HEALTHCHECK

容器健康状况检查命令

语法有两种：

1. HEALTHCHECK [OPTIONS] CMD command

2. HEALTHCHECK NONE

第一个的功能是在容器内部运行一个命令来检查容器的健康状况

第二个的功能是在基础镜像中取消健康检查命令

[OPTIONS]的选项支持以下三中选项：

--interval=DURATION 两次检查默认的时间间隔为30秒

--timeout=DURATION 健康检查命令运行超时时长，默认30秒

--retries=N 当连续失败指定次数后，则容器被认为是不健康的，状态为unhealthy，默认次数是3

注意：

HEALTHCHECK命令只能出现一次，如果出现了多次，只有最后一个生效。

CMD后边的命令的返回值决定了本次健康检查是否成功，具体的返回值如下：

0: success - 表示容器是健康的

1: unhealthy - 表示容器已经不能工作了

2: reserved - 保留值

例子：

HEALTHCHECK --interval=5m --timeout=3s \

CMD curl -f http://localhost/ || exit 1

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

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

命令超时时间为3秒

Dockerfile创建镜像 –Dockerfile示例

以上简单介绍了一下Dockerfile的一些命令以及格式，下面我们来实践一下Dockerfile，通过Dockerfile来创建一个nginx的镜像。

首先我这里之前拉取了一个centos7的基础镜像，我就基于这个镜像上来创建一个nginx环境的镜像。

[root@server ~] # docker images

REPOSITORY TAG IMAGE ID CREATED SIZE

centos latest ff426288ea90 4 weeks ago 207 MB

[root@server ~] #

1.创建Dockerfile，编辑内容如下：

## Set the base image to CentOS 基于centos镜像

FROM centos

# File Author / Maintainer 作者信息

MAINTAINER test test @example.com

# Install necessary tools 安装一些依赖的包

RUN yum install -y pcre-devel wget net-tools gcc zlib zlib-devel make openssl-devel

# Install Nginx 安装nginx

ADD http://nginx.org/download/nginx-1.8.0.tar.gz . # 添加nginx的压缩包到当前目录下

RUN tar zxvf nginx-1.8.0.tar.gz # 解包

RUN mkdir -p /usr/ local /nginx # 创建nginx目录

RUN cd nginx-1.8.0 && ./configure --prefix=/usr/ local /nginx && make && make install # 编译安装

RUN rm -fv /usr/ local /nginx/conf/nginx.conf # 删除自带的nginx配置文件

ADD http://www.apelearn.com/study_v2/.nginx_conf /usr/ local /nginx/conf/nginx.conf # 添加nginx配置文件 # Expose ports 开放80端口出来

EXPOSE 80

# Set the default command to execute when creating a new container 这里是因为防止服务启动后容器会停止的情况，所以需要多执行一句tail命令

ENTRYPOINT /usr/ local /nginx/sbin/nginx && tail -f /etc/passwd

如果你本地的宿主机上，已经有nginx配置文件了，则可以把ADD更改为使用COPY来进行拷贝：

COPY /usr/ local /nginx/conf/nginx.conf /usr/ local /nginx/conf/nginx.conf

编辑完Dockerfile之后就可以通过Dockerfile来创建镜像了：

2.创建镜像：

[root@server ~] # docker build -t centos_nginx .

命令说明：

build -t 指定通过Dockerfile来创建镜像
centos_nginx 则是新镜像的名称
. 表示在当前路径寻找Dockerfile

3.创建完成后，查看一下我们新建的镜像：

[root@server ~] # docker images

REPOSITORY TAG IMAGE ID CREATED SIZE

centos_nginx latest 167ba72ca0b2 3 minutes ago 374MB

centos latest ff426288ea90 4 weeks ago 207MB

[root@server ~] #

4.然后我们再把该容器的80端口映射到本地的81端口，这样在外部也可以访问该容器的nginx服务了：

[root@server ~] # docker run -itd -p 81:80 centos_nginx bash

ef4d1bb6b288baab4e7e0c81645894c752e85ba3a4be70900b0dd627eddf43ef

[root@server ~] # docker exec -it ef4d1b bash

[root@ef4d1bb6b288 /] # ps aux |grep nginx

root 1 0.1 0.0 11640 1336 pts/0 Ss+ 15:39 0:00 /bin/sh -c /usr/ local /nginx/sbin/nginx && tail -f /etc/passwd bash

root 8 0.0 0.0 24840 784 ? Ss 15:39 0:00 nginx: master process /usr/ local /nginx/sbin/nginx

nobody 9 0.0 0.1 27284 3356 ? S 15:39 0:00 nginx: worker process

nobody 10 0.0 0.1 27284 3360 ? S 15:39 0:00 nginx: worker process

root 27 0.0 0.0 9048 664 pts/1 S+ 15:39 0:00 grep --color=auto nginx

[root@ef4d1bb6b288 /] # netstat -lntp |grep nginx

tcp 0 0 0.0.0.0:80 0.0.0.0:* LISTEN 8/nginx: master pro

[root@ef4d1bb6b288 /] # exit

5.最后使用curl来测试一下是否能通过访问宿主机的81端口来访问到容器的nginx服务：

[root@server ~] # curl localhost:81

Dockerfile创建镜像 –Dockerfile示例

猜你喜欢