系列博文之前讲解过RUN
和CMD
,其中CMD
可以作为容器启动时的默认命令使用,而ENTRYPOINT
是位于CMD
之上的命令,同样可以可以设置容器启动时的入口点,可以使用ENTRYPOINT
做许多系统初始化级别的工作。
ENTRYPOINT 语法
# exec形式,首选形式.ENTRYPOINT ["executable", "param1", "param2"]# shell形式.ENTRYPOINT command param1 param2
ENTRYPOINT 语义
·ENTRYPOINT
允许配置以可执行文件方式运行的容器。
·示例:
如下命令使用默认内容启动Nginx
,监听80端口:
docker run -i -t --rm -p 80:80 nginx
·docker run <image>
的命令行参数将追加到ENTRYPOINT
中的所有参数之后,并将重写使用CMD
指定的所有参数。这允许将参数传递到入口点,即docker run <image> -d
将把-d
参数传递给入口点。可以使用docker run --entrypoint
来重写ENTRYPOINT
指令。
·shell
形式禁止使用任何CMD
或RUN
命令行参数,缺点是ENTRYPOINT
作为/bin/sh -c
的子命令启动,其不会传递信号。这意味着可执行文件将不是容器的PID 1
,也不会接收Unix
信号,因此可执行文件将不会从docker stop <container>
接收SIGTERM
。
·dockerfile
中允许存在多个ENTRYPOINT
指令,但仅最后一个ENTRYPOINT
指令才会起作用。
ENTRYPOINT exec形式 示例
·使用ENTRYPOINT
的exec
形式设置相当稳定的默认命令和参数,使用CMD
的任一形式设置额外的默认参数。
FROM ubuntuENTRYPOINT ["top", "-b"]CMD ["-c"]
·当容器运行时,可以看到top
是唯一的进程:
docker run --name securitit-nginx-entrypoint -it securitit-nginx-entrypoint:1.0.0.1
·为进一步确认结果,可以使用docker exec
查看:
docker exec -it 285188694a00 ps aux
·可以优雅地查看top
,并使用docker stop
关闭。
·通过ENTRYPOINT
运行Aapche
。
1)dockerfile
配置如下,配置中安装内容较多,会比较慢。
FROM debian:stableRUN apt-get update && apt-get install -y --force-yes apache2EXPOSE 80 443VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]ENTRYPOINT ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]
2)如果需要为可执行文件编写启动程序脚本,可以使用exec
和gosu
命令确保最终可执行文件接收到Unix
信号。
#!/usr/bin/env bashset -eif [ "$1" = 'postgres' ]; thenchown -R postgres "$PGDATA"if [ -z "$(ls -A "$PGDATA")" ]; thengosu postgres initdbfiexec gosu postgres "$@"fiexec "$@"
3)最后,如果需要在关闭时执行一些额外的清理(或与其他容器通信),或者正在协调多个可执行文件,则需要确保ENTRYPOINT
脚本接收到Unix
信号,将其传递,然后执行更多的工作。
#!/bin/sh# Note: I've written this using sh so it works in the busybox container too# USE the trap if you need to also do manual cleanup after the service is stopped,#or need to start multiple services in the one containertrap "echo TRAPed signal" HUP INT QUIT TERM# start service in background here/usr/sbin/apachectl startecho "[hit enter key to exit] or run 'docker stop <container>'"read# stop service and clean up hereecho "stopping apache"/usr/sbin/apachectl stopecho "exited $0"
·可以使用--entrypoint
重写ENTRYPOINT
设置,但这只能将二进制文件设置为exec
(不使用sh -c
)。
·exec
形式是按照JSON Array格式解析,意味着必须是使用双引号(")包含参数,而不能使用单引号(’)。
·与shell
形式不同,exec
形式不会调用shell
命令行,意味着不会进行shell
处理。例如:运行RUN [ "echo", "$HOME" ]
不会对$HOME
进行变量替换。如果需要shell
处理,那么可以使用shell
形式或直接执行shell
,例如:ENTRYPOINT["sh","-c","echo $HOME"]
。当使用exec
形式直接执行shell
时,与shell
形式类似,应用的shell
是宿主机而非Docker。
ENTRYPOINT shell形式 示例
·shell
形式可以为ENTRYPOINT
指定文本,运行在/bin/sh -c
中。这种形式将使用shell
处理,替换掉shell
环境变量,同时会忽略掉所有CMD
和docker run
命令行参数。
·为确保docker stop
能够正确地向任何长时间运行的ENTRYPOINT
可执行文件发出信号,谨记用exec启动它,例如:
FROM ubuntuENTRYPOINT exec top -b
·当运行上面dockerfile
生成的镜像时,将会看到唯一的PID 1
的进程:
docker run --name securitit-nginx-entrypoint -it securitit-nginx-entrypoint-shell:1.0.0.1
·如果ENTRYPOINT
后忘了加exec
,那么ENTRYPOINT
可能会不是PID 1
进程。
CMD与ENTRYPOINT协作
·CMD
和ENTRYPOINT
指令都定义了运行容器时执行的命令。关于CMD
和ENTRYPOINT
的协作描述很少。
1)dockerfile
应至少指定一个CMD
或ENTRYPOINT
命令。
2)将容器用作可执行文件时,应定义ENTRYPOINT
。
3)CMD
应该用作定义ENTRYPOINT
指令或ad-hoc
指令的默认参数。
4)使用可替代参数运行容器时,CMD
会被重写。
·下表列举了对不同的CMD
、ENTRYPOINT
组合执行的命令:
总结
RUN
、CMD
、ENTRYPOINT
是比较主要的操作指令,可以在构建镜像时,根据需求进行定制。本文是参考Docker官网文档所写。
若文中存在错误和不足,欢迎指正!
如果觉得《Dockerfile ENTRYPOINT指令 语法解析》对你有帮助,请点赞、收藏,并留下你的观点哦!