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

不愿放下技术的小赵

已于 2023-03-18 20:25:50 修改

阅读量2.4k

点赞数 1

分类专栏： Docker 文章标签： docker 学习运维

于 2023-03-18 15:27:21 首次发布

本文链接：https://blog.csdn.net/qq_33204709/article/details/129637619

版权

Docker 专栏收录该内容

25 篇文章 21 订阅

订阅专栏

一、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