首页/开发/CI/CD 与发布速查/按 header / cookie 的定向灰度
发布策略60 条

按 header / cookie 的定向灰度

权重之外的精确分流:用 header、cookie 把内部人员与尝鲜用户先导到新版本,再叠加权重放量给普通用户。

CI/CD 与发布速查开发更新于 2026-10-12
载体x-canary header / canary cookie
命中对象内部团队、邀请用户、特定客户端
与权重关系定向命中优先,其余按权重
退场全量后删除定向规则

分流示意

分流示意
内部用户:x-canary: true → 新版本 100%
普通用户:按权重 5% → 新版本
先让团队在日常使用中走过新版本,再打开权重放量:早期问题的反馈成本更低。

易错点

  • 依赖 cookie 但不考虑无 cookie 流量(爬虫、直连):实际比例与配置不符
  • 定向规则长期不清理:新老行为分叉长期存在,测试矩阵被拖大

数据来源与参考

  • Ingress-NGINX 文档《Canary Deployments》
  • Istio 文档《VirtualService》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