xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 10 Pull Requests 3 Actions 4 Packages Projects Releases 7 Wiki Activity

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

Merged
xiaoxia merged 4 commits from feat/staging-healthcheck-ci-v2 into develop 2026-07-14 23:36:51 +08:00
Conversation 2 Commits 4 Files Changed 4
+505 -4
xiaoxia commented 2026-07-14 16:33:26 +08:00
Owner
Copy Link
Copy Source

变更内容

新增文件

  • scripts/ci_staging_healthcheck.sh - CI专用健康检查+自动回滚脚本（适配Watchtower模式）
  • scripts/deploy_notify.py - 部署结果通知脚本（飞书卡片格式，支持 success/failure/rollback 三种状态）

修改文件

  • .gitea/workflows/ci-cd.yml - deploy-staging阶段的smoke test替换为健康检查+自动回滚

功能说明

健康检查

  • 检查 API /health 端点
  • 检查 Web 首页
  • 检查 API /docs 文档端点
  • 检查登录 API（业务逻辑验证）
  • 超时时间：120秒（含Watchtower等待90秒+健康检查轮询）

自动回滚

  • 部署前记录当前 :staging 镜像的 digest
  • 健康检查失败时，自动把 :staging tag 改回旧版本
  • Watchtower 检测到 tag 变化后自动回滚
  • 回滚后再次验证健康状态

通知机制

  • 通过 CI_NOTIFY_WEBHOOK 发送飞书卡片通知
  • 支持三种状态：成功 / 失败 / 已回滚
  • 包含分支、commit、构建详情链接

环境变量依赖

  • REGISTRY_TOKEN - 已有，回滚操作镜像推送需要
  • CI_NOTIFY_WEBHOOK - 通知用，未配置则自动跳过（不影响部署）

验证

  • PR CI全绿（Validate/Unit/Integration/Frontend Lint都过）
  • develop合并后第一次部署，验证健康检查通过
  • 模拟失败场景，验证自动回滚（后续P2）
## 变更内容 ### 新增文件 - `scripts/ci_staging_healthcheck.sh` - CI专用健康检查+自动回滚脚本（适配Watchtower模式） - `scripts/deploy_notify.py` - 部署结果通知脚本（飞书卡片格式，支持 success/failure/rollback 三种状态） ### 修改文件 - `.gitea/workflows/ci-cd.yml` - deploy-staging阶段的smoke test替换为健康检查+自动回滚 ## 功能说明 ### 健康检查 - 检查 API `/health` 端点 - 检查 Web 首页 - 检查 API `/docs` 文档端点 - 检查登录 API（业务逻辑验证） - 超时时间：120秒（含Watchtower等待90秒+健康检查轮询） ### 自动回滚 - 部署前记录当前 `:staging` 镜像的 digest - 健康检查失败时，自动把 `:staging` tag 改回旧版本 - Watchtower 检测到 tag 变化后自动回滚 - 回滚后再次验证健康状态 ### 通知机制 - 通过 `CI_NOTIFY_WEBHOOK` 发送飞书卡片通知 - 支持三种状态：成功 / 失败 / 已回滚 - 包含分支、commit、构建详情链接 ## 环境变量依赖 - `REGISTRY_TOKEN` - 已有，回滚操作镜像推送需要 - `CI_NOTIFY_WEBHOOK` - 通知用，未配置则自动跳过（不影响部署） ## 验证 - [ ] PR CI全绿（Validate/Unit/Integration/Frontend Lint都过） - [ ] develop合并后第一次部署，验证健康检查通过 - [ ] 模拟失败场景，验证自动回滚（后续P2）
auto-approve-bot approved these changes 2026-07-14 18:33:53 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
auto-approve-bot approved these changes 2026-07-14 18:36:45 +08:00
xiaoxia closed this pull request 2026-07-14 21:33:43 +08:00
xiaoxia deleted branch feat/staging-healthcheck-ci-v2 2026-07-14 21:33:43 +08:00
xiaoxia reopened this pull request 2026-07-14 21:34:55 +08:00
xiaoxia added 4 commits 2026-07-14 22:51:02 +08:00
feat(ci): 新增Staging健康检查脚本 e45426fe7d
feat(ci): 新增部署通知脚本 7407ec2957
feat(ci): deploy-staging接入健康检查+自动回滚 9501afe9b3
ci: re-trigger CI run after cache cleanup
CI/CD Pipeline / Unit Tests (pull_request) Successful in 2m50s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 3m14s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 3m16s
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m24s
Details
CI/CD Pipeline / Unit Tests (push) Successful in 1m47s
Details
CI/CD Pipeline / Validate Code Quality And Tests (push) Successful in 2m31s
Details
CI/CD Pipeline / Frontend Lint (push) Successful in 2m57s
Details
CI/CD Pipeline / Build Production API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Production (push) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (push) Has been skipped
Details
CI/CD Pipeline / Integration Tests (push) Successful in 1m14s
Details
CI/CD Pipeline / Build Staging Web Image (push) Successful in 2m52s
Details
CI/CD Pipeline / Build Staging API Image (push) Successful in 5m16s
Details
CI/CD Pipeline / Build Staging Worker Image (push) Successful in 22m32s
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (push) Successful in 1m48s
Details
CI/CD Pipeline / Staging API Integration Tests (push) Successful in 4m6s
Details
CI/CD Pipeline / Staging E2E Tests (push) Failing after 4m57s
Details
84db18a959
xiaoxia force-pushed feat/staging-healthcheck-ci-v2 from c9863f3546 to 84db18a959 2026-07-14 22:51:02 +08:00 Compare
xiaoxia merged commit 84db18a959 into develop 2026-07-14 23:36:51 +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
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#323
Delete Branch "feat/staging-healthcheck-ci-v2"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?