Dockfile基本语法

时间:2023-12-12 11:40:08

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>"]

路径的填写可以是容器内的绝对路径,也可以是相对于工作目录的相对路径
可以是一个本地文件或者是一个本地压缩文件,还可以是一个url
如果把写成一个url,那么ADD就类似于wget命令
写法:

ADD ares t1/
ADD ares /t1
ADD http://example.com/ares /

若src是个目录,则会把目录下所有文件复制到容器,不会复制目录

COPY

复制命令

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

COPY的只能是本地文件,其他用法与ADD一致

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秒