容器与云原生 / 系统课时
设置容器启动方式
设置容器启动方式
镜像构建完成后,需要明确容器启动时默认执行什么程序、携带哪些参数,以及用户能否在运行时覆盖它们。本课通过 CMD 与 ENTRYPOINT 的组合,建立一套可预测、易覆盖、能正确接收停止信号的启动方式。
学习目标
- 区分
CMD与ENTRYPOINT的职责 - 使用 exec 形式定义默认程序和参数
- 判断
docker run参数会覆盖哪一部分
CMD 与 ENTRYPOINT 的职责
ENTRYPOINT 更适合定义镜像的固定主程序,CMD 更适合提供这个程序的默认参数。只写 CMD 时,运行镜像后追加的参数会整体替换它;同时写两者时,追加参数通常只替换 CMD。
推荐使用 JSON 数组形式,也称 exec 形式。Docker 会直接启动目标程序,使它成为容器内的 PID 1,更容易正确接收 SIGTERM 等停止信号。
组合默认程序与参数
下面的镜像固定执行 ping,默认向本机地址发送 4 次请求。ENTRYPOINT 决定程序,CMD 决定可替换参数。
FROM alpine:3.20
ENTRYPOINT ["ping"]
CMD ["-c", "4", "127.0.0.1"]在包含该 Dockerfile 的目录执行:
docker build -t startup-demo .
docker run --rm startup-demo预期输出:
PING 127.0.0.1 (127.0.0.1): 56 data bytes
64 bytes from 127.0.0.1: seq=0 ttl=64 time=<TIME> ms
...
4 packets transmitted, 4 packets received, 0% packet loss<TIME> 为动态耗时,实际值会因运行环境不同而变化。
覆盖默认参数和主程序
镜像名后面的内容会替换 CMD,但保留 ENTRYPOINT。因此下面的命令仍执行 ping,只是改为请求 localhost 两次。
docker run --rm startup-demo -c 2 localhost
docker run --rm --entrypoint echo startup-demo "custom entrypoint"预期输出:
PING localhost (127.0.0.1): 56 data bytes
...
2 packets transmitted, 2 packets received, 0% packet loss
custom entrypoint第一条命令验证默认参数可覆盖,第二条通过 --entrypoint 临时替换主程序。--entrypoint 只接受新的可执行程序,后续参数仍应写在镜像名之后。
避免 shell 形式的信号问题
CMD ping -c 4 127.0.0.1 属于 shell 形式,Docker 实际会通过 /bin/sh -c 启动命令。此时 shell 可能成为 PID 1,主程序未必能直接收到停止信号。
只有确实需要变量展开、管道或重定向时才使用 shell 形式。更稳妥的做法是把复杂启动逻辑写进脚本,并在脚本最后使用 exec "$@" 交出 PID 1。
#!/bin/sh
set -e
echo "starting application"
exec "$@"这是片段示例,需要在 Dockerfile 中复制脚本、赋予执行权限,并把它设置为 ENTRYPOINT。容器启动后,最终程序会替换 shell 进程,从而直接接收 Docker 发送的信号。
本课总结
ENTRYPOINT定义稳定的主程序,CMD提供可覆盖的默认参数- 优先使用 exec 形式,避免额外 shell 影响信号传递
- 镜像名后的参数覆盖
CMD,--entrypoint才会替换主程序
下一课预告
下一课将控制 Docker 构建上下文,减少无关文件传输,并阻止日志、依赖目录和敏感配置被意外发送给构建器。