Docker学习（二十二）Dockerfile 中 CMD 与 ENTRYPOINT 区别

Dockerfile 中的 CMD 和 ENTRYPOINT 指令是用于定义容器的默认执行命令的两个指令。尽管它们的作用相同，但它们在使用方式上还是有一些区别。

先说结论：

我们指定容器的启动脚本一般就是使用 ENTRYPOINT 来指定。我们可以把那些可能需要变动的参数写到 CMD 中，而把那些不需要变动的参数写到 ENTRYPOINT 里面。

下面详细介绍一下 CMD 指令 和 ENTRYPOINT 指令：

一、CMD 指令

CMD 指令：在容器运行时提供一些命令及参数。存在多条 CMD 指令时，仅最后一个生效。

1.1 常见用法：

• 用法1： 运行一个可执行的文件并提供参数：(exec form, this is the preferred form)

  通常是shell命令且以 "/bin/sh -c" 来运行它，此时运行为shell的子进程，能使用shell操作符。

  CMD ["executable","param1","param2"]
  

• 用法2： 为 ENTRYPOINT 指定参数：(as default parameters to ENTRYPOINT)

  不会以 "/bin/sh -c" 运行(非shell子进程)，因此不支持shell操作符如变量替换和通配符(?,*等)。

  CMD ["param1","param2"]
  

• 用法3： 以 /bin/sh -c 的方法执行的命令：(shell form)

  需要结合ENTRYPOINT指令提供默认参数使用。

  CMD command param1 param2
  

1.2 用法1举例：

我们指定如下命令：

CMD ["/bin/echo","this is a test."]

构建镜像：

doker build -t echo-test .

创建并运行容器：

docker run --name=echo-test echo-test

输出内容：

this is a test.

1.3 docker run 覆盖

当使用 docker run 命令创建容器时，如果指定了参数，就会把 CMD 中指定的命令覆盖掉。例如：

当我们使用如下命令创建并运行容器时：

docker run --name=echo-test echo-test /bin/bash

输出内容：无，因为 CMD 指定的命令被 /bin/bash 覆盖了。

二、ENTRYPOINT 指令

ENTRYPOINT 指令：字面意思是进入点，用于在容器启动时指定默认的执行命令。存在多条 ENTRYPOINT 指令时，仅最后一个生效。

An ENTRYPOINT allows you to configure a container that will run as an executable.

它可以让你的容器功能表现得像一个可执行程序一样。

2.1 常见用法：

ENTRYPOINT 指令 只有一个用法：运行一个可执行的文件并提供参数。

我们指定容器的启动脚本一般就是使用 ENTRYPOINT 来指定。我们可以把那些可能需要变动的参数写到 CMD 中，而把那些不需要变动的参数写到 ENTRYPOINT 里面。

2.2 两种写法：

• 写法一：(the preferred exec form)

  ENTRYPOINT ["executable","param1","param2"]
  

• 写法二：(shell form)

  ENTRYPOINT command param1 param2
  

注意：

• 你也可以在 docker run 命令中使用 --entrypoint 指定启动命令，但是只能用写法一；

• 第二种写法(shell form)会屏蔽掉 docker run 时后面指定的参数和 CMD 中指定的参数。

• 网上有资料说 ENTRYPOINT 的默认值是 ["/bin/s","-c"]，其实不然，当我们使用 ENTRYPOINT ["/bin/sh","-c"] 指令构造一个镜像 sh 时，我们可以这样运行：

  docker run -it sh "while(true) do echo loop; done;"
  

  会一直打印 loop：

  

  但是如果我们直接运行一个 centos:latest 镜像：

  docker run -it centos:latest "while(true) do echo loop; done;"
  

  会报如下错误：

  

  docker: Error response from daemon: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "while(true) do echo loop;done;": executable file not found in $PATH: unknown.
  

  所以可以得知默认情况下 ENTRYPOINT 并不是 ["/bin/sh","-c"]，而应该是默认为空，使用时需要手动指定 "/bin/sh","-c"：

  docker run -it centos:latest "/bin/sh" "-c" "while(true) do echo loop; done;"
  

  执行结果如下：

  

三、ENTRYPOINT 指令和 CMD 指令正确用法举例

假如，我们需要写一个用于构建 nginx 基础镜像的 Dockerfile，我们可以这么写：

FROM centos:latest
RUN yum -q -y update && yum -q -y upgrade \
    &&  yum install -y nginx
    &&  yum clean all
EXPOSE 80
ENTRYPOINT ["nginx"]
CMD ["-c","/etc/nginx.conf"]

• ENTRYPOINT 指令 指定了镜像的启动方式为 nginx 命令，一般不会被覆盖，需要的话可以通过在 docker run 中指定 --entrypoint 进行覆盖。

  docker run -it -p 81:80 --name=nginx-base --entrypoint /bin/bash nginx-base:v1
  

• CMD 指令 指定了 nginx 启动时默认使用的配置文件位置，如果有需要，可以在 docker run 命令创建容器时重新指定配置文件的位置。

整理完毕，完结撒花~

参考地址：

1.论docker中 CMD 与 ENTRYPOINT 的区别，https://www.scholat.com/vpost.html?pid=7633
2.Dockerfile文件解释，https://blog.csdn.net/weixin_42688573/article/details/125464719