This is an automated email from the ASF dual-hosted git repository.
liubao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-docs.git
The following commit(s) were added to refs/heads/master by this push:
new d984182 add documents for zookeeper (#325)
d984182 is described below
commit d984182c1d512ca146b7b87c668175b08004c3ce
Author: liubao68 <[email protected]>
AuthorDate: Tue Apr 16 16:24:22 2024 +0800
add documents for zookeeper (#325)
---
java-chassis-reference/zh_CN/docs/config/apollo.md | 27 +++
.../zh_CN/docs/config/config-service.md | 185 ---------------------
java-chassis-reference/zh_CN/docs/config/cse1.md | 40 +++++
.../zh_CN/docs/config/general-config.md | 4 +-
java-chassis-reference/zh_CN/docs/config/kie.md | 54 ++++++
java-chassis-reference/zh_CN/docs/config/nacos.md | 50 ++++++
.../zh_CN/docs/config/zookeeper.md | 83 +++++++++
.../zh_CN/docs/registry/nacos.md | 4 +-
.../zh_CN/docs/registry/service-center.md | 4 +-
.../zh_CN/docs/registry/zookeeper.md | 57 +++++++
java-chassis-reference/zh_CN/mkdocs.yml | 11 +-
11 files changed, 326 insertions(+), 193 deletions(-)
diff --git a/java-chassis-reference/zh_CN/docs/config/apollo.md
b/java-chassis-reference/zh_CN/docs/config/apollo.md
new file mode 100644
index 0000000..e498151
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config/apollo.md
@@ -0,0 +1,27 @@
+# 使用 Apollo
+
+>>> 注意：本实现作为适配 Apollo 的参考，整体逻辑功能和设计规格不完善，不建议在生产环境使用。 如果在生产环境使用，建议基于 Apollo 提供的
SDK 自行扩展实现。
+
+[Apollo](https://github.com/ctripcorp/apollo) 是携程框架部门研发的分布式配置中心。
Apollo的下载安装请参考官网介绍。
+
+```xml
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>config-apollo</artifactId>
+</dependency>
+```
+
+然后在配置文件 microservice.yaml 中增加如下配置项：
+
+```yaml
+apollo:
+ config:
+ serverUri: http://127.0.0.1:8070
+ serviceName: apollo-test
+ env: DEV
+ clusters: test-cluster
+ namespace: application
+ token: xxx
+ refreshInterval: 30
+ firstRefreshInterval: 0
+```
diff --git a/java-chassis-reference/zh_CN/docs/config/config-service.md
b/java-chassis-reference/zh_CN/docs/config/config-service.md
deleted file mode 100644
index 02988ee..0000000
--- a/java-chassis-reference/zh_CN/docs/config/config-service.md
+++ /dev/null
@@ -1,185 +0,0 @@
-# 配置中心参考
-
-配置中心是微服务架构下一个非常重要的中间件，通过配置中心用户可以增加和删除配置信息，配置信息会通过不同的通知机制， 将配置的变化推送到微服务实例。 Java
Chassis 允许用户使用不同的配置中心， 并支持多个配置中心共存。
-
-## 使用 Kie
-
-* 下载安装
-
- 可以通过 [Kie官网](https://kie.readthedocs.io/en/latest/get-started.html)
下载和安装Kie。华为云提供了一个集成注册中心的本地版本，并提供了友好的界面，可以通过
[华为云](https://support.huaweicloud.com/devg-cse/cse_04_0046.html) 下载和使用。
-
- <br/>
-* 开发使用
-
- 在 java-chassis 中使用 Kie， 需要引入下面的依赖：
-
- ```xml
- <dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>config-kie</artifactId>
- </dependency>
- ```
-
- 然后在配置文件 microservice.yaml 中增加如下配置项：
-
- ```yaml
- servicecomb:
- kie:
- serverUri: http://127.0.0.1:30110
- ```
-
- <br/>
-* 使用配置中心增加配置
-
- 客户端默认会读取下面几个层次的配置：
-
- * 应用级配置：Label只包含environment、app，并且与微服务的环境、应用匹配的配置。
- * 服务级配置：Label只包含environment、app、service，并且与微服务的环境、应用、微服务名称匹配的配置。
- * 版本级配置：Label只包含environment、app、service、version，并且与微服务的环境、应用、微服务名称、版本匹配的配置。
- * 自定义配置：Label包含custom-label, 并且与 custom-value匹配的配置。
-
- 上述的配置级别，优先级从低到高。 Kie 的 yaml 和 properties 类型会映射为多个配置项， 其他类型，比如 json, text，
只会映射为一个配置项。开发者需要读取配置项自己解析内容。
-
- <br/>
-* 配置项参考
-
- |配置项名| 含义 | 缺省值 |
- |------------------------|---------|---|
- |servicecomb.kie.serverUri|
servicecomb-kie访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址 | 空 |
- |servicecomb.kie.enableLongPolling| Long Polling 模式是否开启
| true |
- |servicecomb.kie.pollingWaitTime| Long Polling 模式下等待时间，单位为秒
| 10 |
- |servicecomb.kie.firstPullRequired| 启动的时候第一次查询配置失败，是否终止启动。
| true |
- |servicecomb.kie.domainName| 区域名称
| default |
- |servicecomb.kie.refresh_interval| Pull 模式下刷新配置项的时间间隔，单位为毫秒。
| 15000 |
- |servicecomb.kie.firstRefreshInterval| Pull 模式下启动过程中首次刷新时间间隔，单位为毫秒。
| 3000 |
- |servicecomb.kie.enableAppConfig| 是否开启应用配置 | true |
- |servicecomb.kie.enableServiceConfig| 是否开启服务配置 | true |
- |servicecomb.kie.enableVersionConfig| 是否开启版本配置 | true |
- |servicecomb.kie.enableVersionConfig| 是否开启自定义配置 | true |
- |servicecomb.kie.customLabel| 自定义配置的Label | public |
- |servicecomb.kie.customLabelValue| 自定义配置的Value | 空 |
-
-
-## 使用 nacos
-
-* 下载安装
-
- 可以通过 [nacos官网](https://github.com/alibaba/nacos) 下载和安装 Nacos。
-
- <br/>
-
-* 开发使用
-使用nacos，需要在项目中引入如下依赖：
-
-```xml
-<dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>config-nacos</artifactId>
-</dependency>
-```
-
-然后在配置文件 microservice.yaml 中增加如下配置项：
-
-```yaml
-servicecomb:
- nacos:
- serverAddr: http://127.0.0.1:8848
-```
- <br/>
-
-* 使用配置中心增加配置
-
- Nacos的namespace对应于Java Chassis Environment, group对应于application。
客户端默认会读取下面几个层次的配置：
-
- * 应用级配置：group为application名称，data-id为application名称，并且类型为yaml的配置。
- * 服务级配置：group为application名称，data-id为微服务名称，并且类型为yaml的配置。
- * 版本级配置：group为application名称，data-id为微服务名称+版本号，并且类型为yaml的配置， 比如: service-0.1
- * Profile级配置：group为application名称，data-id为微服务名称+Profile名称，并且类型为yaml的配置， 比如:
service-dev
- * 自定义配置：可以通过配置项定义group、data-id、类型等信息，详情参考配置项。。
-
- 上述的配置级别，优先级从低到高。
-
- <br/>
-
-* 配置项参考
-
- |配置项名| 含义 | 缺省值 |
- |-------------------------------------------------|--------|---|
- |servicecomb.nacos.serverAddr|
NACOS访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址 | 空 |
- |servicecomb.nacos.group| 自定义group |
空 |
- |servicecomb.nacos.dataId| 自定义data-id |
空 |
- |servicecomb.nacos.addPrefix| 是否使用group+data-id作为配置项前缀
| false |
- |servicecomb.nacos.contentType| 自定义类型
| _yaml_ |
- |servicecomb.nacos.username| 连接Nacos的用户名
| 空 |
- |servicecomb.nacos.password| 连接Nacos的密码
| 空 |
- |servicecomb.nacos.accessKey| 连接Nacos的Access Key
| 空 |
- |servicecomb.nacos.secretKey| 连接Nacos的Secret Key
| 空 |
-
-## 使用 Apollo
-
->>> 注意：本实现作为适配 Apollo 的参考，整体逻辑功能和设计规格不完善，不建议在生产环境使用。 如果在生产环境使用，建议基于 Apollo 提供的
SDK 自行扩展实现。
-
-[Apollo](https://github.com/ctripcorp/apollo) 是携程框架部门研发的分布式配置中心。
Apollo的下载安装请参考官网介绍。
-
-```xml
-<dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>config-apollo</artifactId>
-</dependency>
-```
-
-然后在配置文件 microservice.yaml 中增加如下配置项：
-
-```yaml
-apollo:
- config:
- serverUri: http://127.0.0.1:8070
- serviceName: apollo-test
- env: DEV
- clusters: test-cluster
- namespace: application
- token: xxx
- refreshInterval: 30
- firstRefreshInterval: 0
-```
-
-## 华为云CSE1.0配置中心
-
->>> 注意：CSE1.0配置中心已经逐步下线， 本实现仅供遗留功能使用，新功能不建议使用。
-
-华为云CSE1.0配置中心是华为云CSE产品的一个部件，java-chassis 最早使用它作为配置中心。 对接这个配置中心的代码在 config-cc
模块实现。
-
-可以从
[轻量化微服务引擎](https://cse-bucket.obs.myhwclouds.com/LocalCSE/Local-CSE-1.0.3.zip)
下载本地使用的版本。也可以
-直接访问华为云 [ServiceStage](https://console.huaweicloud.com/servicestage)
产品，使用在线的版本。
-
-使用华为云配置中心，需要在项目中引入如下依赖：
-
-```xml
-<dependency>
- <groupId>org.apache.servicecomb</groupId>
- <artifactId>config-cc</artifactId>
-</dependency>
-```
-
-然后在配置文件 microservice.yaml 中增加如下配置项：
-
-```yaml
-servicecomb:
- config:
- client:
- serverUri: http://127.0.0.1:30113
- refreshMode: 0
- refresh_interval: 5000
- refreshPort: 30114
-```
-
-华为云配置中心的其他配置项含义如下：
-
-|配置项名|描述|
-|---|---|
-|servicecomb.config.client.refreshMode|应用配置的刷新方式，`0`为config-center主动push，`1`为client周期pull，默认为`0`|
-|servicecomb.config.client.refreshPort|config-center推送配置的端口|
-|servicecomb.config.client.tenantName|应用的租户名称|
-|servicecomb.config.client.serverUri|config-center访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址|
-|servicecomb.config.client.refresh_interval|pull模式下刷新配置项的时间间隔，单位为毫秒，默认值为15000|
-|servicecomb.config.client.fileSource|指定该配置项的内容为yaml文件，多个配置文件可以用`,`分隔|
diff --git a/java-chassis-reference/zh_CN/docs/config/cse1.md
b/java-chassis-reference/zh_CN/docs/config/cse1.md
new file mode 100644
index 0000000..8423dce
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config/cse1.md
@@ -0,0 +1,40 @@
+# 华为云CSE1.0配置中心
+
+>>> 注意：CSE1.0配置中心已经逐步下线， 本实现仅供遗留功能使用，新功能不建议使用。
+
+华为云CSE1.0配置中心是华为云CSE产品的一个部件，java-chassis 最早使用它作为配置中心。 对接这个配置中心的代码在 config-cc
模块实现。
+
+可以从
[轻量化微服务引擎](https://cse-bucket.obs.myhwclouds.com/LocalCSE/Local-CSE-1.0.3.zip)
下载本地使用的版本。也可以
+直接访问华为云 [ServiceStage](https://console.huaweicloud.com/servicestage)
产品，使用在线的版本。
+
+使用华为云配置中心，需要在项目中引入如下依赖：
+
+```xml
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>config-cc</artifactId>
+</dependency>
+```
+
+然后在配置文件 microservice.yaml 中增加如下配置项：
+
+```yaml
+servicecomb:
+ config:
+ client:
+ serverUri: http://127.0.0.1:30113
+ refreshMode: 0
+ refresh_interval: 5000
+ refreshPort: 30114
+```
+
+华为云配置中心的其他配置项含义如下：
+
+|配置项名|描述|
+|---|---|
+|servicecomb.config.client.refreshMode|应用配置的刷新方式，`0`为config-center主动push，`1`为client周期pull，默认为`0`|
+|servicecomb.config.client.refreshPort|config-center推送配置的端口|
+|servicecomb.config.client.tenantName|应用的租户名称|
+|servicecomb.config.client.serverUri|config-center访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址|
+|servicecomb.config.client.refresh_interval|pull模式下刷新配置项的时间间隔，单位为毫秒，默认值为15000|
+|servicecomb.config.client.fileSource|指定该配置项的内容为yaml文件，多个配置文件可以用`,`分隔|
diff --git a/java-chassis-reference/zh_CN/docs/config/general-config.md
b/java-chassis-reference/zh_CN/docs/config/general-config.md
index cb5f9fb..6a7cff1 100644
--- a/java-chassis-reference/zh_CN/docs/config/general-config.md
+++ b/java-chassis-reference/zh_CN/docs/config/general-config.md
@@ -41,7 +41,9 @@ servicecomb:
## 配置中心（动态配置）
-Java Chassis支持多个不同的配置中心实现，并支持同时使用多个配置中心。 配置中心的优先级高于文件配置。
+配置中心是微服务架构下一个非常重要的中间件，通过配置中心用户可以增加和删除配置信息，配置信息会通过不同的通知机制， 将配置的变化推送到微服务实例。 Java
Chassis 允许用户使用不同的配置中心， 并支持多个配置中心共存。
+
+配置中心的优先级高于文件配置。
## 进行配置项映射
diff --git a/java-chassis-reference/zh_CN/docs/config/kie.md
b/java-chassis-reference/zh_CN/docs/config/kie.md
new file mode 100644
index 0000000..cf87091
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config/kie.md
@@ -0,0 +1,54 @@
+# 使用 Kie
+
+## 下载安装
+
+ 可以通过 [Kie官网](https://kie.readthedocs.io/en/latest/get-started.html)
下载和安装Kie。华为云提供了一个集成注册中心的本地版本，并提供了友好的界面，可以通过
[华为云](https://support.huaweicloud.com/devg-cse/cse_04_0046.html) 下载和使用。
+
+## 开发使用
+
+使用 Kie， 需要引入下面的依赖：
+
+```xml
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>config-kie</artifactId>
+</dependency>
+```
+
+然后在配置文件 microservice.yaml 中增加如下配置项：
+
+```yaml
+servicecomb:
+ kie:
+ serverUri: http://127.0.0.1:30110
+```
+
+* 使用配置中心增加配置
+
+ 客户端默认会读取下面几个层次的配置：
+
+ * 应用级配置：Label只包含environment、app，并且与微服务的环境、应用匹配的配置。
+ * 服务级配置：Label只包含environment、app、service，并且与微服务的环境、应用、微服务名称匹配的配置。
+ * 版本级配置：Label只包含environment、app、service、version，并且与微服务的环境、应用、微服务名称、版本匹配的配置。
+ * 自定义配置：Label包含custom-label, 并且与 custom-value匹配的配置。
+
+ 上述的配置级别，优先级从低到高。 Kie 的 yaml 和 properties 类型会映射为多个配置项， 其他类型，比如 json, text，
只会映射为一个配置项。开发者需要读取配置项自己解析内容。
+
+
+* 配置项参考
+
+| 配置项名 | 含义
| 缺省值 |
+|--------------------------------------|-----------------------------------------------------------|---------|
+| servicecomb.kie.serverUri |
servicecomb-kie访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址 | 空 |
+| servicecomb.kie.enableLongPolling | Long Polling 模式是否开启
| true |
+| servicecomb.kie.pollingWaitTime | Long Polling 模式下等待时间，单位为秒
| 10 |
+| servicecomb.kie.firstPullRequired | 启动的时候第一次查询配置失败，是否终止启动。
| true |
+| servicecomb.kie.domainName | 区域名称
| default |
+| servicecomb.kie.refresh_interval | Pull 模式下刷新配置项的时间间隔，单位为毫秒。
| 15000 |
+| servicecomb.kie.firstRefreshInterval | Pull 模式下启动过程中首次刷新时间间隔，单位为毫秒。
| 3000 |
+| servicecomb.kie.enableAppConfig | 是否开启应用配置
| true |
+| servicecomb.kie.enableServiceConfig | 是否开启服务配置
| true |
+| servicecomb.kie.enableVersionConfig | 是否开启版本配置
| true |
+| servicecomb.kie.enableVersionConfig | 是否开启自定义配置
| true |
+| servicecomb.kie.customLabel | 自定义配置的Label
| public |
+| servicecomb.kie.customLabelValue | 自定义配置的Value
| 空 |
diff --git a/java-chassis-reference/zh_CN/docs/config/nacos.md
b/java-chassis-reference/zh_CN/docs/config/nacos.md
new file mode 100644
index 0000000..491367c
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config/nacos.md
@@ -0,0 +1,50 @@
+# 使用 Nacos
+
+## 下载安装
+
+可以通过 [Nacos官网](https://github.com/alibaba/nacos) 下载和安装 Nacos。
+
+## 开发使用
+
+使用Nacos，需要在项目中引入如下依赖：
+
+```xml
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>config-nacos</artifactId>
+</dependency>
+```
+
+然后在配置文件 microservice.yaml 中增加如下配置项：
+
+```yaml
+servicecomb:
+ nacos:
+ serverAddr: http://127.0.0.1:8848
+```
+
+* 配置中心增加配置
+
+ Nacos的namespace对应于Java Chassis Environment, group对应于application。
客户端默认会读取下面几个层次的配置：
+
+ * 应用级配置：group为application名称，data-id为application名称，并且类型为yaml的配置。
+ * 服务级配置：group为application名称，data-id为微服务名称，并且类型为yaml的配置。
+ * 版本级配置：group为application名称，data-id为微服务名称+版本号，并且类型为yaml的配置， 比如: service-0.1
+ * Profile级配置：group为application名称，data-id为微服务名称+Profile名称，并且类型为yaml的配置， 比如:
service-dev
+ * 自定义配置：可以通过配置项定义group、data-id、类型等信息，详情参考配置项。。
+
+ 上述的配置级别，优先级从低到高。
+
+* 配置项参考
+
+| 配置项名 | 含义
| 缺省值 |
+|-------------------------------|-------------------------------------------------|--------|
+| servicecomb.nacos.serverAddr |
NACOS访问地址，格式为`http(s)://{ip}:{port}`，以`,`分隔多个地址 | 空 |
+| servicecomb.nacos.group | 自定义group
| 空 |
+| servicecomb.nacos.dataId | 自定义data-id
| 空 |
+| servicecomb.nacos.addPrefix | 是否使用group+data-id作为配置项前缀
| false |
+| servicecomb.nacos.contentType | 自定义类型
| _yaml_ |
+| servicecomb.nacos.username | 连接Nacos的用户名
| 空 |
+| servicecomb.nacos.password | 连接Nacos的密码
| 空 |
+| servicecomb.nacos.accessKey | 连接Nacos的Access Key
| 空 |
+| servicecomb.nacos.secretKey | 连接Nacos的Secret Key
| 空 |
diff --git a/java-chassis-reference/zh_CN/docs/config/zookeeper.md
b/java-chassis-reference/zh_CN/docs/config/zookeeper.md
new file mode 100644
index 0000000..70fda66
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/config/zookeeper.md
@@ -0,0 +1,83 @@
+# 使用 Zookeeper
+
+## 下载安装
+
+可以通过 [ZooKeeper官网](https://zookeeper.apache.org/index.html) 下载和安装 ZooKeeper。
+
+## 开发使用
+
+使用ZooKeeper，需要在项目中引入如下依赖：
+
+```xml
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>config-zookeeper</artifactId>
+</dependency>
+```
+
+然后在配置文件 microservice.yaml 中增加如下配置项：
+
+```yaml
+servicecomb:
+ config:
+ zk:
+ connectString: 127.0.0.1:2181
+```
+
+* 配置中心增加配置
+
+ZooKeeper
使用下面的配置结构和环境（Environment）、应用（Application）、服务（Service）、版本（Version）、Tag对应，
配置级别优先级从低到高。
+
+```yaml
+servicecomb:
+ config:
+ environment:
+ ${environment}:
+ exampleText: exampleTextValue
+ exampleYaml.yaml: exampleYamlValue
+ exampleYaml.yml: exampleYamlValue
+ exampleProperties.properties: examplePropertiesValue
+ application:
+ ${environment}:
+ ${application}:
+ exampleText: exampleTextValue
+ exampleYaml.yaml: exampleYamlValue
+ exampleYaml.yml: exampleYamlValue
+ exampleProperties.properties: examplePropertiesValue
+ service:
+ ${environment}:
+ ${application}:
+ ${service}:
+ exampleText: exampleTextValue
+ exampleYaml.yaml: exampleYamlValue
+ exampleYaml.yml: exampleYamlValue
+ exampleProperties.properties: examplePropertiesValue
+ version:
+ ${environment}:
+ ${application}:
+ ${service}:
+ ${version}:
+ exampleText: exampleTextValue
+ exampleYaml.yaml: exampleYamlValue
+ exampleYaml.yml: exampleYamlValue
+ exampleProperties.properties: examplePropertiesValue
+ tag:
+ ${environment}:
+ ${application}:
+ ${service}:
+ ${tag}:
+ exampleText: exampleTextValue
+ exampleYaml.yaml: exampleYamlValue
+ exampleYaml.yml: exampleYamlValue
+ exampleProperties.properties: examplePropertiesValue
+```
+
+* 配置项参考
+
+| 配置项名 | 默认值 | 是否必须 | 含义
|
+|-----------------------------------------------|----------------|------|-----------------------------------------------|
+| servicecomb.config.zk.connect-string | 127.0.0.1:2181 | 是 |
ZooKeeper的地址信息，可以配置多个，用逗号分隔。 |
+| servicecomb.config.zk.authenticationSchema | 空 | 否 |
认证方式，目前只能配置为 digest。 |
+| servicecomb.config.zk.authenticationInfo | 空 | 否 |
当认证方式为 digest 的时候，配置用户名密码信息，比如: user:password |
+| servicecomb.config.zk.connectionTimeoutMillis | 1000 | 否 |
连接超时时间 |
+| servicecomb.config.zk.sessionTimeoutMillis | 60000 | 否 |
会话超时时间 |
diff --git a/java-chassis-reference/zh_CN/docs/registry/nacos.md
b/java-chassis-reference/zh_CN/docs/registry/nacos.md
index 977610c..06ddd5e 100644
--- a/java-chassis-reference/zh_CN/docs/registry/nacos.md
+++ b/java-chassis-reference/zh_CN/docs/registry/nacos.md
@@ -1,6 +1,6 @@
-# 使用 nacos
+# 使用 Nacos
-可以通过 [nacos官网](https://github.com/alibaba/nacos) 下载和安装 Nacos。
+可以通过 [Nacos官网](https://github.com/alibaba/nacos) 下载和安装 Nacos。
Nacos的namespace对应于环境Environment， group对应于application， service对应于微服务名称。
diff --git a/java-chassis-reference/zh_CN/docs/registry/service-center.md
b/java-chassis-reference/zh_CN/docs/registry/service-center.md
index 5145a27..ab9352a 100644
--- a/java-chassis-reference/zh_CN/docs/registry/service-center.md
+++ b/java-chassis-reference/zh_CN/docs/registry/service-center.md
@@ -1,6 +1,6 @@
-# 使用 service-center
+# 使用 Service Center
-ServcieComb service-center 提供了完备的注册发现机制， 是 Java Chassis 缺省使用的注册发现机制。
+ServcieComb Service Center 提供了完备的注册发现机制， 是 Java Chassis 缺省使用的注册发现机制。
服务中心支持使用 `PULL` 和 `PUSH` 两种模式通知实例变化， 开发者可以配置服务中心集群地址、连接参数以及心跳管理等。
diff --git a/java-chassis-reference/zh_CN/docs/registry/zookeeper.md
b/java-chassis-reference/zh_CN/docs/registry/zookeeper.md
new file mode 100644
index 0000000..2fbe299
--- /dev/null
+++ b/java-chassis-reference/zh_CN/docs/registry/zookeeper.md
@@ -0,0 +1,57 @@
+# 使用 ZooKeeper
+
+可以通过 [ZooKeeper官网](https://zookeeper.apache.org/index.html) 下载和安装 ZooKeeper。
+
+使用ZooKeeper需要确保下面的软件包引入：
+
+```
+<dependency>
+ <groupId>org.apache.servicecomb</groupId>
+ <artifactId>registry-zookeeper</artifactId>
+</dependency>
+```
+
+* 表1-1 访问ZooKeeper常用的配置项
+
+| 配置项 | 默认值 | 是否必选 |
含义 |
+|:--------------------------------------------------|:---------------|:-----|:----------------------------------------------|
+| servicecomb.registry.zk.enabled | true | 是 |
是否启用。 |
+| servicecomb.registry.zk.connectString | 127.0.0.1:2181 | 是 |
ZooKeeper的地址信息，可以配置多个，用逗号分隔。 |
+| servicecomb.registry.zk.authenticationSchema | 空 | 否 |
认证方式，目前只能配置为 digest。 |
+| servicecomb.registry.zk.authenticationInfo | 空 | 否 |
当认证方式为 digest 的时候，配置用户名密码信息，比如: user:password |
+| servicecomb.registry.zk.connectionTimeoutMillis | 1000 | 否 |
连接超时时间 |
+| servicecomb.registry.zk.sessionTimeoutMillis | 60000 | 否 |
会话超时时间 |
+| servicecomb.registry.zk.enableSwaggerRegistration | false | 否 |
是否注册契约 |
+
+## ZooKeeper使用认证
+
+ZooKeeper使用认证详细情况可以参考官网。这里给出核心重要的步骤，本步骤基于Zookeeper 3.8.3版本进行验证。
+
+1. 修改 zoo.cfg
+
+ 在配置文件增加。其中 `sessionRequireClientSASLAuth` 指定了必须登录才能够访问 Zookeeper。
+
+ ```text
+ authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider
+ sessionRequireClientSASLAuth=true
+ ```
+
+2. 修改 java.env
+
+ 在配置文件增加。 其中 `file.conf` 是第3步增加的文件路径
+
+ ```text
+ SERVER_JVMFLAGS="-Djava.security.auth.login.config=/opt/file.conf"
+ ```
+
+3. 增加 file.conf
+
+ 配置文件指定合法的登录用户。
+
+ ```text
+ Server {
+ org.apache.zookeeper.server.auth.DigestLoginModule required
+ user_super="adminsecret"
+ user_bob="bobsecret";
+ };
+ ```
diff --git a/java-chassis-reference/zh_CN/mkdocs.yml
b/java-chassis-reference/zh_CN/mkdocs.yml
index e864400..5f871fd 100644
--- a/java-chassis-reference/zh_CN/mkdocs.yml
+++ b/java-chassis-reference/zh_CN/mkdocs.yml
@@ -72,14 +72,19 @@ nav:
- Highway: transports/highway-rpc.md
- 多样化的服务注册与发现功能:
- 注册发现介绍: registry/introduction.md
- - 使用service-center: registry/service-center.md
- - 使用nacos: registry/nacos.md
+ - 使用Service Center: registry/service-center.md
+ - 使用Nacos: registry/nacos.md
+ - 使用ZooKeeper: registry/zookeeper.md
- 本地注册发现: registry/local-registry.md
- 去中心化注册发现: registry/distributed.md
- 多样化的配置管理功能:
- 服务配置介绍: config/general-config.md
- 在程序中读取配置信息: config/read-config.md
- - 配置中心参考: config/config-service.md
+ - 使用Kie: config/kie.md
+ - 使用Nacos: config/nacos.md
+ - 使用Zookeeper: config/zookeeper.md
+ - 使用Apollo: config/apollo.md
+ - 使用CSE1.0配置中心: config/cse1.md
- 服务治理功能参考:
- 负载均衡: references-handlers/loadbalance.md
- 限流: references-handlers/ratelimit.md
