锐客网

  1. 首页 > it技术 > >

dockerfile|dockerfile 中的 entrypoint 和 cmd

ENTRYPOINT 指令 ENTRYPOINT 指令可以有两种写法：

  • ENTRYPOINT ["executable", "param1", "param2"] 【exec form, 推荐使用写法】
  • ENTRYPOINT command param1 param2 【shell form, 等同于execform 的 ENTRYPOINT ["sh", "-c, "command param1 param2"]】
CMD 指令 CMD 指令有三种形式：
  • CMD ["executable","param1","param2"] (exec form, 推荐形式)
  • CMD ["param1","param2"] (给 ENTRYPOINT 指令提供默认参数)
  • CMD command param1 param2 (shell form,基本同 ENTRYPOINT的参数)
exec form 和 shell form 隐含规则
  • exec form 会被docker engine解析为一个 JSON 数组, 所以必须使用双引号，不能使用单引号
  • 可以使用 docker run --entrypoint 覆盖 ENTRYPOINT 指令
  • docker run 后面的所有参数会被追加到 ENTRYPOINT exec form 后，并且会覆盖CMD 指定的值。 这可以传递参数给entrypoint。例如：docker run -d 将会把 -d 参数传递给 entry point。
例如：
ENTRYPOINT [nginx] CMD ['-g', 'daemon off; ']

运行 docker run -i -t --rm -p 80:80 nginx, 会执行 nginx -g "daemon off"
运行 docker run -i -t --rm -p 80:80 nginx nginx -t， 则执行 nginx -t
  • ENTRYPOINT shell form 将会阻止所有的 CMD指令参数 和 run命令行参数被使用，但是它以/bin/sh -c 子命令的形式执行， 不能接收 signals,这意味着执行文件并不是以 container的 pid来运行命令，所以不能接到 docker stop 的 SIGTERM
  • exec form 不能调用shell 命令
ENTRYPOINT [ "echo", "$HOME" ]## 不会解析 $HOME 变量 ENTRYPOINT [ "sh", "-c", "echo $HOME" ] ## 会解携 $HOME 变量

  • 一个dockerfile只能有一个cmd起作用，如果有多个，则使用最后一个, 升级Dockerfile 会被置空，因此，每个Dockerfile 必须定义自己的 CMD 指令
ENTRYPOINT 和 CMD 的配合使用形式
  • ENTRYPOINT 和 CMD 至少包含一个
  • 当使用容器当作可执行文件是应当定义 ENTRYPOINT
  • CMD 主要被作为提供ENTRYPOINT的默认参数来使用
两者的关系图如下：

dockerfile|dockerfile 中的 entrypoint 和 cmd
文章图片
entrypoint-vs-cmd shell 中 source，sh，和exec的区别 shell form不推荐的原因在于不能接收signal信号， 再深究其原因，在于 shell三种执行命令方式的不同
shell 执行脚本或命令有三种:
  • sh 默认
使用$ sh script.sh执行脚本时，当前shell是父进程，生成一个子shell进程，在子shell中执行脚本。脚本执行完毕，退出子shell，回到当前shell。
sh script.sh

  • source
使用$ source script.sh方式，在当前上下文中执行脚本，不会生成新的进程。脚本执行完毕，回到当前shell。
source script.sh

  • exec
exec command

使用exec command方式，会用command进程替换当前shell进程，并且保持PID不变。执行完毕，直接退出，不回到之前的shell环境。
以上几种形式的不同点在于 ：
  • souce，在subshell执行，后返回父shell， 会改变当前的执行环境
  • sh, 在subshell执行，后返回父shell， 当前执行环境不会改变
  • exec, 在父shell中直接执行， 执行完会调用exit，退出当前进程
【dockerfile|dockerfile 中的 entrypoint 和 cmd】subshell 对signal等信号是没有反应的
参考
  • exec, sh 和souce 三者的区别
  • entrypoint-vs-cmd

    推荐阅读


    上一篇：《重生未来之星玉》第十八章1页

    下一篇：思念永恒