dockerfile中ENTRYPOINT与CMD的结合使用及区别
我们在上篇小作文[]对中dockerfile有了比较全面的认识,我们也提到`entrypoint`和`cmd`都可以指定容器启动命令。因为这两个命令是掌握dockerfile编写的核心,所以这边还是单独拿出来再讲一讲。
一、写在前面
我们在上篇小作文docker容器dockerfile详解对中dockerfile有了比较全面的认识,我们也提到entrypoint
和cmd
都可以指定容器启动命令。因为这两个命令是掌握dockerfile编写的核心,所以这边还是单独拿出来再讲一讲。
二、cmd 与 entrypoint主要区别
我们直接进入主题,cmd 与 entrypoint都是用于指定启动容器执行的命令,区别在于:
- 当docker run 命令中有参数时,守护进程会忽略cmd命令。
- 使用entrypoint指令不会忽略,并且会接收docker run 参数附加到命令行中。
为了使构建的容器可以正常启动,我们编写的dockerfile文件必须包含一个cmd或entrypoint指令。
三、cmd 与 entrypoint的结合使用
1.cmd
cmd
指令有三种形式:
-
cmd ["executable","param1","param2"]
(exec形式,这是首选形式) -
cmd ["param1","param2"]
(作为entrypoint 的默认参数) -
cmd command param1 param2
(shell形式)
dockerfile文件中包含多个cmd时,只有最后一个被加载使用。
我们在dockerhub中搜索centos官方镜像,看一下的官方dockerfile文件。
基本上每一个官方镜像都会为我们提供各自版本的dockerfile链接,如下:
我们查看latest
标签的dockerfile
from scratch add centos-8-x86_64.tar.xz / label org.label-schema.schema-version="1.0" org.label-schema.name="centos base image" org.label-schema.vendor="centos" org.label-schema.license="gplv2" org.label-schema.build-date="20201204" cmd ["/bin/bash"]
只有四行,这就是构建一个latest
版本centos8.3.2011镜像的dockerfile全部内容。指定基镜像(这里从scratch这个空镜像开始构建),添加rootfs内容,打标签,通过cmd指定启动命令。
不止centos,其他debian、ubuntu、busybox等镜像都只需通过cmd指定启动命令。比如busybox更为简约:
from scratch add busybox.tar.xz / cmd ["sh"]
这种基础类、工具类镜像的构建我们只需要指定一个必要cmd来启动容器即可。但是我们编写一个dockerfile并不是为了启动容器而编写,大多数时候我们要在容器运行我们的app,运行我们的服务。
当然通过cmd也可以启动,可是如此一来有一个缺陷,我们上面说到的cmd的启动命令会被docker run 参数代替。
我们有下面dockerfile
[root@localhost dockerfiles]# cat dockerfile from centos cmd ["/bin/top","-b"]
构建后,使用参数ps启动容器。
[root@localhost dockerfiles]# docker run -it centos_top:v1 ps pid tty time cmd 1 pts/0 00:00:00 ps
可看看到启动容器后top -b
已经被替换为ps,并非实现参数的替换。显然这不是我们想要的。有没有什么办法既可以默认启动应用,又可以加载到docker run 参数?这就是接下来entrypoint与cmd的妙用。
2.entrypoint结合cmd
entrypoint
的exec和shell形式:
entrypoint ["executable", "param1", "param2"]
entrypoint command param1 param2
上面我们提到cmd ["param1","param2"]
形式可以作为entrypoint参数,同时entrypoint 指定的命令无法被docker run 参数取代。假如我们把cmd和entrypoint两个指令相结合,这样我们就可以通过cmd来接收docker run 参数,然后把参数传递给entrypoint执行。
我们以nginx官方dockerfile latest版本1.21为例
首先我们查看dockerfile
,这里我们只关注启动命令,如下:
... copy docker-entrypoint.sh / copy 10-listen-on-ipv6-by-default.sh /docker-entrypoint.d copy 20-envsubst-on-templates.sh /docker-entrypoint.d copy 30-tune-worker-processes.sh /docker-entrypoint.d entrypoint ["/docker-entrypoint.sh"] expose 80 stopsignal sigquit cmd ["nginx", "-g", "daemon off;"]
从上面我们可以看到,在启动nginx容器时首先运行docker-entrypoint.sh
脚本并把cmd命令中的参数nginx -g "daemon off;"
传递进来。即docker run不添加参数时启动容器相当于执行如下脚本与默认参数。
#docker-entrypoint.sh nginx -g "daemon off;"
当我们使用docker run 传入参数会怎样?
我传入nginx-debug
#docker run -dt nginx nginx-debug -g "daemon off;"
此时启动容器相当于执行如下脚本与参数
#docker-entrypoint.sh nginx-debug -g "daemon off;"
我们通过ps来看一下我们启动的容器
[root@localhost dockerfiles]# ps -ef|grep nginx root 6327 6306 0 aug12 pts/0 00:00:00 nginx: master process nginx -g daemon off; 101 6384 6327 0 aug12 pts/0 00:00:00 nginx: worker process 101 6385 6327 0 aug12 pts/0 00:00:00 nginx: worker process root 16800 16780 3 12:51 pts/0 00:00:00 nginx: master process nginx-debug -g daemon off; 101 16857 16800 0 12:51 pts/0 00:00:00 nginx: worker process 101 16858 16800 0 12:51 pts/0 00:00:00 nginx: worker process
显然我们两种参数nginx、nginx-debug的容器都启动成功!
也就是说我们通过entrypoint ["/docker-entrypoint.sh"]
指定的命令在启动时无论如何都会执行,并且可以接收到了docker run 的参数。
docker-entrypoint.sh是什么?docker-entrypoint.sh这是一个预处理脚本通常用来过滤命令行参数或者执行exec 来启动容器为1的进程。
通过entrypoint+cmd实现命令默认参数或接收docker run 参数是一种非常流行并且有用的dockerfile编写方式。
到此这篇关于dockerfile中entrypoint与cmd的结合的文章就介绍到这了,更多相关dockerfile中entrypoint与cmd内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!