作者介绍

程露，Java 开发工程师，中间件开发爱好者，关注服务治理。严浩，Dubbo 贡献者，关注 RPC、服务治理等领域。

前言

Dubbo 相信大家并不陌生，是一款微服务开发框架，它提供了 RPC 通信与微服务治理两大关键能力。大家在日常开发中更多使用的是 dubbo 提供的 RPC 通信这一部分能力，而对其提供的服务治理的能力使用相对少一些，本文的重点将放在服务治理这方面。dubbo 框架提供了极其丰富的服务治理的功能如流量控制、动态配置、服务 Mock、服务测试等功能，而 dubbo-admin 的作用在于将 dubbo 框架提供的服务治理能力提供一个开箱即用的平台。本文将介绍 dubbo-admin 所提供的功能，让大家快速了解和使用 dubbo-admin 并对 dubbo 所提供的服务治理能力有个初步的了解。

服务详情

服务详情将以接口为维度展示 dubbo 服务所提供的服务信息，包含服务提供者、消费者信息和服务的元数据信息比如提供的方法名和参数列表。在最新版本支持了 dubbo 3.0 所提供的应用级发现模型，在注册来源用 应用级/接口级 进行区分。

动态路由

Dubbo-Admin 提供了三种路由的支持，分别是条件路由、标签路由、Mesh 路由，所提供的功能可以轻松实现黑白名单、集群隔离、金丝雀发布等服务治理的诉求。下面将举例一一展示这一部分的功能。

条件路由

条件路由可以编写一些自定义路由规则实现服务治理的需求比如黑白名单、读写分离等。路由规则在发起一次 RPC 调用前起到过滤目标服务器地址的作用，过滤后的地址列表，将作为消费端最终发起 RPC 调用的备选地址。

下图为一个简单的黑名单功能的实现，该路由规则的含义为禁止 IP 为 172.22.3.91 消费者调用服务 HelloService，条件路由规则的格式为：[服务消费者匹配条件] => [服务提供者匹配条件]。

标签路由

标签路由通过将某一个或多个服务的提供者划分到同一个分组，约束流量只在指定分组中流转，从而实现流量隔离的目的，可以作为蓝绿发布、灰度发布等场景的能力基础。在 provider 应用级别上创建规则，对应的静态打标为 dubbo.provider.tag=tag1 和 @DubboService(tag = "tag2")。

Mesh 路由

Mesh 路由是 dubbo 3.0 推出的全新的路由规则功能极其强大，使用 mesh 路由能够覆盖上诉两种路由的功能场景，并且还可以组合出更加复杂路由场景。

Mesh 路由将整个流量管理分成 VirtualService 和 DestinationRule 两部分，VirtualService 匹配入口流量，DestinationRule 匹配出口流量。下面将实现一个案例，通过对服务 HelloService 的 hi 方法通过入参 number 进行路由，实现入参为偶数的请求路由到 label 为 v1 的服务，入参为奇数的服务路由到 label 为 v2 的服务的功能。

​public interface HelloService {​​ ​​ String hi(Integer number);​​​​​}​

​服务实现返回服务提供方端口。

​​public class HelloServiceImpl implements HelloService {​​​​​​​​​​ @Value("${dubbo.protocol.port}")​​​​ private String port;​​​​​​​​​​ @Override​​​​ public String hi(Integer number) {​​​​​​​​​​ return "hi " + number + ", my port is :" + port;​​​​ }​​​​}​​

第一步：启动两个服务提供方参数分别为 port = 20883 、dubbo.application.parameters.test-version = v1 和 port = 20884 、dubbo.application.parameters.test-version = v2，通过 dubbo.application.parameters 定义的参数将会暴露到服务的 URL 上。

​dubbo.application.parameters.test-version = v1​​dubbo.protocol.port=20883​

第二步：创建 mesh 路由规则，该路由规则定义了 VirtualService、DestinationRule 两部分。DestinationRule 部分将服务 URL 参数 test-version=v1 和 test-version=v2 分别划分为服务 v1 和 v2。VirtualService 则将匹配服务 HelloService#hi 方法的入参，将偶数路由到 v1 服务，奇数路由到 label 为 v2 的服务。

