Zookeeper

Zookeeper 配置中心的基本使用和工作原理。

1 前置条件

2 使用说明

在此查看完整示例代码

2.1 增加 Maven 依赖

如果项目已经启用 Zookeeper 作为注册中心，则无需增加任何额外配置。

如果未使用 Zookeeper 注册中心，则请参考 为注册中心增加 Zookeeper 相关依赖。

2.2 启用 Zookeeper 配置中心

  1. <dubbo:config-center address="zookeeper://127.0.0.1:2181"/>

或者

  1. dubbo
  2.   config-center
  3.     address: zookeeper://127.0.0.1:2181

或者

  1. dubbo.config-center.address=zookeeper://127.0.0.1:2181

或者

  1. ConfigCenterConfig configCenter = new ConfigCenterConfig();
  2. configCenter.setAddress("zookeeper://127.0.0.1:2181");

address 格式请参考 zookeeper 注册中心 - 启用配置

3 高级配置

如要开启认证鉴权，请参考 zookeeper 注册中心 - 启用认证鉴权

3.1 定制外部化配置 key

1. 启用外部化配置，并指定 key

  1. dubbo
  2.   config-center
  3.     address: zookeeper://127.0.0.1:2181
  4.     config-file: dubbo.properties

config-file - 外部化配置文件 key 值，默认 dubbo.properties。config-file 代表将 Dubbo 配置文件存储在远端注册中心时，文件在配置中心对应的 key 值，通常不建议修改此配置项。

2. Zookeeper 配置中心增加配置 外部化配置的存储结构如下图所示

zk-configcenter.jpg

  • namespace，用于不同配置的环境隔离。
  • config，Dubbo约定的固定节点，不可更改，所有配置和流量治理规则都存储在此节点下。
  • dubbo 与 application，分别用来隔离全局配置、应用级别配置：dubbo 是默认 group 值，application 对应应用名
  • dubbo.properties，此节点的node value存储具体配置内容

这里是为了说明工作原理，建议使用 dubbo-admin 进行配置管理。

3.2 设置 group 与 namespace

  1. dubbo
  2.   config-center
  3.     address: zookeeper://127.0.0.1:2181
  4.     group: dubbo-cluster1
  5.     namespace: dev1

对配置中心而言，group 与 namespace 应该是全公司（集群）统一的，应该避免不同应用使用不同的值，外部化配置和治理规则也应该存放在对应的 group 与 namespace。

4 流量治理规则

所有流量治理规则默认都存储在 /dubbo/config 节点下，具体节点结构图如下。流量治理规则的增删改建议通过 dubbo-control-plane（dubbo-admin） 完成，更多内容可查看 Dubbo 支持的具体流量治理能力

zk-configcenter-governance

  • namespace，用于不同配置的环境隔离。
  • config，Dubbo 约定的固定节点，不可更改，所有配置和流量治理规则都存储在此节点下。
  • dubbo，所有服务治理规则都是全局性的，dubbo 为默认节点
  • configurators/tag-router/condition-router/migration，不同的服务治理规则类型，node value 存储具体规则内容

最后修改 September 13, 2024: Refactor website structure (#2860) (1a4b998f54b)