如何通过DockerStop优雅停机技术实现生产环境应用无损发布

小伟大大_1554

小伟大大_1554

2026-05-02

344人浏览

原创

无损发布需应用、容器、负载均衡协同:应用响应SIGTERM并降级就绪状态,容器配置确保信号直达且设合理宽限期,LB短周期健康检查并及时摘流。

要实现生产环境应用无损发布,docker stop 本身不是终点,而是协同链中的一环。真正“无损”的核心在于:在容器停止前,让流量彻底不再进入,同时给应用留足时间处理完存量请求并完成清理。这需要应用、容器配置、负载均衡三者对齐信号与状态。

应用层必须响应 SIGTERM 并主动降级就绪状态

收到 SIGTERM 后,应用不能只关服务,还要快速通知上游“我不再可用了”:

  • 立即关闭监听端口(如 HTTP server.close()),拒绝新连接
  • 设置 /readyz 或 /healthz 接口返回 503(而非 200),触发 LB 快速摘流
  • 等待活跃请求自然结束,超时建议设为 20–45 秒(如 Go 的 srv.Shutdown(ctx)、Spring Boot 的 spring.lifecycle.timeout-per-shutdown-phase)
  • 执行数据库连接释放、缓存刷新、临时文件清理等收尾逻辑

容器运行时需确保信号直达且不被拦截

如果 PID 1 是 shell,SIGTERM 就会卡住——应用根本收不到:

  • Dockerfile 中必须用 exec 格式启动:CMD ["java", "-jar", "app.jar"],而非 CMD java -jar app.jar
  • 若需 shell 环境(如环境变量预处理),应在 ENTRYPOINT 前引入 tini:ENTRYPOINT ["/sbin/tini", "--"]
  • 启动容器时显式延长宽限期:docker run --stop-timeout=45 ... 或 Compose 中写 stop_grace_period: 45s
  • Kubernetes 场景下,terminationGracePeriodSeconds 应 ≥ stop-timeout,并配 readinessProbe 失败后立即生效

负载均衡必须短周期感知并剔除节点

LB 不知道容器要停,就不会自动切走流量——这是无损最关键的外部依赖:

Docker Encyclopedia
Docker Encyclopedia

Docker 文档优先工作流:针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载
  • 健康检查间隔 ≤ 3 秒,失败阈值设为 1~2 次(避免延迟摘流)
  • Nginx 可配 max_fails=1 fail_timeout=3s + 自定义 health_check 指向 /readyz
  • 若使用注册中心(如 Nacos),应用收到 SIGTERM 后应主动注销实例
  • 滚动更新时,严格按“先调 LB 下线 → 等 1~2 次健康检查确认无流量 → 再 docker stop”顺序执行

验证是否真正无损的关键指标

别只看容器退出码,要从全链路观察:

  • 容器日志末尾出现 received SIGTERM、shutting down、all requests completed 等字样
  • 退出码为 0(非 137,137 表示被 SIGKILL 强杀)
  • LB 访问日志中,在容器停止前 3 秒内已无新请求打到该实例
  • 监控系统显示该实例的 active request 数在收到信号后平滑归零,无突降或报错激增

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

765

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6119

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

7197

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2833

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

319

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

471

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

440

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

325

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

505

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习