dockerFile:CMDvsENTRYPOINT、shellVSexec

docker summary_2018/11

1、CMD vs ENTRYPOINT

• CMD:The main purpose of a CMD is to provide defaults for an executing container. These defaults can include an executable, or they can omit the executable, in which case you must specify an ENTRYPOINT instruction as well.(提供一个程序启动的默认启动命令)

CMD ["executable","param1","param2"] (exec form, this is the preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

• ENTRYPOINT：程序启动的入口

ENTRYPOINT ["executable", "param1", "param2"] (exec form, preferred)
ENTRYPOINT command param1 param2 (shell form)

• Tips:
  
  • 1、如果 docker run 指定了其他命令，CMD 指定的默认命令将被覆盖；如果 Dockerfile 中有多个 CMD指令，只有最后一个 CMD 有效。
  • 2、如果 docker run 指定了其他命令将作为 ENTRYPOINT 的参数；如果 Dockerfile 中有多个 ENTRYPOINT 指令，只有最后一个ENTRYPOINT 有效。
  • 3、exec一个参数占一个位置"-1","-2",不然无法识别。

2、shell VS exec

• RUN, CMD 和 ENTRYPOINT均支持shell、exec两种写法，但是两者却有较大的差别。

ENTRYPOINT ["executable", "param1", "param2"] (exec form, preferred)
ENTRYPOINT command param1 param2 (shell form)

• 实践

// shell模式
dockerfile:
FROM ubuntu:trusty
ENTRYPOINT ping localhost
14:37:45 › docker exec 9d9104d29128  ps -f
UID        PID  PPID  C STIME TTY          TIME CMD
root         1     0  0 06:35 ?        00:00:00 /bin/sh -c ping localhost
root         6     1  0 06:35 ?        00:00:00 ping localhost
root         7     0  0 06:38 ?        00:00:00 ps -f
可以看到pid=1的shell进程，而不是我们运行的进程
// exec模式
FROM ubuntu:trusty
ENTRYPOINT ["ping","localhost"]
15:10:11 › docker exec d0caad39e3c7  ps -f
UID        PID  PPID  C STIME TTY          TIME CMD
root         1     0  0 07:10 ?        00:00:00 ping localhost
root         9     0  0 07:10 ?        00:00:00 ps -f
Tips:运行的进程pid=1,而不是shell进程，可以接受到SIGTERM信号
// exec使用其它shell
FROM ubuntu:trusty
ENTRYPOINT ["sh", "-c","ping localhost"]
15:06:59 › docker exec dca700a76b8f  ps -f
UID        PID  PPID  C STIME TTY          TIME CMD
root         1     0  0 07:06 ?        00:00:00 sh -c ping localhost
root         7     1  0 07:06 ?        00:00:00 ping localhost
root         8     0  0 07:07 ?        00:00:00 ps -f
因此：当exec模式使用其它shell,可以看到pid=1的shell进程，因为此时把运行shell进程当作我们自身的进程的一部分

• 结论

1、shell模式：使用/bin/sh-c执行，shell进程作为pid=1的，执行的命令作为shell进程的子进程运行；
docker stop <container>:当使用stop命令停止时，会首先容器中pid=1的进程发送SIGTERM信号，而不会转发给它的子进程，并给予一定时间10s缓冲(可以设置),当时间超时后才使用-9强杀；因此这种情况会导致容器内的服务毫无征兆的被杀死。
2、exec模式：exec作为shell的内键命令，不会启动新的shell进程，而是使用执行的命令来替换当前进程，使pid=1,能够收到SIGTERM信号;

• 深入探究

// 查看上面的image
docker inspect xxx
//shell 模式
"ENTRYPOINT": [
     "/bin/sh",
     "-c",
     "ping localhost"
       ]
// exec
"ENTRYPOINT": [
      "ping",
      "localhost"
       ],
// exec shell 
"ENTRYPOINT": [
    "sh",
    "-c",
    "ping localhost"
       ]
Tips:
1、我们可以看出ENTRYPOINT传递参数其实就是在json数组后加参数，比如shell模式给/bin/sh加参数,上面的exec就是给ping加参数；当然参数不符合就会失败。
2、虽然有shell、和exec两种方式，最后都被解析成了数组的格式。

3、参考

• Dockerfile：ENTRYPOINT与CMD
• Dockerfile 中命令的两种书写方式的区别
• RUN vs CMD vs ENTRYPOINT