Dockfile基本语法
FROM
功能为指定基础镜像,并且必须是第一条指令。 如果不以任何镜像为基础,那么可写为:FROM scratch。
接下来所写的指令将作为镜像的第一层开始。
格式:
FROM <image>
FROM <image>:<tag>
FROM <image>:<digest>
默认值为latest
MAINTAINER
指定作者
格式:
MAINTAINER <name>
ENV
为容器设定环境变量
ENV <key> <value> 设置一个
ENV <key>=<value> 设置多个
ADD
复制,把文件复制到镜像中(Dockfile所在目录为根目录),类似于scp
ADD <src>... <dest>
ADD ["<src>",... "<dest>"]
如果把
写法:
ADD ares t1/
ADD ares /t1
ADD http://example.com/ares /
若src是个目录,则会把目录下所有文件复制到容器,不会复制目录
COPY
复制命令
COPY <src>... <dest>
COPY ["<src>",... "<dest>"]
COPY的
VOLUME
挂载功能,将本地目录或者其他容器内得目录挂在到这个容器中,一般挂载数据文件
VOLUME ["/var/log/"]
VOLUME /var/log
VOLUME /var/log /data
任何向 /data 中写入的信息都不会记录进容器存储层,从而保证了容器存储层的无状态化,容器运行时可通过-v覆盖配置
USER
设置启动容器的用户,可以是用户名或UID
USER daemo
USER UID
如果设置了容器以daemon用户去运行,那么RUN, CMD 和 ENTRYPOINT 都会以这个用户去运行
WORKDIR
WORKDIR 指令可以来指定工作目录(或者称为当前目录),以后各层的当前目录就被改为指定的目录,如该目录不存在, WORKDIR 会自动建立目录。
WORKDIR <工作目录路径>
EXPOSE
声明端口,暴漏容器运行时的监听端口给外部
EXPOSE <端口1> [<端口2>...]
运行时并不会因为这个声明应用就会开启这个端口的服务.在 Dockerfile 中写入这样的声明有两个好处,一个是帮助镜像使用者理解这个镜像服务的守护端口,以方便配置映射;另一个用处则是在运行时使用随机端口映射时,也就是 docker run -P 时,会自动随机映射 EXPOSE 的端口。
RUN
运行指定的命令
RUN <command>
RUN ["executable", "param1", "param2"]
第一种后边直接跟shell命令
在linux操作系统上默认 /bin/sh -c
在windows操作系统上默认 cmd /S /C
第二种是类似于函数调用。
RUN书写时的换行符是\,多行命令不要写多个RUN,使用&&连接
CMD
容器启动时要运行的命令
CMD ["executable","param1","param2"]
CMD ["param1","param2"]
CMD command param1 param2
只可以使用双引号!
CMD echo $HOME实际会被翻译成CMD [ "sh", "-c", "echo $HOME" ]
Docker 不是虚拟机,容器中的应用都应该以前台执行!
CMD service nginx start命令应该写为CMD ["nginx", "-g", "daemon off;"]
RUN是构件容器时就运行的命令以及提交运行结果;
CMD是容器启动时执行的命令,在构件时并不运行,构件时紧紧指定了这个命令到底是个什么样子;
可写多个,只有最后一个生效
ENTRYPOINT
功能是启动时的默认命令,不可被 docker run 提供的参数覆盖
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
如果我们在Dockerfile种同时写了ENTRYPOINT和CMD,并且CMD指令不是一个完整的可执行命令,那么CMD指定的内容将会作为ENTRYPOINT的参数
示例:
CMD ["-f","/var/log/message"]
ENTRYPOINT ["tail"]
会在启动的时候执行tail -f /var/log/message
ARG
构建参数
ARG <参数名>[=<默认值>]
ARG命令定义了一个变量,在docker build创建镜像的时候,使用 –build-arg =来指定参数
ONBUILD
ONBUILD <其它指令>
ONBUILD 是一个特殊的指令,它后面跟的是其它指令,比如 RUN , COPY 等,而这些指令,在当前镜像构建时并不会被执行。只有当以当前镜像为基础镜像,去构建下一级镜像的时候才会被执行。
STOPSIGNAL
当容器推出时给系统发送什么样的指令
STOPSIGNAL signal
HEALTHCHECK
容器健康状况检查命令,告诉 Docker 应该如何进行判断容器的状态是否正常
HEALTHCHECK [OPTIONS] CMD command :设置检查容器健康状况的命令
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秒