deployment-procedures

name	deployment-procedures
description	生产环境部署原则与决策（Deployment procedures）。安全部署工作流、回滚策略与验证。强调思考而非背脚本。
allowed-tools	Read, Glob, Grep, Bash

部署规程

生产环境发布的部署原则与决策逻辑。 学习如何思考（THINK），而非死记硬背脚本。

---

[WARN] 如何使用此技能

此技能传授的是部署原则，不是可盲目复制的脚本。

• 每次部署都有差异
• 理解每一步背后的原因
• 根据平台实际情况调整流程

---

1. 平台选择

决策树

What are you deploying?
|
+-- Static site / JAMstack
|   +-- Vercel, Netlify, Cloudflare Pages
|
+-- Simple web app
|   +-- Managed -> Railway, Render, Fly.io
|   +-- Control -> VPS + PM2/Docker
|
+-- Microservices
|   +-- Container orchestration
|
+-- Serverless
    +-- Edge functions, Lambda

不同平台有不同规程

平台	部署方式
Vercel/Netlify	Git push（代码推送）自动部署
Railway/Render	Git push 或 CLI
VPS + PM2	SSH + 手动步骤
Docker	镜像推送 + 编排
Kubernetes	kubectl apply

---

2. 部署前原则

四大验证类别

类别	检查项
代码质量	测试通过、Lint 清理完成、已评审
构建（Build）	生产构建成功、无告警
环境	环境变量已设置、凭据已更新
安全性	已备份、回滚方案就绪

部署前检查清单

• 所有测试通过
• 代码已评审并批准
• 生产构建成功
• 环境变量已核验
• 数据库迁移已就绪（如有）
• 回滚方案已记录
• 已通知团队
• 监控已就绪

---

3. 部署工作流原则

5 阶段流程

1. PREPARE
   +-- Verify code, build, env vars

2. BACKUP
   +-- Save current state before changing

3. DEPLOY
   +-- Execute with monitoring open

4. VERIFY
   +-- Health check, logs, key flows

5. CONFIRM or ROLLBACK
   +-- All good? Confirm. Issues? Rollback.

阶段原则

阶段	原则
准备	绝不部署未经测试的代码
备份	没有备份就无法回滚
部署	观察过程，不要中途走开
验证	宁可怀疑，务必验证
确认	随时准备触发回滚

---

4. 部署后验证

验证内容

检查项	为什么要查
健康端点（Health）	确认服务正常运行
错误日志	确认无新增错误
核心业务流	确保关键功能正常
性能	响应时间可接受

验证时间窗口

• 首个 5 分钟：主动监控
• 15 分钟：确认稳定
• 1 小时：最终验证
• 次日：复审指标

---

5. 回滚原则

何时回滚

现象	行动建议
服务宕机	立即回滚
严重错误	回滚
性能下降超过 50%	考虑回滚
细微问题	可快速修复则向前修复

不同平台的回滚策略

平台	回滚方式
Vercel/Netlify	重新部署之前的提交
Railway/Render	控制面板回滚
VPS + PM2	还原备份并重启
Docker	使用之前的镜像标签
K8s	kubectl rollout undo

回滚原则

1. 速度优于完美：先回滚，再调试
2. 不要复合错误：只做一次回滚，不叠加变更
3. 沟通：告知团队发生了什么
4. 复盘（Post-mortem）：稳定后再追因

---

6. 零停机部署

核心策略

策略	工作原理
滚动更新（Rolling）	逐个替换实例
蓝绿部署（Blue-Green）	在不同环境间切换流量
金丝雀发布（Canary）	逐步转移流量

选择原则

场景	对应策略
标准发布	滚动更新
高风险变更	蓝绿部署（易回滚）
需要验证	金丝雀发布（真实流量验证）

---

7. 应急响应程序

服务宕机优先级

1. 评估（Assess）：现象是什么？
2. 快速修复：若原因不明，先重启
3. 回滚：重启无效则立即回滚
4. 调查：稳定后深入分析

调查顺序

检查项	常见问题
日志	错误、异常信息
系统资源	磁盘空间满、内存不足
网络	DNS 问题、防火墙拦截
依赖项	数据库异常、API 故障

---

8. 反模式

[FAIL] 禁止	[OK] 推荐
周五部署	周初部署
仓促部署	遵循流程
跳过预发布环境（Staging）	始终先测试
部署前不备份	部署前必备份
部署完立即走开	监控至少 15 分钟
同时进行多项变更	每次只做一项

---

9. 决策检查清单

在部署之前：

• 是否选择了适用于该平台的规程？
• 备份策略是否就绪？
• 回滚计划是否记录？
• 监控是否已配置？
• 是否已通知团队？
• 是否预留了监控时间？

---

10. 最佳实践

1. 小步快跑：高频小规模部署
2. 功能开关（Feature flags）：高风险变更用开关控制
3. 自动化：重复步骤自动化
4. 记录：记录每次部署过程
5. 复审：问题发生后复盘
6. 演练回滚：在需要前先验证回滚

---

谨记： 部署本身有风险，降低风险靠充分准备而非速度。