失眠网,内容丰富有趣,生活中的好帮手!
失眠网 > Dockerfile ENTRYPOINT指令 语法解析

Dockerfile ENTRYPOINT指令 语法解析

时间:2023-09-13 12:05:45

相关推荐

Dockerfile ENTRYPOINT指令 语法解析

系列博文之前讲解过RUNCMD,其中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形式禁止使用任何CMDRUN命令行参数,缺点是ENTRYPOINT作为/bin/sh -c的子命令启动,其不会传递信号。这意味着可执行文件将不是容器的PID 1,也不会接收Unix信号,因此可执行文件将不会从docker stop <container>接收SIGTERM

·dockerfile中允许存在多个ENTRYPOINT指令,但仅最后一个ENTRYPOINT指令才会起作用。

ENTRYPOINT exec形式 示例

·使用ENTRYPOINTexec形式设置相当稳定的默认命令和参数,使用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)如果需要为可执行文件编写启动程序脚本,可以使用execgosu命令确保最终可执行文件接收到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环境变量,同时会忽略掉所有CMDdocker 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协作

·CMDENTRYPOINT指令都定义了运行容器时执行的命令。关于CMDENTRYPOINT的协作描述很少。

1)dockerfile应至少指定一个CMDENTRYPOINT命令。

2)将容器用作可执行文件时,应定义ENTRYPOINT

3)CMD应该用作定义ENTRYPOINT指令或ad-hoc指令的默认参数。

4)使用可替代参数运行容器时,CMD会被重写。

·下表列举了对不同的CMDENTRYPOINT组合执行的命令:

总结

RUNCMDENTRYPOINT是比较主要的操作指令,可以在构建镜像时,根据需求进行定制。本文是参考Docker官网文档所写。

若文中存在错误和不足,欢迎指正!

如果觉得《Dockerfile ENTRYPOINT指令 语法解析》对你有帮助,请点赞、收藏,并留下你的观点哦!

本内容不代表本网观点和政治立场,如有侵犯你的权益请联系我们处理。
网友评论
网友评论仅供其表达个人看法,并不表明网站立场。