Zookeeper

Zookeeper 注册中心的基本使用和工作原理。

1 前置条件

2 使用说明

在此查看完整示例代码

2.1 增加 Maven 依赖

  1. <properties>
  2. <dubbo.version>3.0.8</dubbo.version>
  3. </properties>
  4. <dependencies>
  5. <dependency>
  6. <groupId>org.apache.dubbo</groupId>
  7. <artifactId>dubbo</artifactId>
  8. <version>${dubbo.version}</version>
  9. </dependency>
  10. <!-- This dependency helps to introduce Curator and Zookeeper dependencies that are necessary for Dubbo to work with zookeeper as transitive dependencies -->
  11. <dependency>
  12. <groupId>org.apache.dubbo</groupId>
  13. <artifactId>dubbo-dependencies-zookeeper</artifactId>
  14. <version>${dubbo.version}</version>
  15. <type>pom</type>
  16. </dependency>
  17. </dependencies>

dubbo-dependencies-zookeeper 将自动为应用增加 Zookeeper 相关客户端的依赖,减少用户使用 Zookeeper 成本,如使用中遇到版本兼容问题,用户也可以不使用 dubbo-dependencies-zookeeper,而是自行添加 Curator、Zookeeper Client 等依赖。

由于 Dubbo 使用 Curator 作为与 Zookeeper Server 交互的编程客户端,因此,要特别注意 Zookeeper Server 与 Dubbo 版本依赖的兼容性

Zookeeper Server 版本Dubbo 版本Dubbo Zookeeper 依赖包说明
3.4.x 及以下3.0.x 及以上dubbo-dependencies-zookeeper传递依赖 Curator 4.x 、Zookeeper 3.4.x
3.5.x 及以上3.0.x 及以上dubbo-dependencies-zookeeper-curator5传递依赖 Curator 5.x 、Zookeeper 3.7.x
3.4.x 及以上2.7.x 及以下dubbo-dependencies-zookeeper传递依赖 Curator 4.x 、Zookeeper 3.4.x
3.5.x 及以上2.7.x 及以下须自行添加 Curator、Zookeeper 等相关客户端依赖

2.2 配置并启用 Zookeeper

  1. # application.yml
  2. dubbo
  3. registry
  4. address: zookeeper://localhost:2181

  1. # dubbo.properties
  2. dubbo.registry.address=zookeeper://localhost:2181

  1. <dubbo:registry address="zookeeper://localhost:2181" />

address 是启用 zookeeper 注册中心唯一必须指定的属性,而在生产环境下,address 通常被指定为集群地址,如

address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181

protocol 与 address 分开配置的模式也可以,如

<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />

3 高级配置

3.1 认证与鉴权

如果 Zookeeper 开启认证,Dubbo 支持指定 username、password 的方式传入身份标识。

  1. # application.yml
  2. dubbo
  3. registry
  4. address: zookeeper://localhost:2181
  5. username: hello
  6. password: 1234

也可以直接将参数扩展在 address 上 address=zookeeper://hello:1234@localhost:2181

3.2 分组隔离

通过指定 group 属性,可以在同一个 Zookeeper 集群内实现微服务地址的逻辑隔离。比如可以在一套集群内隔离出多套开发环境,在地址发现层面实现隔离。

  1. # application.yml
  2. dubbo
  3. registry
  4. address: zookeeper://localhost:2181
  5. group: daily1

3.3 其他扩展配置

配置连接、会话过期时间

  1. # application.yml
  2. dubbo
  3. registry
  4. address: zookeeper://localhost:2181
  5. timeout: 30 * 1000* # 连接超时时间,默认 30s
  6. session: 60 * 1000* # 会话超时时间,默认 60s

Zookeeper 注册中心还支持其他一些控制参数,具体可参见Registry 配置项手册

4 工作原理

4.1 Dubbo2 节点结构

/user-guide/images/zookeeper.jpg

流程:

  • 服务提供者启动时: 向 /dubbo/com.foo.BarService/providers 目录下写入自己的 URL 地址。
  • 服务消费者启动时: 订阅 /dubbo/com.foo.BarService/providers 目录下的提供者 URL 地址。并向 /dubbo/com.foo.BarService/consumers 目录下写入自己的 URL 地址
  • 监控中心启动时: 订阅 /dubbo/com.foo.BarService 目录下的所有提供者和消费者 URL 地址。

支持以下功能:

  • 当提供者出现断电等异常停机时,注册中心能自动删除提供者信息
  • 当注册中心重启时,能自动恢复注册数据,以及订阅请求
  • 当会话过期时,能自动恢复注册数据,以及订阅请求
  • 当设置 <dubbo:registry check="false" /> 时,记录失败注册和订阅请求,后台定时重试
  • 可通过 <dubbo:registry username="admin" password="1234" /> 设置 zookeeper 登录信息
  • 可通过 <dubbo:registry group="dubbo" /> 设置 zookeeper 的根节点,不配置将使用默认的根节点。
  • 支持 * 号通配符 <dubbo:reference group="*" version="*" />,可订阅服务的所有分组和所有版本的提供者

4.2 Dubbo3 节点结构

最后修改 December 16, 2022: Fix check (#1736) (97972c1)