This is an automated email from the ASF dual-hosted git repository.
albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new 4cb9a3fa7c [fix] 优化 Zookeeper (#1193)
4cb9a3fa7c is described below
commit 4cb9a3fa7c568fdcfcbd5cfcfda4a2c05712df41
Author: JIAN ZHONG <[email protected]>
AuthorDate: Tue Jul 5 17:20:47 2022 +0800
[fix] 优化 Zookeeper (#1193)
---
.../reference-manual/registry/zookeeper/guide.md | 50 ++++++++++++----------
1 file changed, 28 insertions(+), 22 deletions(-)
diff --git
a/content/zh/docs3-building/java-sdk/reference-manual/registry/zookeeper/guide.md
b/content/zh/docs3-building/java-sdk/reference-manual/registry/zookeeper/guide.md
index 5e4123f03a..a55affe4c4 100644
---
a/content/zh/docs3-building/java-sdk/reference-manual/registry/zookeeper/guide.md
+++
b/content/zh/docs3-building/java-sdk/reference-manual/registry/zookeeper/guide.md
@@ -4,17 +4,15 @@ title: "使用说明"
linkTitle: "使用说明"
weight: 2
---
-
-
+## 特性说明
[Zookeeper](http://zookeeper.apache.org) 是 Apache Hadoop
的子项目，是一个树型的目录服务，支持变更推送，适合作为 Dubbo 服务的注册中心，工业强度较高，可用于生产环境，并推荐使用 [^1]。
-流程说明：
-
-* 服务提供者启动时: 向 `/dubbo/com.foo.BarService/providers` 目录下写入自己的 URL 地址
+流程：
+* 服务提供者启动时: 向 `/dubbo/com.foo.BarService/providers` 目录下写入自己的 URL 地址。
* 服务消费者启动时: 订阅 `/dubbo/com.foo.BarService/providers` 目录下的提供者 URL 地址。并向
`/dubbo/com.foo.BarService/consumers` 目录下写入自己的 URL 地址
-* 监控中心启动时: 订阅 `/dubbo/com.foo.BarService` 目录下的所有提供者和消费者 URL 地址。
+* 监控中心启动时: 订阅 `/dubbo/com.foo.BarService` 目录下的所有提供者和消费者 URL 地址。
支持以下功能：
@@ -26,10 +24,12 @@ weight: 2
* 可通过 `<dubbo:registry group="dubbo" />` 设置 zookeeper 的根节点，不配置将使用默认的根节点。
* 支持 `*` 号通配符 `<dubbo:reference group="*" version="*" />`，可订阅服务的所有分组和所有版本的提供者
-## 使用
+## 使用场景
+## 使用方式
-在 provider 和 consumer 中增加 zookeeper 客户端 jar 包依赖：
+ provider 和 consumer 中增加 zookeeper 客户端 jar
包依赖或直接[下载](https://repo1.maven.org/maven2/org/apache/zookeeper/zookeeper)。
+在 provider 和 consumer 中增加 zookeeper 客户端 jar 包依赖：
```xml
<dependency>
<groupId>org.apache.zookeeper</groupId>
@@ -37,14 +37,16 @@ weight: 2
<version>3.8.0</version>
</dependency>
```
-
-或直接[下载](http://repo1.maven.org/maven2/org/apache/zookeeper/zookeeper)。
-
+#### 说明
Dubbo 支持 zkclient 和 curator 两种 Zookeeper 客户端实现：
-**注意:在2.7.x的版本中已经移除了zkclient的实现,如果要使用zkclient客户端,需要自行拓展**
+**在2.7.x的版本中已经移除了zkclient的实现,如果要使用zkclient客户端,需要自行拓展**
+
+客户端：
+- curator 客户端
+- zkclient 客户端
-### 使用 zkclient 客户端
+#### 使用 zkclient 客户端
从 `2.2.0` 版本开始缺省为 zkclient 实现，以提升 zookeeper
客户端的健壮性。[zkclient](https://github.com/sgroschupf/zkclient) 是 Datameer 开源的一个
Zookeeper 客户端实现。
@@ -66,7 +68,7 @@ dubbo.registry.client=zkclient
zookeeper://10.20.153.10:2181?client=zkclient
```
-需依赖或直接[下载](http://repo1.maven.org/maven2/com/github/sgroschupf/zkclient)：
+需依赖或直接[下载](https://repo1.maven.org/maven2/com/github/sgroschupf/zkclient)：
```xml
<dependency>
@@ -75,9 +77,7 @@ zookeeper://10.20.153.10:2181?client=zkclient
<version>0.11</version>
</dependency>
```
-
-
-### 使用 curator 客户端
+#### 使用 curator 客户端
从 `2.3.0` 版本开始支持可选 curator 实现。[Curator](https://github.com/apache/curator) 是
Netflix 开源的一个 Zookeeper 客户端实现。
@@ -122,6 +122,9 @@ zookeeper://10.20.153.10:2181?client=curator
<version>${curator.version}</version>
</dependency>
```
+Zookeeper 配置
+- 单机配置
+- 集群配置
Zookeeper 单机配置:
@@ -148,23 +151,26 @@ Zookeeper 集群配置：
<dubbo:registry protocol="zookeeper"
address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />
```
-同一 Zookeeper，分成多组注册中心:
+同一 Zookeeper 分成多组注册中心:
```xml
<dubbo:registry id="chinaRegistry" protocol="zookeeper"
address="10.20.153.10:2181" group="china" />
<dubbo:registry id="intlRegistry" protocol="zookeeper"
address="10.20.153.10:2181" group="intl" />
```
-## zookeeper 安装
+#### zookeeper 安装
-安装方式参见: [Zookeeper安装手册](../../../../docsv2.7/admin/install/zookeeper)，只需搭一个原生的
Zookeeper 服务器，并将 [Quick Start](../../../quick-start) 中 Provider 和 Consumer 里的
`conf/dubbo.properties` 中的 `dubbo.registry.address` 的值改为
`zookeeper://127.0.0.1:2181` 即可使用。
+安装 [Zookeeper安装手册](../../../docsv2.7/admin/install/zookeeper)，只需搭一个原生的
Zookeeper 服务器，并将 [Quick Start](../../../quick-start) 中 Provider 和 Consumer 里的
`conf/dubbo.properties` 中的 `dubbo.registry.address` 的值改为
`zookeeper://127.0.0.1:2181` 即可使用。
+声明类型：
+- 可靠性
+- 兼容性
-## 可靠性声明
+#### 可靠性声明
阿里内部并没有采用 Zookeeper 做为注册中心，而是使用自己实现的基于数据库的注册中心，即：Zookeeper
注册中心并没有在阿里内部长时间运行的可靠性保障，此 Zookeeper 桥接实现只为开源版本提供，其可靠性依赖于 Zookeeper 本身的可靠性。
-## 兼容性声明
+#### 兼容性声明
因 `2.0.8` 最初设计的 zookeeper 存储结构不能扩充不同类型的数据，`2.0.9` 版本做了调整，所以不兼容，需全部改用 `2.0.9`
版本才行，以后的版本会保持兼容 `2.0.9`。`2.2.0` 版本改为基于 zkclient 实现，需增加 zkclient 的依赖包，`2.3.0`
版本增加了基于 curator 的实现，作为可选实现策略。
