Dockerfile参数及优化

Posted Brown羊羊

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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当前目录最好不要放无关文件

 

以上是关于Dockerfile参数及优化的主要内容,如果未能解决你的问题,请参考以下文章

DockerFile优化

Docker基础之镜像详解与dockerfile及优化~

Docker基础之镜像详解与dockerfile及优化~

Docker基础之镜像详解与dockerfile及优化~

Docker基础之镜像详解与dockerfile及优化~

Docker:Dockerfile介绍及简单示例