容器与云原生 / 系统课时

CMD 与 ENTRYPOINT

CMD 与 ENTRYPOINT

本课解决“容器启动时到底执行什么,以及命令行参数会覆盖哪一部分”的问题。完成后,你将能合理组合 ENTRYPOINT 与 CMD,并准确预测 docker run 追加参数或覆盖入口后的结果。

学习目标

  • 区分容器启动入口与默认参数
  • 理解 exec 形式和 shell 形式的差异
  • 验证运行参数对 CMD 与 ENTRYPOINT 的覆盖规则

两条指令如何分工

ENTRYPOINT 更适合定义容器必须执行的主程序,CMD 更适合提供主程序的默认参数。二者同时使用时,Docker 会把 CMD 内容作为参数追加给 exec 形式的 ENTRYPOINT。

CMD 与 ENTRYPOINT 的运行时覆盖规则

仅使用 CMD 时,用户在 docker run 镜像 参数 后提供的新参数会替换原 CMD。使用 --entrypoint 时,则可以替换镜像定义的 ENTRYPOINT。

推荐使用 exec 形式

exec 形式使用 JSON 数组,不经过默认 Shell,参数边界明确,主进程也更容易正确接收停止信号:

dockerfile
ENTRYPOINT ["java", "-jar", "/app/app.jar"]
CMD ["--server.port=8080"]

shell 形式如 CMD java -jar app.jar 会由 /bin/sh -c 执行,适合确实需要管道、变量展开或重定向的场景,但要额外关注信号转发和引号解析。

完整覆盖示例

创建以下 Dockerfile:

dockerfile
FROM alpine:3.20
ENTRYPOINT ["printf", "service=%s\n"]
CMD ["api"]

构建镜像:

bash
docker build -q -t command-demo:1.0 .

预期输出:

text
<IMAGE_ID>

不传额外参数时,CMD 提供默认值:

bash
docker run --rm command-demo:1.0

预期输出:

text
service=api

在镜像名后传入参数,会替换原 CMD:

bash
docker run --rm command-demo:1.0 worker

预期输出:

text
service=worker

使用 --entrypoint 可以替换入口程序:

bash
docker run --rm --entrypoint echo command-demo:1.0 manual

预期输出:

text
manual

选择规则

通用工具镜像通常把工具本身放在 ENTRYPOINT,把常用参数放在 CMD,便于用户追加参数。需要完全自由执行不同命令的基础环境镜像,可以只使用 CMD。

一个 Dockerfile 中只有最后一条 CMD 和最后一条 ENTRYPOINT 生效。不要依靠多条同名指令表达多个启动步骤;需要启动多个进程时,应重新审视容器职责,或使用明确的进程管理方案。

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

目录与阅读设置

阅读设置

17

记录一个想法

CMD 与 ENTRYPOINT

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

登录哪都通