Docker 容器生命周期各个钩子怎么在项目中应用-Docker-PHP中文网

docker容器无原生生命周期钩子，需通过entrypoint脚本实现启动前初始化、信号捕获处理终止前清理，以及外部系统承担停止后清理任务。

docker 容器本身没有内置的生命周期钩子机制（比如 pre-start、post-stop、on-health-fail 等），不像 kubernetes 有 lifecycle.prestop 或 initcontainers，也不像 systemd 有 execstartpre。这是很多开发者初学时容易误解的一点：误以为 dockerfile 或 docker run 能直接定义“容器启动前执行什么”“停止前清理什么”。

但实际项目中，确实存在对这些阶段的控制需求。解决方案不是靠 Docker 原生钩子，而是通过组合 ENTRYPOINT、信号处理、外部编排工具或包装脚本实现等效效果。下面从最常用、最落地的三个阶段讲起：

启动前初始化（相当于 “pre-start”）

容器启动时，往往需要做配置生成、环境校验、依赖服务探活、密钥注入等操作，这些不能放在 CMD 里（因为 CMD 是主进程，一退出容器就死），也不能用 RUN（构建时执行，运行时无效）。

✅ 推荐做法：用 entrypoint.sh 脚本封装

Dockerfile 中写：

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]
CMD ["your-app", "--port", "8080"]

entrypoint.sh 内容示例：

#!/bin/sh
set -e

# 检查必要环境变量
[ -z "$DB_HOST" ] && echo "ERROR: DB_HOST is required" && exit 1

# 等待数据库就绪（可选）
until nc -z $DB_HOST 5432; do sleep 2; done

# 生成配置文件
envsubst  /app/config.yaml

# 执行真正的 CMD（即主应用）
exec "$@"

⚠️ 关键点：exec "$@" 不仅传递参数，更关键的是用主进程替换当前 shell 进程，保证应用 PID=1，能正确接收 SIGTERM。

运行中优雅终止（相当于 “pre-stop”）

Docker 发送 SIGTERM 给 PID=1 进程后，容器默认等待 10 秒（可调），再发 SIGKILL 强杀。如果主进程不处理 SIGTERM，就会硬退出，导致连接未关闭、事务中断、临时文件残留。

✅ 推荐做法：主进程显式捕获信号 + 延迟退出

Learn Docker

通过 LabEx 容器基础课程和镜像/编排实验学习 Docker。Docker 课程和实验通过 LabEx MCP 获取，返回 labex.io 链接以继续。

下载

应用代码中监听 SIGTERM（如 Node.js 的 process.on('SIGTERM')，Python 的 signal.signal(signal.SIGTERM, ...)）

或在 entrypoint.sh 中用 trap 包一层（适合无法改代码的二进制）：

cleanup() {
  echo "Running cleanup..."
  # 比如 flush 日志、关闭连接池、删除锁文件
  rm -f /tmp/app.lock
}
trap cleanup SIGTERM SIGINT

exec "$@"

✅ 补充建议：

启动容器时加 --stop-timeout=30 给足清理时间
避免在应用里忽略 SIGTERM 或用 nohup/& 启动子进程（会导致 PID≠1，信号收不到）

停止后清理（相当于 “post-stop”）

Docker 容器一旦退出，所有内存和进程空间销毁，宿主机上无法自动触发“容器停了之后执行某命令”——因为容器进程已不存在。所以“post-stop”逻辑必须由外部系统承担。

✅ 可行方案：

Docker Compose v2.23+ 支持 profiles 和 depends_on.condition: service_stopped，但不支持 post-hook → 实际不可用
真正可靠的方式是：把清理动作移到容器外
- 用 docker-compose down 后手动执行清理脚本
- 在 CI/CD 流水线中，docker stop 后调用 docker exec -it myapp sh -c 'rm -rf /tmp/cache'（仅当容器未完全退出时有效）
- 更健壮的做法：将状态/缓存持久化到挂载卷（-v /host/clean-dir:/app/data），由宿主机定时清理，或由下一个容器启动时判断并清理旧数据