Dockerfile参数及优化

制作Dockerfile为Docker入门学习的第一步,dockerfile有以下参数

参数

FROM

功能为指定基础镜像，并且必须是第一条指令。如果不以任何镜像为基础，那么写法为：FROM scratch。同时意味着接下来所写的指令将作为镜像的第一层开始 。 三种写法，其中<tag>和<digest> 是可选项，如果没有选择，那么默认值为latest

语法：

FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>

MAINTAINER

作者

RUN

运行指定的命令

语法：

1. RUN <command>      #后面直接跟shell命令
2. RUN ["executable", "param1", "param2"]     # 可将executable理解成为可执行文件，后面就是两个参数

举例：

1.RUN /bin/bash -c 'source $HOME/.bashrc; echo $HOME

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

注意：多行命令不要写多个RUN，原因是Dockerfile中每一个指令都会建立一层.多少个RUN就构建了多少层镜像，会造成镜像的臃肿、多层，不仅仅增加了构件部署的时间，还容易出错。 

CMD

容器启动时要运行的命令

语法：

1. CMD ["executable","param1","param2"]
2. CMD ["param1","param2"]
3. CMD command param1 param2

第三种比较好理解了，就时shell这种执行方式和写法。第一种和第二种其实都是可执行文件加上参数的形式

举例：

1.CMD [ "sh", "-c", "echo $HOME"

2.CMD [ "echo", "$HOME" ]

LABEL

功能是为镜像指定标签，这个没用过，回头再看吧

EXPOSE

记录服务可用的端口，但是并不创建和宿主机之间的映射

举个例子：

写一个dockerfile：

FROM 192.168.1.1:5000/centos

MAINTAINER liyang

RUN XXXX

EXPOSE 8080
EXPOSE 22
EXPOSE 8009
EXPOSE 8005
EXPOSE 8443

在Dockerfile中定义了 tomcat 的四个端口和ssh 22 端口，并且构建该配置档为镜像文件，镜像名为 port_list

#docker build -t port_list .

构建成功后运行该 images，注意在容器运行的时候一定要加-P ，大写的P

#docker run -d -it -P --name port_list_container port_list

Container已经running，分别映射端口为（22，8005，8009，8443，8080）映射到本机中的(32775，32776，32777，32773，32774)

  ENV

设置环境变量

语法：

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

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

ADD

一个复制命令，把文件复制到镜像中

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

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

<src>可以是一个本地文件或者是一个本地压缩文件，还可以是一个url ， 如果把<src>写成一个url，那么ADD就类似于wget命令

COPY

复制指令

语法：

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

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

ENTRYPOINT

容器启动时的默认命令

语法：

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

与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不会执行。 

CMD指定的命令可以被docker run传递的命令覆盖，例如，如果用CMD指定：
...
CMD ["echo"]
然后运行
docker run CONTAINER_NAME echo foo
那么CMD里指定的echo会被新指定的echo覆盖，所以最终相当于运行echo foo，所以最终打印出的结果就是：
foo

而ENTRYPOINT会把容器名后面的所有内容都当成参数传递给其指定的命令（不会对命令覆盖），比如：
...
ENTRYPOINT ["echo"]
然后运行
docker run CONTAINER_NAME echo foo
则CONTAINER_NAME后面的echo foo都作为参数传递给ENTRYPOING里指定的echo命令了，所以相当于执行了
echo "echo foo"
最终打印出的结果就是：
echo foo

另外，在Dockerfile中，ENTRYPOINT指定的参数比运行docker run时指定的参数更靠前，比如：
...
ENTRYPOINT ["echo", "foo"]
执行
docker run CONTAINER_NAME bar
相当于执行了：
echo foo bar

VOLUME

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

语法：

VOLUME /var/log /var/db

USER

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

语法：

USER daemo
USER UID

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

WORKDIR

设置工作目录

语法：

WORKDIR /path/to/workdir

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

ARG

没用过

ONBUILD

语法：

ONBUILD [INSTRUCTION]

这个命令只对当前镜像的子镜像生效。比如当前镜像为A，在Dockerfile种添加：

ONBUILD RUN ls -al

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

STOPSIGNAL

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

语法：

STOPSIGNAL signal 

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秒 

 优化

1.ADD和VOLUME尽量放在dockerfile底部

2.多个RUN的时候可以通过&& 和 集合成一条指令，减少容器层数

3.能用COPY的地方就不要用RUN cp

4.dockerfile当前目录最好不要放无关文件