feat(ci): Production部署接入健康检查+自动回滚框架 #325

Merged

xiaoxia merged 3 commits from feat/production-healthcheck into develop 2026-07-15 00:34:23 +08:00

Conversation 1 Commits 3 Files Changed 3

+630 -32

xiaoxia commented 2026-07-14 16:55:34 +08:00

Owner

Copy Link

Copy Source

变更内容

1. 新增 scripts/ci_production_healthcheck.sh（Production专用健康检查+自动回滚）

• 公网视角健康检查：API /health + Web首页 + API /docs + 登录API（期望401/422），超时180秒
• 自动回滚机制：部署前记录当前运行的镜像版本，健康检查失败时通过SSH重新部署旧版本
• 回滚后验证：回滚完成后重新检查健康状态，确认服务恢复
• 飞书通知：success / failure / rollback 三种状态卡片通知

2. 升级 scripts/deploy_notify.py

• 新增 --env 参数支持 staging / production 两种环境
• 卡片显示环境标识和对应访问链接
• 版本号支持 tag 显示（v0.1.xxx 格式）

3. 修改 ci-cd.yml deploy-production 阶段

• 新增 Checkout 步骤获取脚本
• 新增 Health check + auto rollback 步骤（部署后自动检查，不健康自动回滚）
• 成功通知由健康检查脚本发出（更详细的卡片）
• 失败兜底通知升级为 deploy_notify.py 卡片格式，且检测标记文件避免重复通知
• timeout 从 20 分钟调整为 25 分钟（预留健康检查+回滚时间）

设计说明

• Production 采用 SSH 直连部署模式，与 Staging 的 Watchtower 模式不同
• 回滚方式：通过 SSH 在生产服务器上重新拉取旧版本镜像并重启容器（不执行 migration 回滚）
• 注意：migration 不可回滚（新版本可能新增字段/表），回滚后旧代码仍可兼容（需确保 migration 是增量的、向前兼容的）

关联任务

• 生产环境部署升级：健康检查+回滚方案从Staging同步到Production
• 部署通知从占位改为实际可用的飞书卡片通知

## 变更内容 ### 1. 新增 `scripts/ci_production_healthcheck.sh`（Production专用健康检查+自动回滚） - **公网视角健康检查**：API /health + Web首页 + API /docs + 登录API（期望401/422），超时180秒 - **自动回滚机制**：部署前记录当前运行的镜像版本，健康检查失败时通过SSH重新部署旧版本 - **回滚后验证**：回滚完成后重新检查健康状态，确认服务恢复 - **飞书通知**：success / failure / rollback 三种状态卡片通知 ### 2. 升级 `scripts/deploy_notify.py` - 新增 `--env` 参数支持 staging / production 两种环境 - 卡片显示环境标识和对应访问链接 - 版本号支持 tag 显示（v0.1.xxx 格式） ### 3. 修改 `ci-cd.yml` deploy-production 阶段 - 新增 Checkout 步骤获取脚本 - 新增 Health check + auto rollback 步骤（部署后自动检查，不健康自动回滚） - 成功通知由健康检查脚本发出（更详细的卡片） - 失败兜底通知升级为 deploy_notify.py 卡片格式，且检测标记文件避免重复通知 - timeout 从 20 分钟调整为 25 分钟（预留健康检查+回滚时间） ### 设计说明 - Production 采用 SSH 直连部署模式，与 Staging 的 Watchtower 模式不同 - 回滚方式：通过 SSH 在生产服务器上重新拉取旧版本镜像并重启容器（不执行 migration 回滚） - 注意：migration 不可回滚（新版本可能新增字段/表），回滚后旧代码仍可兼容（需确保 migration 是增量的、向前兼容的） ### 关联任务 - 生产环境部署升级：健康检查+回滚方案从Staging同步到Production - 部署通知从占位改为实际可用的飞书卡片通知

auto-approve-bot approved these changes 2026-07-14 20:02:00 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia closed this pull request 2026-07-14 21:34:13 +08:00

xiaoxia deleted branch feat/production-healthcheck 2026-07-14 21:34:13 +08:00

xiaoxia reopened this pull request 2026-07-14 21:34:56 +08:00

xiaoxia force-pushed feat/production-healthcheck from 1704a75084 to f36d6e5c40 2026-07-14 22:51:09 +08:00 Compare

xiaoxia force-pushed feat/production-healthcheck from f36d6e5c40 to 107c4457df 2026-07-15 00:18:37 +08:00 Compare

xiaoxia added 3 commits 2026-07-15 00:31:16 +08:00

feat(ci): 新增Production健康检查+自动回滚脚本 df016b18fb

feat(ci): 升级部署通知脚本，卡片格式与CI通知对齐 ed3ab34028

feat(ci): deploy-production接入健康检查+自动回滚 62ab361940

xiaoxia force-pushed feat/production-healthcheck from 107c4457df to 62ab361940 2026-07-15 00:31:16 +08:00 Compare

xiaoxia merged commit 62ab361940 into develop 2026-07-15 00:34:23 +08:00

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#325