容器与云原生 / 系统课时

CMD 和 ENTRYPOINT 怎么组合

CMD 和 ENTRYPOINT 怎么组合

设计容器启动方式时,关键不是记住两个指令的定义,而是决定“什么固定、什么允许调用者覆盖”。ENTRYPOINT 适合固定主程序,CMD 适合提供默认参数;两者配合后,既能让镜像默认可运行,又能在 docker run 时方便替换参数。

学习目标

  • 区分 CMD 与 ENTRYPOINT 在容器启动命令中的职责
  • 理解 docker run 追加参数时,默认命令如何被覆盖或组合
  • 为应用选择清晰、可预测的容器入口写法

先看最终执行规则

Docker 最终需要得到“可执行程序 + 参数”。当 ENTRYPOINT 和 CMD 都采用 exec 形式时,可以把它们理解为前后拼接:

ENTRYPOINT 负责前半段固定命令,CMD 负责后半段默认参数。

Dockerfile 写法 docker run image docker run image dev
只有 CMD ["echo", "prod"] 执行 echo prod 镜像中的 CMD 被整体替换,尝试执行 dev
ENTRYPOINT ["echo"] + CMD ["prod"] 执行 echo prod 保留 echo,把 CMD 替换为 dev,执行 echo dev

因此,只写 CMD 时,运行时参数更像“替换默认命令”;存在 exec 形式 ENTRYPOINT 时,运行时参数更像“替换默认参数”。

用一个镜像验证组合行为

新建 Dockerfile:

dockerfile
FROM alpine:3.20

ENTRYPOINT ["echo", "mode:"]
CMD ["prod"]

ENTRYPOINT 固定了 echo mode:,CMD 只提供默认参数 prod。构建后分别使用默认参数和自定义参数启动:

bash
docker build -t cmd-entry-demo . >/dev/null 2>&1
docker run --rm cmd-entry-demo
docker run --rm cmd-entry-demo dev

预期输出:

text
mode: prod
mode: dev

第二次运行时,dev 替换的是镜像中的 CMD ["prod"],而不是 ENTRYPOINT,所以固定入口仍然存在。

什么时候只用 CMD

如果镜像本身没有必须固定的主程序,只希望提供一个“默认执行命令”,单独使用 CMD 更直接。例如开发工具镜像可能默认启动某个 REPL,但允许调用者把整条命令换成其他工具。

片段示例,依赖镜像中存在 python 和 /app/main.py:

dockerfile
CMD ["python", "/app/main.py"]

此时 docker run image 使用默认命令;而 docker run image python /app/debug.py 会用后者替换整个 CMD。

什么时候组合 ENTRYPOINT 和 CMD

应用镜像通常更适合把真正的主程序放进 ENTRYPOINT,把可变参数放进 CMD。例如:

dockerfile
ENTRYPOINT ["my-server"]
CMD ["--port", "8080"]

默认启动等价于 my-server --port 8080;执行 docker run image --port 9090 时,主程序仍是 my-server,只是参数变成 --port 9090。

避免把覆盖行为设计得太隐蔽

ENTRYPOINT 也可以被 docker run --entrypoint ... 显式覆盖,所以它不是不可改变,而是“默认固定”。如果镜像使用者经常需要替换整个主程序,说明把太多内容放进 ENTRYPOINT 可能反而降低可用性。

设计时可以按一个简单原则判断:镜像代表哪个应用,就把哪个应用固定为入口;调用者日常会调整的启动选项,则作为 CMD 默认参数。 这样 docker run 的覆盖行为最容易预测,也最适合运维脚本和 Compose 继续传参。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

CMD 和 ENTRYPOINT 怎么组合

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通