Dockerfile 中 ENTRYPOINT 和 CMD 的差异与联系

Docker Dockerfile K8s

字数统计: 786阅读时长: 3 min

 2024/06/12 

首先，需要阐明的是，容器中运行的完整指令由两部分组成：命令与参数。

辨析 ENTRYPOINT 与 CMD

在使用 Dockerfile 构建镜像的时候，可以指定这个镜像在运行时执行的命令。而这一入口命令，就是通过 Dockerfile 来指定的。在 Dockerfile 中，有两个名字较为类似且功能表现上存在交叉的命令，他们就是 ENTRYPOINT 和 CMD。

首先，按照设定的用法而言，它们分别用于定义命令与参数这两个部分：

尽管可以直接使用 CMD 指令来指定镜像运行时需要执行的命令，但正确的用法应当是借助 ENTRYPOINT 指令，仅仅用 CMD 指定执行时所需要的默认参数。这样，镜像就可以直接启动运行，无需添加任何参数：

1	docker run <image>

当然，也可以在命令行中添加一些参数，来覆盖 Dockerfile 中任何由 CMD 指定的默认参数值：

1	docker run <image> <arguments>

对于上述的 ENTRYPOINT 和 CMD，均支持以下两种形式：

而这两者的区别在于指定的命令是否是在 shell 中被调用。

如果使用的是 exec 形式的 ENTRYPOINT 指令，可以从容器中的运行进程列表看到，它是直接运行的 node 进程，而并非在 shell 中执行：

1	docker exec 4675d ps x

1
2
3

PID TTY    STAT   TIME  COMMAND
  1 ?      Ssl    0:00  node app.js
 12 ?      Rs     0:00  ps x

而如果使用的是 shell 形式，容器将进程如下所示：

1	docker exec -it e4bad ps x

PID TTY    STAT   TIME  COMMAND
  1 ?      Ss     0:00  /bin/sh -c node app.js
  7 ?      Sl     0:00  node app.js
 13 ?      Rs+    0:00  ps x

可以看到主进程（PID 1）是 shell 进程而非 node 进程，node 进程（PID 7）是在 shell 进程中启动的。这里的 shell 进程往往是多余的，因此通常可以直接采用 exec 形式的 ENTRYPOINT 指令。

在 Kubernetes 中定义容器时，镜像的 ENTRYPOINT 和 CMD 均可以被覆盖，只需要在对容器的定义中指定 command 和 args 的值即可，举个例子：

kind: Pod
spec:
  containers:
  - image: some/image
    command: ["/bin/command"]
    args: ["arg1", "arg2", "arg3"]

绝大多数情况下，只需要设置自定义参数，而命令通常很少被覆盖，除非针对一些未定义 ENTRYPOINT 的通用镜像。

注意：command 和 args 字段在 pod 创建后无法被修改。

上述的两条 Dockerfile 指令与等同的 pod 规格字段对比如下：

Docker	Kubernetes	描述
ENTRYPOINT	command	容器中运行的可执行文件
CMD	args	传递给可执行文件的参数

此外，少量参数只的设置可以使用上面示例中的数组表示，多参数值情况可以采用如下标记：

args:
  - foo
  - bar
  - "15"

其中字符串无需用引号标记，而数值需要。

原文作者：Modnar Shen

CATALOG