动态路由

当前支持针对 dubbogo 消息的以下内容进行动态路由:

消息类型dubbo消息内容路由规则请求类型
消息头attachment请求头(HEADER)
RPC方法method路径(PATH)

环境准备

参考 dubbogo 官网文档

dubbogo.yaml 配置文件

  1. dubbo:
  2. registries:
  3. polaris-1:
  4. protocol: polaris
  5. address: ${北极星服务端IP}:8091
  6. namespace: ${北极星命名空间信息}
  7. token: ${北极星资源鉴权 token} # 如果北极星服务端开启了针对客户端的鉴权,则需要配置该参数

说明:

  • 在使用动态路由能力时,需要先启用 Polaris 在 dubbogo 中的注册发现功能。

如何配置服务路由参数

dubbogo 中的 PolarisMesh PriorityRouter 扩展点实现,能够根据用户配置的服务路由规则,自动的从当前 RPC 调用上下文以及请求信息中识别出需要参与服务路由的请求标签信息。

假定一个场景:

  • 希望 uid 为 user-1 的请求,路由到 environment 标签为 pre 的实例上
  • 希望 uid 为 user-2 的请求,路由到 environment 标签为 dev 的实例上
  • 其他则路由到 environment 标签为 prod 的实例上,那可以为 dubbogo 服务设置三条路由规则。

    动态路由 - 图1 动态路由 - 图2 动态路由 - 图3

  • 请求匹配规则为 请求参数(QUERY)

    • 标签来源: RPC 调用中方法的入参,即 Invoaction.Arguments()
    • 标签键规则
      • 方法仅有一个入参: param.$.${fieldName}, param. 为固定前缀,后面的表达式为标准的 JSONPath expressions,参考文档
      • 方法有多个参数: param[${index}].$.${fieldName}, param[${index}]. 为固定前缀,${index} 代表是方法入参中的第几个参数,下标起始位置从 0 开始;后面的表达式为标准的 JSONPath expressions,参考文档
  • 请求匹配规则为 请求头(HEADER):
    • 标签来源: RPC 调用的额外标签信息,即 Invoaction.Attachments()

示例代码(dubbogo 原生使用方式)

  1. func (s *Service) GetUser(uid string) {
  2. atta := make(map[string]interface{})
  3. atta["uid"] = uid
  4. // 通过这种方式往 attachement 传入路由条件
  5. reqContext := context.WithValue(context.Background(), constant.DubboCtxKey("attachment"), atta)
  6. for i := 0; i < 5; i++ {
  7. time.Sleep(200 * time.Millisecond)
  8. user, err := userProvider.GetUser(reqContext, &User{Name: "Alex001"})
  9. if err != nil {
  10. logger.Errorf("error: %v\n", err)
  11. }
  12. logger.Infof("response: %v\n", user)
  13. }
  14. }

验证

可根据 dubbogo example 开展