← ClaudeAtlas

deployment-verificationlisted

当用户要求"部署/上线/发版/deploy/release/验证"时触发。 MUST 执行部署前检查 + 健康检查 + 回滚预案。 生产操作 MUST 用户确认。
structure-projects/structure-agent-rules · ★ 1 · AI & Automation · score 64
Install: claude install-skill structure-projects/structure-agent-rules
# 部署验证 > 部署到目标环境并验证。生产操作 MUST 用户确认。 ## 前置条件(MUST 全部满足) 1. **CI 通过**:ci-gate 全部检查通过 2. **变更提案存在**:`changes/proposals/<current>/proposal.md` 存在 3. **changelog 已更新**:`changelog/<version>.md` 含本次变更条目 4. **版本号已升级**:pom.xml / package.json 版本号符合语义化版本 ## 执行步骤 ### 第 1 步:部署前检查 ```bash # 确认 changelog cat changes/changelog/<version>.md # 确认版本号 grep version pom.xml # 或 package.json # 确认数据库迁移脚本(如有) ls db/migration/ # 确认配置变更(如有) git diff master...HEAD -- "**/application*.yaml" "**/*.env*" ``` ### 第 2 步:执行部署 按部署 Wiki 执行(平台差异): - K8s:`kubectl apply -f ...` - Docker:`docker compose up -d` - 传统主机:`systemctl restart ...` **MUST 用户确认生产部署命令后再执行**。 ### 第 3 步:健康���查(MUST 全部通过) | 检查项 | 方式 | 通过标准 | |---|---|---| | 服务存活 | HTTP `/health` / TCP 端��� | 200 OK / 端口可达 | | 关键接口冒烟 | 调用核心 API | 返回正确响应 | | 日志无 ERROR | `kubectl logs` / `tail -f` | 无新 ERROR | | 监控指标正常 | Prometheus / Grafana | QPS / 延迟 / 错误率在阈值内 | ### 第 4 步:写入部署验证报告 写入 `changes/proposals/<current>/deployment.md`: ```markdown # 部署验证报告 | 字段 | 值 | |---|---| | 部署时间 | YYYY-MM-DD HH:MM | | 部署环境 | staging / production | | 版本 | X.Y.Z | | 部署人 | <user> | ## 健康检查 - [ ] 服务存活 - [ ] 关键接口冒烟 - [ ] 日志无 ERROR - [ ] 监控指标正常 ## 结论 ✅ 部署成功 / ❌ 部署失败(原因 + 回滚操作) ``` ### 第 5 步:失败时回滚 回滚触发条件: - 健康检查任一失败 - 关键指标异常 - 用户手动触发 回滚步骤: 1. 回滚到上一个稳定版本 2. 验证回滚后服务正常 3. 在 proposal 中记录失败原因 4. 触发 hotfix 流程(如需要) ## 完成标准 - 部署成功 - 健康检查全部通过 - 部署验证报告写入 proposal - changelog 已更新 ## 下一步 - 成功 → 归档变更提案到 `changes/archive/` - 失败 → 回滚 + 触发 hotfix 流程 ## 关联 - 前置:`ci-gate` - 后续