Dockerfile 指令详解

本帖子的最后更新时间是距今三百零六天之前, 里面所记录的那些内容信息也许早就已经随风飘散并且消失不见了。

在前言部分, 我们需要指出近年来某个事物是非常火爆的, 如果想要把它玩好, 它是完全绕不开的, 这个道理同想要玩好Linux服务器必须绕开Shell的原理是一样的。今天我们主要就是来谈一谈怎样去编写, 并且那些具体指令到底包含着什么样的意思。首先, 我们先来看一个比较简单的情形。

bash 复制代码
#这个Dockerfile作用是打一个python3项目环境 FROM python:3-alpine WORKDIR /app ADD . /app RUN pip3 install -r requirements.txt -i https://pypi.douban.com/simple CMD ["python3", "main.py"]   #这个Dockerfile作用Dockerfile部署django项目 FROM centos:7 MAINTAINER haili ADD requeriments.txt /home WORKDIR /home RUN yum update && yum -y install mysql && yum -y install python3-pip && pip3 install -r requirements.txt ADD autoTest /home/ WORKDIR /home/autoTest EXPOSE 8000 ENTRYPOINT uwsgi --ini uwsgi.ini 

二、编写规则指令不区分大小写, 人们习惯用大写。

非注释行的第一行必须是FROM文件名必须指定一个专门的目录作为工作空间, 所有引入映射的文件都必须在这个工作空间目录下, 该目录支持隐藏文件, 这两个点的作用是存放不需要打包导入镜像的文件, 根目录就是工作空间目录, 每一条指令都会生成一个镜像层, 如果镜像层多了执行效率就会变慢,能写成一条的就写成一条, 以下是指令详细解释, 首先是基础镜像部分。

bash 复制代码
 1.1、FROM是Dockerfile文件开篇第一个非注释行代码

1.2、用于为镜像文件构建过程指定基础镜像,后续的指令都基于该基础镜像环境运行

1.3、基础镜像可以是任何一个镜像文件

1.4、docker build 会在docker宿主机上查找指定的文件,如未找到会自动去Docker Hub Registry上拉取

1.5、如果没找到对应的镜像就会返回错误信息

:镜像作者信息

bash 复制代码
2.1、废弃了,使用LABLE替代

标签, 即镜像的描述信息。

bash 复制代码
3.1、LABLE author="haili"

COPY:从宿主机复制文件至创建的新镜像文件

bash 复制代码
4.1、COPY  

4.2、COPY ["",.... ""]

4.3、:要复制的源文件或目录,支持使用通配符

1、必须是build上下文中的路径,不能是其父目录路径

2、如果是目录,则其内部文件和子目录都会被递归复制,但是目录本身不会被复制

3、如果指定了多个,或者中使用了通配符,则必须是一个目录,且必须以/结尾

4.4、:目标路径,即正在创建的images的文件系统路径

1、建议使用绝对路径,否则COPY指定以WORKDIR为其实路径

2、如果不存在,将会被自动创建,包括其父目录路径一起创建

4.5、复制文件

COPY testFile /mnt

4.6、复制目录

COPY testDir /mnt/testDir

1、testDir下所有文件和目录都会被递归复制

2、目标路径要写testDir,否则会复制到/mnt下

ADD这个指令, 它在功能和那个COPY指令是非常类似的, 不过, 它有一个特别之处是它能够处理tar格式的压缩文件, 同时它也支持URL路径这种形式的访问。

bash 复制代码
5.1、ADD  

5.2、ADD ["",.... ""]

5.3、如果为URL切不以/结尾,则指定的文件将被下载并直接被创建为,如果以/结尾,则文件名URL指定的文件将被下载并保存为/fimename

5.4、如果是一个压缩文件(tar),会被解压为一个目录,但是通过URL下载的tar文件不会被解压

5.5、如果是多个,或者是同一个使用了通配符,则必须是以/结尾的目录,如果不以/结尾,则会被作为一个普通文件,内容讲被写入到

它的用处在于, 能够给那些所有的RUN、CMD、COPY、ADD指令来设定一下工作目录的位置。

bash 复制代码
6.1、WORKDIR /mnt,如果目录不存在会自动创建,包括他的父目录

6.2、一个Dockerfile中WORKDIR可以出现多次,其路径也可以为相对路径,相对路径是基于前一个WORKDIR路径

6.3、WORKDIR也可以调用ENV指定的变量

6.4:举例

from python:latest

workdir /mnt

run touch a.txt

workdir /usr

run touch b.txt

这是一个数据卷, 它的主要用途是在镜像之中创建出挂载点目录。有了这个挂载点目录之后, 就能够把主机上面的卷进行挂载, 或者是把其他容器上面的卷进行挂载。

bash 复制代码
7.1、VOLUM mount_point

7.2、VOLUM ["mount_point1","mount_point2"]

