Docker 能够通过读取 Dockerfile 中的指令主动构建镜像。Dockerfile 是一个文本文档,其中蕴含了用户创立镜像的所有命令和阐明。
一、变量
变量用 $variable_name
或者 ${variable_name}
示意。
- ${variable:-word} 示意如果 variable 设置,则后果将是该值。如果 variable 未设置,word 则将是后果。
- ${variable:+word} 示意如果 variable 设置则为 word 后果,否则为空字符串。
变量前加 \
能够本义成一般字符串:\$foo or \${foo}
,示意转换为 $foo
和 ${foo}
文字。
二、FROM
初始化一个新的构建阶段,并设置根底镜像:
FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]
单个 Dockfile 能够屡次呈现 FROM,以应用之前的构建阶段作为另一个构建阶段的依赖项
AS name 示意为构建阶段命名,在后续 FROM 和 COPY --from=<name>
阐明中能够应用这个名词,援用此阶段构建的映像
digest 其实就是就是依据镜像内容产生的一个 ID,只有镜像的内容不变 digest 也不会变
tag 或 digest 值是可选的。如果您省略其中任何一个,构建器默认应用一个 latest 标签。如果找不到该 tag 值,构建器将返回谬误。
–platform 标记可用于在 FROM 援用多平台镜像的状况下指定平台。例如,linux/amd64、linux/arm64、或 windows/amd64。
三、RUN
将在以后镜像之上的新层中执行命令,在 docker build 时运行。
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'
RUN 有两种模式:
RUN<command>(shell 模式,命令在 shell 中运行,默认 /bin/sh -c 在 Linux 或 cmd /S /CWindows 上)RUN ["executable", "param1", "param2"](执行模式)
阐明:
能够应用 \(反斜杠)将单个 RUN 指令连续到下一行
RUN 在下一次构建期间,指令缓存不会主动生效。能够应用 --no-cache 标记使指令缓存有效
Dockerfile 的指令每执行一次都会在 Docker 上新建一层。所以过多无意义的层,会造成镜像收缩过大,能够应用 && 符号连贯命令,这样执行后,只会创立 1 层镜像
四、CMD
运行程序,在 docker run 时运行,然而和 run 命令不同,RUN 是在 docker build 时运行。
FROM ubuntu
CMD ["/usr/bin/wc","--help"]
反对三种格局:
CMD ["executable","param1","param2"] 应用 exec 执行,举荐形式;CMD command param1 param2 在 /bin/sh 中执行,提供给须要交互的利用;CMD ["param1","param2"] 提供给 ENTRYPOINT 的默认参数。
指定启动容器时执行的命令,每个 Dockerfile 只能有一条 CMD 命令。如果指定了多条命令,只有最初一条会被执行。
如果用户启动容器时候指定了运行的命令,则会笼罩掉 CMD 指定的命令。
五、LABEL
增加元数据:
LABEL multi.label1="value1" \
multi.label2="value2" \
other="value3"
六、EXPOSE
EXPOSE <port> [<port>/<protocol>...]
Docker 容器在运行时侦听指定的网络端口。能够指定端口是监听 TCP 还是 UDP,如果不指定协定,默认为 TCP。
该 EXPOSE 指令实际上并未公布端口。要在运行容器时理论公布端口,docker run -P
来公布和映射一个或多个端口。
默认状况下,EXPOSE 假设 TCP。您还能够指定 UDP:
EXPOSE 80/udp
七、ENV
设置环境变量:
ENV <key>=<value> ...
设置的环境变量将继续存在,您能够应用 docker inspect 来查看。应用 docker run --env <key>=<value>
来更改环境变量的值。
如果环境变量只在构建期间须要,请思考为单个命令设置一个值:
RUN DEBIAN_FRONTEND=noninteractive apt-get update && apt-get install -y ...
或者应用 ARG,它不会保留在最终镜像中:
ARG DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y ...
八、ADD
复制新文件、目录或近程文件 URL <src>
, 并将它们增加到 <dest>
中。
<src>
能够指定多个资源,但如果它们是文件或目录,则它们的门路被解释为绝对于构建上下文的源,也就是 WORKDIR。
每个都 <src>
可能蕴含通配符,匹配将应用 Go 的 filepath.Match 规定。例如:
增加所有以“hom”结尾的文件:
ADD hom* /mydir/
在上面的示例中,? 被替换为任何单个字符,例如“home.txt”。
ADD hom?.txt /mydir/
<dest>
是一个绝对路径,或绝对 WORKDIR 的相对路径。
九、COPY
语法同 ADD 统一,复制拷贝文件。
COPY 指令和 ADD 指令的惟一区别在于:是否反对从近程 URL 获取资源。COPY 指令只能从执行 docker build 所在的主机上读取资源并复制到镜像中。而 ADD 指令还反对通过 URL 从近程服务器读取资源并复制到镜像中。
雷同需要时,举荐应用 COPY 指令。ADD 指令更善于读取本地 tar 文件并解压缩。
十、ENTRYPOINT
ENTRYPOINT 和 CMD 一样,都是在指定容器启动程序及参数,不过它不会被 docker run 的命令行参数指定的指令所笼罩。如果要笼罩的话,须要通过 docker run –entrypoint 来指定。
它有 2 种格局:
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
指定了 ENTRYPOINT 后,CMD 的内容作为参数传给 ENTRYPOINT 指令,理论执行时,将变为:
<ENTRYPOINT> <CMD>
十一、VOLUME
创立一个具备指定名称的挂载数据卷。
VOLUME ["/var/log/"]
VOLUME /var/log
它的次要作用是:
- 防止重要的数据,因容器重启而失落
- 防止容器一直变大
十二、ARG
定义变量,与 ENV 作用雷同,不过 ARG 变量不会像 ENV 变量那样长久化到构建好的镜像中。
ARG <name>[=<default value>]
Docker 有一组预约义的 ARG 变量,您能够在 Dockerfile 中没有相应指令的状况下应用这些变量。
HTTP_PROXY
http_proxy
HTTPS_PROXY
https_proxy
FTP_PROXY
ftp_proxy
NO_PROXY
no_proxy
要应用这些,请应用 –build-arg 标记在命令行上传递它们,例如:
docker build --build-arg HTTPS_PROXY=https://my-proxy.example.com .
十三、ONBUILD
将一个触发指令增加到镜像中,以便稍后在该镜像用作另一个构建的根底时执行。也就是另外一个 dockerfile FROM 了这个镜像的时候执行。
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
十四、STOPSIGNAL
设置将发送到容器退出的零碎调用信号。该信号能够是与内核零碎调用表中的地位匹配的无效无符号数,例如 9,或格局为 SIGNAME 的信号名称,例如 SIGKILL。
STOPSIGNAL signal
默认的 stop-signal 是 SIGTERM,在 docker stop 的时候会给容器内 PID 为 1 的过程发送这个 signal,通过 –stop-signal 能够设置本人须要的 signal,次要目标是为了让容器内的应用程序在接管到 signal 之后能够先解决一些事物,实现容器的平滑退出,如果不做任何解决,容器将在一段时间之后强制退出,会造成业务的强制中断,默认工夫是 10s。
十五、HEALTHCHECK
用于指定某个程序或者指令来监控 Docker 容器服务的运行状态。该 HEALTHCHECK 指令有两种模式:
HEALTHCHECK [OPTIONS] CMD command(通过在容器内运行命令来查看容器健康状况)或者
HEALTHCHECK NONE(禁用从根底镜像继承的任何健康检查)
十六、SHELL
笼罩用于命令的 shell 模式的默认 shell。Linux 上的默认 shell 是 ["/bin/sh", "-c"]
,Windows 上是 ["cmd", "/S", "/C"]
。
SHELL ["executable", "parameters"]
该 SHELL 指令在 Windows 上特地有用,因为 Windows 有两种罕用且截然不同的本机 SHELL:cmd 和 powershell,以及可用的备用 shell,包含 sh。该 SHELL 指令能够呈现屡次。每条 SHELL 指令都会笼罩所有先前的 SHELL 指令,并影响所有后续指令。
十七、WORKDIR
工作目录,如果 WORKDIR 不存在,即便它没有在后续 Dockerfile 指令中应用,它也会被创立。
docker build 构建镜像过程中,每一个 RUN 命令都会新建一层。只有通过 WORKDIR 创立的目录才会始终存在。
能够设置多个 WORKDIR,如果提供了相对路径,它将绝对于前一条 WORKDIR 指令的门路。例如:
WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
最终 pwd 命令的输入是 /a/b/c。
该 WORKDIR 指令能够解析先前应用 ENV,例如:
ENV DIRPATH=/path
WORKDIR $DIRPATH/$DIRNAME
RUN pwd
最终 pwd 命令的输入是 /path/$DIRNAME。
十八、USER
设置用户名(或 UID)和可选的用户组(或 GID)。
USER <user>[:<group>]
USER <UID>[:<GID>]
链接:https://zhuanlan.zhihu.com/p/…