扩展Zuul实现敏捷开发的小小技巧

分析下目前遇到的痛点

你在开发工做的是否遇到这个问题，微服务模块划分过细，基础模块依赖的比较多？
好比你要进行微服务开发则须要启动如下基础模块

• 注册中心（eureka）
• 配置中心（spring cloud config）
• 网关（zuul）
• 认证中心（oauth）
• ...
  如上图红色标注的服务模块，而你须要编码或者须要的只有那么一个业务微服务模块，本地启动这么微服务模块对开发机器的要求性能较高，而且影响开发效率。
  为了解决这种问题，团队通常都会把通用的基础模块部，提供统一的开发环境，方便你们开发，如上图 只须要考虑你的业务模块（serviceA、serviceB） 便可，提升开发效率。
  这种统一开发基础环境问题存在小小的问题，好比当开发A维护serviceA，开发B维护serviceB 不会出现冲突；若是开发A、B同时维护一个模块时候，就会出现冲突以下图所示：A的本地请求会被路由到B正在开发的biz-service,而不是目标的A的biz-service，由于zuul 是更具服务名称进行路由的

  

解决原理

重写网关的转发规则，其实就是重写ribbon的路由规则，根据客户端不一样的用户请求（能够根据入参不一样区分）路由到对应的微服务上，因此对应的微服务上要打上标签。biz-service A开发版本，biz-service B开发版本

代码实现

1. 在微服务的eureka客户端声明版本所属

eureka:
  instance:
    metadata-map: 
      version: v1.0 # A的开发版本
复制代码

2. 自定义ribbon 的断言

/**
 * @author lengleng
 * @date 2018/10/16
 * <p>
 * 路由微服务断言
 * <p>
 * 1. eureka metadata 存在版本定义时候进行判断
 * 2. 不存在 metadata 直接返回true
 */
@Slf4j
public class MetadataCanaryRuleHandler extends ZoneAvoidanceRule {

    @Override
    public AbstractServerPredicate getPredicate() {
        return new AbstractServerPredicate() {
            @Override
            public boolean apply(PredicateKey predicateKey) {
                String targetVersion = RibbonVersionHolder.getContext();
                RibbonVersionHolder.clearContext();
                if (StrUtil.isBlank(targetVersion)) {
                    log.debug("客户端未配置目标版本直接路由");
                    return true;
                }

                DiscoveryEnabledServer server = (DiscoveryEnabledServer) predicateKey.getServer();
                final Map<String, String> metadata = server.getInstanceInfo().getMetadata();
                if (StrUtil.isBlank(metadata.get(SecurityConstants.VERSION))) {
                    log.debug("当前微服务{} 未配置版本直接路由");
                    return true;
                }

                if (metadata.get(SecurityConstants.VERSION).equals(targetVersion)) {
                    return true;
                } else {
                    log.debug("当前微服务{} 版本为{}，目标版本{} 匹配失败", server.getInstanceInfo().getAppName()
                            , metadata.get(SecurityConstants.VERSION), targetVersion);
                    return false;
                }
            }
        };
    }
}

复制代码

3. 版本上下文TTL

public class RibbonVersionHolder {
    private static final ThreadLocal<String> context = new TransmittableThreadLocal<>();


    public static String getContext() {
        return context.get();
    }

    public static void setContext(String value) {
        context.set(value);
    }

    public static void clearContext() {
        context.remove();
    }
}

复制代码

4. 初始化ribbon 路由配置

@Configuration
@ConditionalOnClass(DiscoveryEnabledNIWSServerList.class)
@AutoConfigureBefore(RibbonClientConfiguration.class)
@ConditionalOnProperty(value = "zuul.ribbon.metadata.enabled")
public class RibbonMetaFilterAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    @Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
    public ZoneAvoidanceRule metadataAwareRule() {
        return new MetadataCanaryRuleHandler();
    }
}

复制代码

5. 客户端调用时 header 传入版本，以 axios 为例

axios.interceptors.request.use(config => {
  NProgress.start() // start progress bar
  if (store.getters.access_token) {
    config.headers['Authorization'] = 'Bearer ' + token
    config.headers['version'] = 'v1.0'  // 开发人员本身的版本标志，对应eureka metadata 配置
  }
  return config
}
复制代码

总结

1. 扩展ribbon 的路由规则，根据客户端来去不一样版本的服务，也能够理解为灰度发布。

2. 生产环境能够借助Kong、Traefik 集合zuul 来实现灰度发布

3. 代码请参考微服务权限框架pig的灰度发布功能，已经所有开源

4. 关于pig：
   基于Spring Cloud、oAuth2.0开发基于Vue先后分离的开发平台，支持帐号、短信、SSO等多种登陆，提供配套视频开发教程。
   gitee.com/log4j/pig