程序员如何做「灰度发布」：不是冒险，是可控

新版本上线最怕什么？

直接全量发布，出问题就回滚不回来。

灰度发布让风险可控。

---

一、什么是灰度发布

灰度发布（Canary Release）是将新版本逐步放量，从少量用户到全部用户。

就像煤矿里的金丝雀——先试试，有问题及早发现。

---

二、灰度发布的策略

1. 按用户比例

• 5% → 10% → 30% → 100%
• 风险低，速度慢

2. 按地域

• 先小城市，再大城市
• 符合数据合规要求

3. 按用户标签

• 白名单用户
• VIP 用户（服务好客户）
• 新用户（影响小）

4. 按功能开关

• 只开放新功能给部分用户
• 不影响整体

---

三、灰度发布的步骤

1. 准备

• 功能开关准备好
• 监控指标定义好
• 回滚方案准备好

2. 灰度

• 放 5% 流量
• 监控关键指标

3. 观察

• 错误率
• 响应时间
• 业务指标（下单量、转化率）

4. 决策

• 指标正常 → 继续放量
• 指标异常 → 回滚

5. 全量

• 100% 流量
• 观察一段时间

---

四、灰度发布的关键

1. 快速回滚

出问题能在 5 分钟内回滚。

2. 指标监控

灰度期间要实时看指标，不能放着不管。

3. 自动化

不要手动切流量，用自动化工具。

---

五、常用工具

1. Nginx

upstream backend {
    server old-v1:8080;
    server new-v2:8080 weight=5;
}

2. Kubernetes

• Canary Deployment
• Argo Rollouts

3. Spring Cloud Gateway

• 配置路由权重

4. 商业方案

• Argo Rollouts
• Flagger

---

六、一句话总结

灰度发布 = 小流量放量 + 实时监控 + 快速回滚 + 逐步全量。