7.3、如果挂载点目录下有文件存在,docker run命令会在卷挂载完成后将所有文件复制到容器中

:为容器打开指定的监听端口以实现与外部通信

bash 复制代码
8.1、EXPOSE 

1、:端口号

2、:协议类型,默认为TCP协议

EXPOSE 8080/tcp 8081/udp

8.2、不会直接对外暴露这里的端口,只有在run的时候加上-P(大写)才会将EXPOSE的端口暴露出去

这个指令是用来给镜像指定那些必需的环境变量的, 然后呢, 这些变量可以被文件里面的其他命令给调用到, 比如说 、、还有和。

bash 复制代码
9.1、ENV key value

1、key之后的所有内容都会被视为value,因此,一次只能设置一个变量

9.2、ENV key=value

1、可以设置多个变量,每个key=value键值对为一个变量

2、如果value中包含空格需要用反斜杠转义,也可以对value加引号进行标识,反斜杠也可以用于续行

9.3、调用格式:$variable_name 或 ${variable_name}

9.4、定义多个变量建议使用第二种方式,以便在同一层中完成

9.5、举例

ENV DOC_DIR=/mnt/doc

COPY index.html ${DOC_DIR:-/mnt/doc}

#-:如果DOC_DIR不存在则使用-后面的默认值

#+:如果DOC_DIR存在则使用+后面的值

在构建镜像的过程里, RUN部分是用来指定需要执行的shell命令的, 其默认的执行方式是使用/bin/sh -c来进行运行。

bash 复制代码
10.1、docker build过程中需要执行的命令

10.2、RUN是在镜像构建完成之后运行结束

10.3、RUN执行的命令只能基于基础镜像的命令,执行之前先要确定基础镜像是否有该命令

10.4、一个Dockerfile可以写多个RUN

语法一、RUN command1 && command2....

1、通常是shell命令且以"/bin/sh -c"来运行它,此时运行为shell的子进程

2、进程在容器中的PID!

=1,不能接收unix信号,当使用docker stop 将无法接收到

3、RUN echo "test_demo" > a.txt 此时可以使用shell特性

语法二、RUN ["executable","param1","param2"]

1、executable为要运行的命令

2、param1为命令运行的参数

3、不会以"/bin/sh -c"运行(非shell子进程),因此不支持shell操作符如变量替换和通配符(?

,*等)

4、如果运行命令需要依赖shell特性可以增加参数,手动启动为shell的子进程

RUN ["/bin/bash","-c","executable","param1"]

5、list中的参数要使用双引号

这个命令的意思是, 在启动容器的时候去指定容器里默认要运行的那个程序或者说那个具体的命令是啥东西, 它里面的设定值一般也就是等于"/bin/sh -c"这样的字符串, 然后去执行相关的操作。

bash 复制代码
11.1、docker run过程中需要执行的命令

11.2、CMD运行结束后容器就将终止

11.3、CMD指定的命令将可以被 docker run 最后面的命令覆盖

11.4、一个Dockerfile写多个CMD只有最后一个CMD会生效

语法一、CMD command

1、通常是shell命令且以"/bin/sh -c"来运行它,此时运行为shell的子进程,能使用shell操作符

2、进程在容器中的PID!

=1,不能接收unix信号,当使用docker stop 将无法接收到

3、CMD /bin/httpd -f -h ${httpd}

此时在运行容器的时候加-it参数无法进入交互式模式,需要使用docker exec进入交互模式

语法二、CMD ["executable","param1","param2"]

1、不会以"/bin/sh -c"运行(非shell子进程),因此不支持shell操作符如变量替换和通配符(?

,*等)

2、如果运行命令需要依赖shell特性可以增加参数,手动启动为shell的子进程

CMD ["/bin/bash","-c","executable","param1","param2"](有问题,不能启动容器)

语法三、CMD ["param1","param2"]

1、需要结合ENTRYPOINT指令提供默认参数使用

类型CMD指令的作用, 是给咱们弄一个事儿, 好给那个容器定下来一个默认要跑的程序, 或者是给它定下来一个默认的指令。

bash 复制代码
1、与CMD不同的是,由ENTRYPOINT启动的程序不会被docker run命令行指定的参数覆盖,这些命令行参数会被当做参数传递给ENTRYPOINT指定的程序

2、docker run命令的 --entrypoint选项参数可以覆盖ENTRYPOINT指令指定的程序

3、一个Dockerfile中可以有多个ENTRYPOINT,但是只有最后一个会生效

4、ENTRYPOINT主要用于shell作为启动其他进程的父进程,后面跟的参数被当成子进程来启动

语法一:ENTRYPOINT command

语法二:ENTRYPOINT ["/bin/bash","param1","param2"]

那个CMD是和同时存在之中。

bash 复制代码
1、CMD的值会当做参数传递给ENTRYPOINT

