jenkins pipeline 实现优雅停机更新的核心是协同控制服务生命周期：旧实例须在进程终止前主动调用 nacos api 注销，再以 sigterm 触发 spring boot 优雅停机；pipeline 需等待 nacos 实例下线及客户端缓存刷新（≈2×健康检查间隔+心跳超时）后，再验证新服务 /actuator/health 就绪并切流，全程嵌入超时与自动回滚机制。
Jenkins Pipeline 实现优雅停机更新，核心不是“立刻杀死旧服务”，而是让旧实例主动退场、新实例平稳接棒。这需要在 Pipeline 中嵌入对服务生命周期的精细控制，尤其在 Spring Boot + Nacos 这类微服务场景下，必须协同注册中心行为与进程管理策略。
明确服务摘除时机
旧服务不能等进程退出后再通知 Nacos，而应在收到终止信号前主动注销。Pipeline 部署阶段需调用 Nacos OpenAPI（如 DELETE /nacos/v1/ns/instance），传入服务名、IP、端口和集群信息，强制从注册表中移除该实例。这一步要早于 kill 或 systemctl stop，避免注册信息残留导致流量误打。
用 SIGTERM 替代 SIGKILL
Jenkins 执行脚本时，应使用 kill -15 ${PID} 或 systemctl stop myapp.service（确保 service 文件中配置了 KillSignal=SIGTERM）。Spring Boot 默认监听 SIGTERM，会触发 SmartLifecycle 关闭逻辑、执行 @PreDestroy 方法、等待正在处理的 HTTP 请求自然完成（配合 server.shutdown=graceful 和 spring.lifecycle.timeout-per-shutdown-phase=30s）。
插入合理等待窗口
摘除注册 + 优雅停机 ≠ 立刻安全启动新服务。Pipeline 必须等待两个关键状态收敛：
- Nacos 健康检查确认旧实例已下线（可通过轮询
/nacos/v1/ns/instances?serviceName=xxx判断列表中是否消失） - 其他服务本地负载均衡器（如 Spring Cloud LoadBalancer）缓存刷新完成（等待时间 ≈
2 × 健康检查间隔 + 心跳超时，例如 Nacos 默认是 2×5s + 15s = 25s）
可写成 Shell 函数封装等待逻辑，失败则中断部署。
新服务就绪再切流
新服务启动后，不能一启动就开放流量。Pipeline 应调用其 /actuator/health 或自定义 /ready 端点，持续探测直到返回 status: UP 且所有依赖（DB、Redis、下游服务）探活通过，再允许网关或 Ingress 将流量导入。
回滚路径必须前置设计
优雅停机失败（如旧服务卡死、新服务健康检查不通过）时，Pipeline 不能停滞。应在每个关键步骤后设置 timeout 和 catchError，自动触发回滚：恢复旧服务进程、重新注册到 Nacos、验证其可用性。回滚操作本身也需幂等，避免二次故障。
本质上，优雅停机更新是把一次“粗暴替换”拆解为带状态感知的多步协同——Jenkins Pipeline 提供编排能力，而真正起作用的是你写进每个 step 里的业务语义：何时摘注册、如何发信号、等什么条件、验什么指标。
