容器与云原生 / 系统课时
CMD 与 ENTRYPOINT
CMD 与 ENTRYPOINT
本课解决“容器启动时到底执行什么,以及命令行参数会覆盖哪一部分”的问题。完成后,你将能合理组合 ENTRYPOINT 与 CMD,并准确预测 docker run 追加参数或覆盖入口后的结果。
学习目标
- 区分容器启动入口与默认参数
- 理解 exec 形式和 shell 形式的差异
- 验证运行参数对
CMD与ENTRYPOINT的覆盖规则
两条指令如何分工
ENTRYPOINT 更适合定义容器必须执行的主程序,CMD 更适合提供主程序的默认参数。二者同时使用时,Docker 会把 CMD 内容作为参数追加给 exec 形式的 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 生效。不要依靠多条同名指令表达多个启动步骤;需要启动多个进程时,应重新审视容器职责,或使用明确的进程管理方案。
按自己的节奏,确认真正理解。