​apiVersion: service.dubbo.apache.org/v1alpha1​​kind: VirtualService​​metadata:​​ name: demo/oddEvenRouter​​spec:​​ dubbo:​​ - routedetail:​​ - match:​​ - method:​​ argc: 1​​ args:​​ - index: 0​​ num_value:​​ oneof:​​ - exact: 0.0​​ mod: 2.0​​ type: int​​ name_match:​​ exact: hi​​ name: even-route​​ route:​​ - destination:​​ host: demo​​ subset: v1​​ - match:​​ - method:​​ argc: 1​​ args:​​ - index: 0​​ num_value:​​ oneof:​​ - exact: 1.0​​ mod: 2.0​​ type: int​​ name_match:​​ exact: hi​​ name: odd-route​​ route:​​ - destination:​​ host: demo2​​ subset: v2 ​​ services:​​ - exact: org.test.apache.dubbo.interfaces.HelloService ​​---​​apiVersion: service.dubbo.apache.org/v1alpha1​​kind: DestinationRule​​metadata:​​ name: test-route​​spec:​​ host: demo​​ subsets:​​ - name: v1​​ labels:​​ test-version: v1​​ - name: v2​​ labels:​​ test-version: v2​

第三步：启动消费者进行测试，可以看见返回结果如我们期待的那样，通过上诉案例实现了一个简单的灰度功能，当然也可以轻松实现 A/B 测试、金丝雀发布等功能。

动态配置

动态配置提供了无须重启可以动态调整 RPC 调用行为的一种能力。比如修改超时时间、权重、负载均衡策略调整、服务降级等。避免了为了调整 Dubbo 参数而需要重启服务的局面，下面将展示一些常见的参数调整情况。

1. 超时时间调整，超时时间调整为 6000 ms

​configVersion: v2.7​​enabled: true​​configs: ​​ - addresses: [0.0.0.0] # 0.0.0.0 for all addresses​​ side: consumer # effective side, consumer or addresses​​ parameters: ​​ timeout: 6000 # dynamic config parameter​

1. 权重调整

​configVersion: v2.7​​scope: application​​key: demo-provider​​enabled: true​​configs:​​- addresses: ["10.20.153.10:20880"]​​ side: provider​​ parameters:​​ weight: 200​

1. 负载策略调整

​configVersion: v2.7​​scope: application​​key: demo-consumer​​enabled: true​​configs:​​- side: consumer​​ parameters:​​ loadbalance: random​

文档与测试

接口文档

Dubbo-Api-Docs 是一个展示 dubbo 接口文档，测试接口的工具，相当于 swagger 对于 RESTful 风格的 Web 服务的作用。使用该功能需要 dubbo 服务引入相关包 dubbo-api-docs-annotations 和 dubbo-api-docs-core，使用使用通过注解的形式描述接口和参数信息。

​<dependency>​​ <groupId>org.apache.dubbo</groupId>​​ <artifactId>dubbo-api-docs-annotations</artifactId>​​ <version>${dubbo-version}</version>​​</dependency>​

​<dependency>​​ <groupId>org.apache.dubbo</groupId>​​ <artifactId>dubbo-api-docs-core</artifactId>​​ <version>${dubbo-version}</version>​​</dependency>​

效果图如下

服务测试

服务测试相比 dubbo-api-docs 不需要引入任何依赖就能对 dubbo 服务进行测试，方便快速调整和验证 dubbo 服务，效果图如下：

服务 Mock

服务 Mock 通过无代码嵌入的方式将 Consumer 对 Provider 的请求进行拦截，动态的对 Consumer 的请求进行放行或返回用户自定义的 Mock 数据。从而解决在前期开发过程中，Consumer 所依赖的 Provider 未准备就绪时，造成 Consumer 开发方的阻塞问题。

只需要以下两步，即可享受服务 Mock 功能带来的便捷：

第一步：Consumer 应用引入服务 Mock 依赖，添加 JVM 启动参数-Denable.dubbo.admin.mock=true 开启服务 Mock 功能。

​<denpendency>​​ <groupId>org.apache.dubbo.extensions</groupId>​​ <artifactId>dubbo-mock-admin</artifactId>​​ <version>last</version>​​</denpendency>​

第二步：在 Dubbo Admin 中配置对应的 Mock 数据。

小结

本文介绍了 dubbo-admin 的大部分功能，覆盖开发、测试和线上整个阶段。希望本文能够给使用和入手 dubbo- admin 带来一些帮助，详细的使用细节还需要参考官网，也希望 dubbo-admin 能够给 dubbo 使用者带来一个全新的体验，更方便快速的使用 dubbo 所提供出来服务治理的能力。