灰度发布

CloudBase 云函数支持多版本管理功能，通过灰度发布能力可以调整不同版本间的请求流量比例，实现线上业务的平滑过渡、灰度验证和快速回滚，确保业务发布的稳定性和安全性。

核心概念​

版本管理​

每个云函数可以发布多个版本，版本是函数在特定时刻的完整快照，包含：

• 函数代码
• 配置信息（超时时间、环境变量、内存规格等）
• 运行时环境

LATEST 版本​

云函数始终存在一个 LATEST 版本，代表最新版本。当您上传、更新或部署云函数代码时，都是在修改 LATEST 版本。

流量分配​

您可以精确控制不同版本云函数的流量比例，CloudBase 会根据设定的比例自动分发请求流量到对应版本。

一致性保证​

CloudBase 使用用户的全局唯一标识来保证请求的一致性：

• 有用户信息的请求：同一用户的所有请求会始终路由到同一个版本，确保用户体验的一致性
• 无用户信息的请求：采用随机调度策略进行流量分配

灰度发布流程​

推荐流程​

操作指南​

创建版本​

1. 进入 云函数管理页面
2. 选择需要进行灰度发布的函数
3. 在「灰度配置」模块中，点击「发布新版本」

4. 输入版本描述信息，确认发布

⚠️ 注意：版本发布后，该版本的代码和配置将被锁定，无法再次修改。

配置流量比例​

在灰度配置页面中，可以实时调整不同版本的流量分配比例：

⚠️ 注意：流量比例调整后会立即生效，请谨慎操作并及时验证效果。

最佳实践​

首次灰度发布​

对于从未使用过灰度功能的云函数，推荐按以下步骤操作：

1. 发布基准版本

   当前状态：只有 LATEST 版本（100% 流量）
   操作：发布版本 1，设置版本 1 流量为 100%
   

2. 部署新功能

   当前状态：版本 1（100% 流量），LATEST（0% 流量）
   操作：在 LATEST 版本中部署新功能代码
   

3. 开始灰度

   设置流量分配：LATEST（10%），版本 1（90%）
   结果：10% 用户体验新功能，90% 用户使用稳定版本
   

版本回滚与全量发布​

快速回滚​

当发现新版本存在问题时，可以快速将流量切回稳定版本：

紧急回滚：将稳定版本流量设置为 100%，问题版本流量设置为 0%

全量发布​

当新版本验证通过后，可以进行全量发布：

全量发布：将新版本流量设置为 100%，旧版本流量设置为 0%

灰度策略建议​