灰度流量管理

v3.0.0+

tcb cloudrun traffic 命令自 v3.0.0 起提供。

使用 tcb cloudrun traffic 命令可以管理云托管服务的版本流量分配，实现灰度发布、流量切换、发布完成和回滚等操作。

查看当前流量配置

tcb cloudrun traffic -e <envId> -s <serviceName>

设置灰度流量

将指定比例的流量切到灰度版本：

# 稳定版 90%，灰度版 10%
tcb cloudrun traffic -e <envId> -s <serviceName> --stable 90 --canary 10

命令参数：

参数	说明
-s, --serviceName <name>	服务名称（不填时从 cloudbaserc.json 读取或交互输入）
--stable <n>	稳定版本流量比例（0-100，stable + canary = 100）
--canary <n>	灰度版本流量比例（0-100，stable + canary = 100）
-e, --env-id <envId>	环境 ID

注意

--stable 与 --canary 的值之和必须等于 100。

完成灰度（全量发布）

将灰度版本升为稳定版，灰度流量切到 100%：

tcb cloudrun traffic promote -e <envId> -s <serviceName>

回滚发布

回滚当前发布，流量切回稳定版本：

tcb cloudrun traffic rollback -e <envId> -s <serviceName>

典型灰度发布流程

# 1. 部署新版本（发布为灰度版本）
tcb cloudrun deploy -e <envId> -s my-service

# 2. 分配 10% 流量到灰度版本，验证稳定性
tcb cloudrun traffic -e <envId> -s my-service --stable 90 --canary 10

# 3a. 验证通过 → 全量发布
tcb cloudrun traffic promote -e <envId> -s my-service

# 3b. 验证失败 → 回滚
tcb cloudrun traffic rollback -e <envId> -s my-service