03-灰度发布详解

灰度发布详解一、知识概述灰度发布（Canary Release）是一种降低发布风险的发布策略，通过逐步放量的方式，先让小部分用户使用新版本，观察无问题后再逐步扩大范围，最终完成全量发布。核心目标：降低发布风险快速发现问题平滑过渡支持快速回滚对比传统发布：发布方式风险回滚速度用户影响直接发布高慢全量蓝绿发布中快瞬间切换灰度发布低快渐进式二、知识点详细讲解2.1 灰度发布策略2.1.1 基于权重的灰度┌─────────────────────────────────────────────────────┐ │ 基于权重的流量切分 │ ├─────────────────────────────────────────────────────┤ │ │ │ ┌─────────┐ │ │ │ 用户 │ │ │ └────┬────┘ │ │ │ │ │ ┌───────┴───────┐ │ │ │ 负载均衡 │ │ │ └───────┬───────┘ │ │ │ │ │ ┌────────────┼────────────┐ │ │ ↓ ↓ ↓ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 旧版本 │ │ 灰度版本│ │ 旧版本 │ │ │ │ 90% │ │ 10% │ │ │ │ │ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ 灰度步骤：10% → 30% → 50% → 100% │ └─────────────────────────────────────────────────────┘/** * 权重路由服务 */@ServicepublicclassWeightRoutingService{// 灰度配置privatevolatileGrayConfiggrayConfig=GrayConfig.builder().enabled(true).grayWeight(10)// 10%流量.grayVersion("v2.0.0").stableVersion("v1.0.0").build();/** * 根据权重决定路由 */publicStringroute(LonguserId){if(!grayConfig.isEnabled()){returngrayConfig.getStableVersion();}// 基于用户ID哈希 + 权重判断inthash=Math.abs(userId.hashCode()%100);if(hashgrayConfig.getGrayWeight()){returngrayConfig.getGrayVersion();}returngrayConfig.getStableVersion();}/** * 更新灰度权重 */publicvoidupdateWeight(intnewWeight){if(newWeight0||newWeight100){thrownewIllegalArgumentException("权重必须在0-100之间");}grayConfig=GrayConfig.builder().enabled(grayConfig.isEnabled()).grayWeight(newWeight).grayVersion(grayConfig.getGrayVersion()).stableVersion(grayConfig.getStableVersion()).build();log.info("灰度权重更新: {}%",newWeight);}}2.1.2 基于规则的灰度┌─────────────────────────────────────────────────────┐ │ 基于规则的流量切分 │ ├─────────────────────────────────────────────────────┤ │ │ │ 规则类型： │ │ ┌─────────────────────────────────────────────┐ │ │ │ 1. 用户ID白名单 │ │ │ │ - 内部员工 │ │ │ │ - 种子用户 │ │ │ │ │ │ │ │ 2. 用户标签 │ │ │ │ - VIP用户 │ │ │ │ - 新注册用户 │ │ │ │ │ │ │ │ 3. 地理位置 │ │ │ │ - 特定城市 │ │ │ │ - 海外用户 │ │ │ │ │ │ │ │ 4. 设备类型 │ │ │ │ - iOS / Android │ │ │ │ - 新版App │ │ │ └─────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────┘/** * 规则路由服务 */@ServicepublicclassRuleRoutingService{@AutowiredprivateUserServiceuserService;// 灰度规则配置privatevolatileListGrayRulegrayRules=Arrays.asList(GrayRule.builder().type(RuleType.USER_ID).values(Arrays.asList("10001","10002","10003"))// 白名单.version("v2.0.0").build(),GrayRule.builder().type(RuleType.USER_TAG).values(Arrays.asList("VIP","INTERNAL")).version("v2.0.0").build(),GrayRule.builder().type(RuleType.CITY).values(Arrays.asList("北京","上海")).version("v2.0.0").build());/** * 根据规则决定路由 */publicStringroute(LonguserId,Stringcity,StringdeviceType){Useruser=userService.getById(userId);// 遍历规则，按优先级匹配for(GrayRulerule:grayRules){if(matchRule(rule,user,city,deviceType)){log.info("用户命中灰度规则: userId={}, rule={}",userId,rule);returnrule.getVersion();}}// 默认走稳定版本return"v1.0.0";}/** * 匹配规则 */privatebooleanmatchRule(GrayRulerule,Useruser,Stringcity,StringdeviceType){switch(rule.getType()){caseUSER_ID:returnrule.getValues().contains(user.getId().toString());caseUSER_TAG:returnuser.getTags().stream().anyMatch(rule.getValues()::contains);caseCITY:returnrule.getValues().contains(city);caseDEVICE_TYPE:returnrule.getValues().contains(deviceType);default:returnfalse;}}}2.2 灰度发布流程2.2.1 完整发布流程┌────────────────────────────────────────────────────────┐ │ 灰度发布流程 │ ├────────────────────────────────────────────────────────┤ │ │ │ 1. 准备阶段 │ │ ├── 代码审查 │ │ ├── 自动化测试 │ │ ├── 性能测试 │ │ └── 制定回滚计划 │ │ │ │ 2. 部署阶段 │ │ ├── 部署灰度环境 │ │ ├── 配置灰度规则 │ │ └── 开始灰度（1%） │ │ │ │ 3. 观察阶段 │ │ ├── 监控错误率 │ │ ├── 监控性能指标 │ │ ├── 收集用户反馈 │ │ └── 逐步扩大（1%→5%→10%→30%→50%→100%） │ │ │ │ 4. 完成/回滚 │ │ ├── 无异常 → 全量发布 │ │ └── 有问题 → 快速回滚 │ │ │ └────────────────────────────────────────────────────────┘2.2.2 灰度控制器/** * 灰度发布控制器 */@RestController@RequestMapping("/gray")publicclassGrayReleaseController{@AutowiredprivateGrayReleaseServicegrayReleaseService;@AutowiredprivateMonitoringServicemonitoringSe