Dockerfile 文件全面详解 - DockOne.io
source link: http://dockone.io/article/2434527
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Dockerfile 文件全面详解
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 /C
Windows 上)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
的默认参数。
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/387855002
Recommend
-
128
部署微服务:Spring Cloud 和 Kubernetes 的比较 - 【编者的话】本文比较了当下最火热的两大微服务开发平台:Spring Cloud和Kubernetes的优缺点,并指出结合二者的优点来组合使用,将在微服务旅程上获得更大成功。当我们需要部署微服务的时候,哪个更好?Spring Cl...
-
25
博文大纲:dockerfile基本结构dockerfile常用指令FROMMAINTAINERRUNCOPYADDENVEXPOSECMDENTRYPOINTENTRYPOINT和CMD组合使用VOLUMEUSERWORKDIRONBUILD1、Dockerfile基本结构Dockerfile由一行行命令语句组成,并且支持以#开头的注释行。一般Dockerfile分为四部分:基...
-
19
Dockerfile简介Dockerfile是Docker中用于定义镜像自动化构建流程的配置文件。在Dockerfile中,包含了构建镜像过程中需要执行的命令和其他操作。通过Dockerfile可以更加清晰,明确的给定Docker镜像的制作过程,由于仅是简单,小体积的文件,在网络等介质中传递的速...
-
39
Dockerfile介绍及常用指令,包括FROM,RUN,还提及了 COPY,ADD,EXPOSE,WORKDIR等,其实 Dockerfile 功能很强大,它提供了十多个指令。 Dockerfile介绍 Dockerfile 是一个用来构建镜像的文本文件,文本内容包含了一...
-
3
Kubernetes 探针详解! ...
-
63
技术之前,先读诗书:可怜楼上月徘徊,应照离人妆镜台。 Dockerfile复制上级目录文件 ...
-
9
监控的重要性,相信大家都是非常有体会的,监控能力对于所有的软件系统来说也是必不可少的。有的监控能力是产品内置的,有的是基于 SaaS 提供的。监控是系统上线之后,保证系统稳定性的重要手段,运维的主要的工作入口就是监控和告警。随着云原生的广泛使用...
-
2
Dockerfile 命令详解及最佳实践 Dockerfile 命令详解 FROM 指定基础镜像(必选) 所谓定制镜像,那一定是以一个镜...
-
8
V2EX › 问与答 docker 打前端镜像时,执行 dockerfile 文件,前端 npm run build 失败时怎么进容器看 npm 日志
-
6
本文基于应用容器引擎-Docker继续讲解DockerFile的有关知识。在学习完Dockerfile的知识后,你可以自己独立部署一个前后端分离的项目,具体部署操作可以浏览我之前的...
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK