deployment-strategy

部署策略

概述

涵盖部署策略选择、回滚安全性和渐进式交付模式。重点关注零停机发布技术、影响范围管理，以及从开发到生产的环境晋级工作流。

适用场景： 在蓝绿、金丝雀或滚动部署之间进行选择，实施回滚流程，配置健康检查和就绪门控，规划环境晋级工作流，集成功能标志以实现渐进式交付。

不适用场景： CI/CD 流水线机制和 GitHub Actions 工作流（使用 ci-cd-architecture skill）、基础设施预配和云平台选择（使用 ci-cd-architecture skill）、应用架构决策（使用特定框架的 skill）。

快速参考

需求	策略
即时回滚	蓝绿（将流量切回之前的环境）
逐步验证风险	金丝雀（路由 1-5% 的流量，监控后再扩大范围）
Kubernetes 默认更新	滚动（使用 maxSurge/maxUnavail 逐步替换 Pod）
完全替换环境	重建（停止所有旧实例，再启动所有新实例；接受短暂停机）
功能级控制	功能标志（将部署与发布解耦）
数据库架构变更	扩展-收缩迁移（先添加，之后再移除）
多环境晋级	dev -> staging -> production，每个阶段之间都设置门控
缩小影响范围	金丝雀 + 功能标志 + 自动回滚触发器
健康状态验证	在基础设施层配置存活、就绪和启动探针
无需重新部署即可回滚	使用功能标志禁用有问题的代码路径

常见错误

错误	正确做法
部署前没有回滚计划	定义回滚流程，并在每次生产发布前验证流程有效
应用部署时同时执行破坏性数据库迁移	使用扩展-收缩模式：先添加新列/新表，迁移数据，之后再移除旧内容
金丝雀部署没有自动健康监控	设置错误率和延迟阈值，超过阈值时自动暂停发布
蓝绿部署共用可变数据库	使用向后兼容的架构变更，确保两个版本都能使用同一数据库
功能标志没有清理生命周期	为每个标志指定负责人和移除日期；将过期标志视为技术债务
跳过 staging，直接部署到 production	通过环境逐级晋级，并在每个阶段之间设置自动门控
滚动部署没有就绪探针	配置就绪探针，确保流量只路由到健康实例
所有阶段使用相同的环境配置	使用特定于环境的配置，并为每个环境进行密钥管理
事件响应中的回滚流程依赖手动操作	根据错误率、延迟和健康检查阈值自动触发回滚
发布前只测试正常路径	包含故障场景测试：回滚演练、混沌测试、降级模式测试

委派

• 审计现有基础设施的部署安全性：使用 Explore Agent 检查部署配置、健康检查定义和回滚流程
• 实施特定的部署策略：使用 Task Agent 为目标平台配置蓝绿、金丝雀或滚动部署
• 规划从一种部署策略迁移到另一种策略：使用 Plan Agent 评估当前策略、制定迁移步骤并识别风险

如果有 ci-cd-architecture 技能，请将 CI/CD 流水线搭建和 GitHub Actions 工作流配置委派给该技能。 否则，建议使用：npx skills add oakoss/agent-skills --skill ci-cd-architecture

参考资料

• 蓝绿、金丝雀、滚动和重建部署策略及配置示例
• 回滚流程、健康检查、功能标志和爆炸半径管理
• 环境晋级工作流、配置管理和密钥处理