Docker 容器生命周期钩子如何用

Docker 本身不提供原生 postStart/preStop 钩子，但可通过自定义 ENTRYPOINT 脚本实现启动前初始化、HEALTHCHECK 指令模拟探针、信号捕获（trap TERM）实现终止前清理，以及外部事件监听或 CI/CD 协同完成等效钩子功能。

Docker 本身不提供像 Kubernetes 那样的原生 postStart 或 preStop 钩子，但可以通过几种成熟、轻量、可落地的方式，在关键生命周期节点执行自定义逻辑。核心原则是：把钩子逻辑“嵌入”到容器启动和退出流程中，而不是等待 Docker 主动回调。

启动前做初始化（类 pre-start）

这是最常用也最可靠的钩子场景。目标是在主应用进程启动前，完成配置准备、依赖探活、目录创建等操作。

1. 用 ENTRYPOINT 指向一个 shell 脚本（如 entrypoint.sh），脚本里先执行初始化逻辑，再用 exec "$@" 启动原始 CMD
2. 初始化内容常见包括：
   1. 创建 /config/log 等持久化目录
   2. 生成 machine-id 或密钥文件
   3. 等待数据库、Redis 等依赖服务就绪（例如 while ! nc -z db 5432; do sleep 1; done）
   4. 渲染配置模板（如用 envsubst 替换环境变量）
3. 注意：脚本末尾必须用 exec，否则主进程变成子进程，容器可能提前退出

运行中做健康判断（类 liveness/readiness）

Docker 没有内置探针，但可通过 HEALTHCHECK 指令实现等效效果：

1. 在 Dockerfile 中添加：

   HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 CMD curl -f http://localhost:8080/health || exit 1

2. 容器运行后，Docker 引擎会定期执行该命令，并更新 docker inspect <name> --format='{{.State.Health.Status}}' 的结果
3. 应用内需暴露 /health 端点，返回 HTTP 200 表示就绪；也可用 tcp-connect 或 pg_isready 等命令替代

终止前做清理（类 pre-stop）

关键在于捕获 SIGTERM 并阻塞退出，直到清理完成：

1. 在 entrypoint.sh 或应用代码中设置信号处理器：

   cleanup() {echo "Shutting down gracefully..."# 关闭连接、刷盘、上报状态等exit 0}trap cleanup TERM INT

2. 主进程必须前台运行（不能加 & 或 nohup），否则信号无法送达
3. 清理逻辑别超时——Docker 默认 10 秒后强制 SIGKILL，所以耗时操作建议异步触发+快速返回

外部协同式钩子（适合编排或运维场景）

当单容器内逻辑太重或需跨容器联动时，可借助外部机制：

1. 用 docker events --filter 'event=start' --filter 'event=stop' 监听事件，配合脚本触发备份、告警、注册注销等
2. 在 CI/CD 流水线中，docker run 前后插入 shell 步骤，比如启动前 dump 数据库、停止后推送日志
3. Docker Compose 支持 on-create、pre-start、post-start 等钩子（通过 x-harness 或第三方插件），适合多服务协同初始化

不复杂但容易忽略