容器与云原生 / 系统课时
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:
FROM alpine:3.20
ENTRYPOINT ["echo", "mode:"]
CMD ["prod"]ENTRYPOINT 固定了 echo mode:,CMD 只提供默认参数 prod。构建后分别使用默认参数和自定义参数启动:
docker build -t cmd-entry-demo . >/dev/null 2>&1
docker run --rm cmd-entry-demo
docker run --rm cmd-entry-demo dev预期输出:
mode: prod
mode: dev第二次运行时,dev 替换的是镜像中的 CMD ["prod"],而不是 ENTRYPOINT,所以固定入口仍然存在。
什么时候只用 CMD
如果镜像本身没有必须固定的主程序,只希望提供一个“默认执行命令”,单独使用 CMD 更直接。例如开发工具镜像可能默认启动某个 REPL,但允许调用者把整条命令换成其他工具。
片段示例,依赖镜像中存在 python 和 /app/main.py:
CMD ["python", "/app/main.py"]此时 docker run image 使用默认命令;而 docker run image python /app/debug.py 会用后者替换整个 CMD。
什么时候组合 ENTRYPOINT 和 CMD
应用镜像通常更适合把真正的主程序放进 ENTRYPOINT,把可变参数放进 CMD。例如:
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 继续传参。