2、实现使用shell子进程启动httpd

3、如果docker run再传入参数,是传给ENTRYPOINT的,因为ENTRYPOINT有自己的参数,此时CMD参数会被ducker run后面跟的参数覆盖,并不是覆盖ENTRYPOINT的参数,要覆盖ENTRYPOINT的参数需要使用--entrypoint选项

CMD ["/bin/httpd/","-f"]

ENTRYPOINT /bin/bash -c -h

通过传参启动容器

FROM python:latest

LABLE auth="haili"

ENV NGX_DOC_ROOT='/data/web/html'

ADD entrypoint.sh /bin/

CMD ['/usr/sbin/nginx','-g','daemon off;']

ENTRYPOINT ['/bin/sh','-c','/bin/entrypoint.sh']

1、先执行ENTRYPOINT,然后讲CMD的值当做参数传给ENTRYPOINT进行执行

USER:指定运行image时和中任何RUN、CMD、指令指定的程序的用户

bash 复制代码
1、使用用户名或者UID

2、默认情况下container的运行身份为root用户

3、USER UID | user_name

4、UID 和 user_name必须存在/etc/passwd当中,否则会报错

健康检查这一步, 指的是要定义出一个具体的命令。这个命令的作用是什么呢? 作用是专门用来检查主进程当前的工作状态处于一种正常的、健康的状态。

bash 复制代码
15.1、HEALTHCHECK参数

1、--interval=DURATION(default 30s) 健康检查间隔时间

2、--timeout=DURATION(default 30s) 超时时间

3、--start-period=DURATION(default 0s) 容器启动多久后执行健康检查

4、--retries=N(default 30s) 检测次数

15.2、检查结果

0:成功

1:失败

2:预留字段

15.3、举例

HEALTHCHECK --interval=5m --timeout=5s CMD curl -f http://localhost:8080 ||exit1

这里有一个叫做SHELL的东西, 指定运行RUN、CMD的shell程序, 给主进程发送ARG信号, 这里的ARG就是build过程中的参数。

bash 复制代码
 18.1、定义pyton镜像作者,通过参数传入

FROM python

ARG author="latest"

LABLE author="${author}"

18.2、使用

docker build --build-arg author="haili"

18.3、常用在docker build 过程中替换参数

:用于在中定义一个触发器

bash 复制代码
19.1、Dockerfile1中加一个ONBUILD add file,当docker build -t=testpython Dockerfile1的时候ONBUILD指令不会被执行,Dockerfile2中FROM testpython(Dockerfile1构建后生成的镜像),当运行docker build -t=test Dockerfile2的时候Dockerfile1中的ONBUILD add file会被执行

19.2、Dockerfile用于build镜像文件,此镜像文件可以作为base image被另外一个Dockerfile作为FROM参数使用,并以之构建新的镜像文件

19.3、在后面这个Dockerfile中的FROM指令在build过程中被执行时,将触发创建其base image的Dockerfile中ONBUILD指定定义的触发器

19.4、尽管任何指令都可以注册为触发器指令,但是ONBUILD不能自我嵌套,且不会触发FROM和MAINTAINER指令

19.5、使用包含ONBUILD指令的Dockerfile构建镜像应该使用特殊标签如,python:1.0-onbuild

19.6、ONBUILD指令中使用ADD COPY指令要格外小心,因为新构建过程山下文缺少指定的源文件就会失败

相关推荐
vipxieliang10 天前
可观测性与安全的融合:统一数据平台的建设实践
运维·openai·自动化运维
Agent世界12 天前
cookie 判据会撒谎:CDP 登录态保活的五个实测坑
后端·自动化运维
百度Geek说13 天前
QCon上海2026:百度 SRE Agent 规模化落地实践解读
运维·自动化运维
用户403651260591116 天前
Radmin / VNC / RDP / RustDesk:四种远程桌面客户端的启动参数对照与适配层设计
自动化运维
垚垚学技术_聚焦云原生21 天前
Ansible Playbook 进阶:when 条件、loop 循环、handlers 触发器落地
linux·ansible·自动化运维·devops
Sudo思维21 天前
我写了 3 年代码,最后悔的是没早点把服务器巡检脚本化(附完整脚本)
自动化运维
JoePotter22 天前
从零搭建华为云 EVS 每日自动快照:hcloud + PowerShell + 邮件报告实战
华为云·自动化运维·powershell·evs·koocli·快照备份·mailozaurr
Helix25022 天前
Intune 可观测性与 AI 排障实战:Copilot、高级分析与自动化运维指南
copilot·自动化运维·terminal·intune 可观测性·设备时间线·intelligent·ai排障
MoRay23 天前
大专大一,手搓 AIOps 底座:当大模型幻觉时,我的系统在 98.9ms 抓住了宕机的 Redis
自动化运维