容器与云原生 / 系统课时

设置容器启动方式

设置容器启动方式

镜像构建完成后,需要明确容器启动时默认执行什么程序、携带哪些参数,以及用户能否在运行时覆盖它们。本课通过 CMD 与 ENTRYPOINT 的组合,建立一套可预测、易覆盖、能正确接收停止信号的启动方式。

学习目标

  • 区分 CMD 与 ENTRYPOINT 的职责
  • 使用 exec 形式定义默认程序和参数
  • 判断 docker run 参数会覆盖哪一部分

CMD 与 ENTRYPOINT 的职责

ENTRYPOINT 更适合定义镜像的固定主程序,CMD 更适合提供这个程序的默认参数。只写 CMD 时,运行镜像后追加的参数会整体替换它;同时写两者时,追加参数通常只替换 CMD。

推荐使用 JSON 数组形式,也称 exec 形式。Docker 会直接启动目标程序,使它成为容器内的 PID 1,更容易正确接收 SIGTERM 等停止信号。

组合默认程序与参数

下面的镜像固定执行 ping,默认向本机地址发送 4 次请求。ENTRYPOINT 决定程序,CMD 决定可替换参数。

dockerfile
FROM alpine:3.20

ENTRYPOINT ["ping"]
CMD ["-c", "4", "127.0.0.1"]

在包含该 Dockerfile 的目录执行:

bash
docker build -t startup-demo .
docker run --rm startup-demo

预期输出:

text
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 两次。

bash
docker run --rm startup-demo -c 2 localhost
docker run --rm --entrypoint echo startup-demo "custom entrypoint"

预期输出:

text
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。

bash
#!/bin/sh
set -e

echo "starting application"
exec "$@"

这是片段示例,需要在 Dockerfile 中复制脚本、赋予执行权限,并把它设置为 ENTRYPOINT。容器启动后,最终程序会替换 shell 进程,从而直接接收 Docker 发送的信号。

本课总结

  • ENTRYPOINT 定义稳定的主程序,CMD 提供可覆盖的默认参数
  • 优先使用 exec 形式,避免额外 shell 影响信号传递
  • 镜像名后的参数覆盖 CMD,--entrypoint 才会替换主程序

下一课预告

下一课将控制 Docker 构建上下文,减少无关文件传输,并阻止日志、依赖目录和敏感配置被意外发送给构建器。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置容器启动方式

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

登录哪都通