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 8a3ddb6ec3 add zk and polaris (#2056)
8a3ddb6ec3 is described below
commit 8a3ddb6ec35383f00617b674c54df4d6876890d4
Author: FengZhang <[email protected]>
AuthorDate: Mon Feb 6 17:20:29 2023 +0800
add zk and polaris (#2056)
---
.../tutorial/develop/registry/polaris.md | 61 ++++++++++++-
.../tutorial/develop/registry/zookeeper.md | 100 ++++++++++++++++++++-
2 files changed, 159 insertions(+), 2 deletions(-)
diff --git
a/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/polaris.md
b/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/polaris.md
index 6d8c3fb885..2fb12a3b6f 100644
--- a/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/polaris.md
+++ b/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/polaris.md
@@ -4,4 +4,63 @@ type: docs
weight: 12
---
-TBD
+
+## 1.准备工作
+
+- 假设您已经准备好demo工程，如果不清楚，可以参考前面的文章
+- 北极星服务端安装
+
+
[北极星服务端单机版本安装文档](https://polarismesh.cn/docs/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%AE%89%E8%A3%85/%E5%8D%95%E6%9C%BA%E7%89%88%E5%AE%89%E8%A3%85/)
+
+
[北极星服务端集群版本安装文档](https://polarismesh.cn/docs/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%AE%89%E8%A3%85/%E9%9B%86%E7%BE%A4%E7%89%88%E5%AE%89%E8%A3%85/)
+
+## 2.使用Polaris作为注册中心
+
+### 2.1dubbogo.yaml 配置文件
+
+当前 PolarisMesh 已实现了 dubbogo 的注册发现扩展点，因此你只需要调整你的 dubbogo.yaml 文件中的 registries
配置项，新增 protocol 为 polaris 的注册中心配置即可，可以参考下面的样例。
+
+```yaml
+dubbo:
+ registries:
+ polarisMesh:
+ protocol: polaris
+ address: ${北极星服务端IP}:8091
+ namespace: ${北极星命名空间信息}
+ token: ${北极星资源鉴权 token} # 如果北极星服务端开启了针对客户端的鉴权，则需要配置该参数
+```
+
+### 2.2运行服务提供者
+
+进入 go-server 的 cmd 目录，执行以下命令
+
+```
+ export DUBBO_GO_CONFIG_PATH="../conf/dubbogo.yml"
+ go run .
+```
+
+当看到以下日志时即表示 server 端启动成功
+
+```log
+INFO dubbo/dubbo_protocol.go:84 [DUBBO Protocol] Export service:
+```
+
+
+### 2.3运行服务调用者
+
+进入 go-client 的 cmd 目录，执行以下命令
+
+
+```
+ export DUBBO_GO_CONFIG_PATH="../conf/dubbogo.yml"
+ go run .
+```
+
+当看到以下日志时即表示 go-client 成功发现 go-server 并发起了 RPC 调用
+
+```log
+INFO cmd/main.go:75 response: &{A001 Alex Stocks 18 2022-11-19
12:52:38.092 +0800 CST}
+```
+
+## 3.使用Polaris作为注册中心
+相关源码：[示例源码](https://github.com/apache/dubbo-go-samples/tree/master/polaris/registry)
\ No newline at end of file
diff --git
a/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper.md
b/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper.md
index 97766678f3..ee469b7d00 100644
--- a/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper.md
+++ b/content/zh/docs3-v2/golang-sdk/tutorial/develop/registry/zookeeper.md
@@ -4,4 +4,102 @@ type: docs
weight: 11
---
-TBD
+
+## 1. 准备工作
+
+- dubbo-go cli 工具和依赖工具已安装
+- 创建一个新的 demo 应用
+- 准备 Zookeeper 实例
+
+## 2. 配置注册中心
+
+修改服务端配置 go-server/conf/dubbogo.yaml
+
+```yaml
+dubbo:
+ registries:
+ demoZK:
+ protocol: zookeeper
+ timeout: 3s
+ address: 127.0.0.1:2181
+ group: myGroup # default is dubbo
+ registry-type: interface
+ protocols:
+ triple:
+ name: tri
+ port: 20000
+ provider:
+ services:
+ GreeterProvider:
+ interface: com.apache.dubbo.sample.basic.IGreeter # must be compatible
with grpc or dubbo-java
+ UserProviderWithCustomGroupAndVersion:
+ interface: com.apache.dubbo.sample.basic.IGreeter2
+ version: myInterfaceVersion # dubbo interface version must be same
with client
+ group: myInterfaceGroup # dubbo interface group must be same with
client
+```
+
+修改客户端配置 go-client/conf/dubbogo.yaml
+
+```yaml
+dubbo:
+ registries:
+ demoZK:
+ protocol: zookeeper
+ timeout: 3s
+ address: 127.0.0.1:2181
+ group: myGroup
+ registry-type: interface
+ consumer:
+ references:
+ GreeterClientImpl:
+ protocol: tri
+ interface: com.apache.dubbo.sample.basic.IGreeter # must be compatible
with grpc or dubbo-java
+ UserProviderWithCustomGroupAndVersion:
+ protocol: tri
+ interface: com.apache.dubbo.sample.basic.IGreeter2 # must be
compatible with grpc or dubbo-java
+ group: myInterfaceGroup # dubbo interface group must be same with
server
+ version: myInterfaceVersion # dubbo interface version must be same
with server
+```
+
+
+
+## 3. 使用 Zookeeper 进行服务发现
+
+- 启动go-server/cmd，查看日志
+
+ ```bash
+ INFO zookeeper/registry.go:217 [Zookeeper Registry] Registry
instance with root = /myGroup/com.apache.dubbo.sample.basic.IGreeter/providers
+ ```
+
+ 日志中包含 Zookeeper 注册信息，将当前服务接口注册在 Zookeeper
+
+
+- 启动 go-client/cmd 查看日志
+
+
+ 日志中包含 Zookeeper 注册组件的订阅事件信息，获取到服务端 IP 和端口号，显示调用成功。
+
+ ```
+ zookeeper/registry.go:217 [Zookeeper Registry] Registry instance with
root = /myGroup/com.apache.dubbo.sample.basic.IGreeter/consumers, node =
consumer%3A%2F%2F172.22.91.1%2Fcom.apache.dubbo.sample.basic.IGreeter%3Fapp.version%3D%26application%3Ddubbo.io%26async%3Dfalse%26bean.name%3DGreeterClientImpl%26cluster%3Dfailover%26config.tracing%3D%26environment%3D%26generic%3D%26group%3D%26interface%3Dcom.apache.dubbo.sample.basic.IGreeter%26loadbalance%3D%26metadata-type%3Dlocal%26mo
[...]
+
+
+ cmd/client.go:54 start to test dubbo
+ cmd/client.go:62 client response result: name:"Hello laurence"
id:"12345" age:21
+ cmd/client.go:68 client response result: name:"Hello laurence from
UserProviderWithCustomRegistryGroupAndVersion" id:"12345" age:21
+ ```
+
+- 同时，我们可以直接查看zk中的数据如下：
+
+ ```bash
+ [zk: localhost:2181(CONNECTED) 6] ls /
+ [zookeeper, myGroup]
+ [zk: localhost:2181(CONNECTED) 7] ls /myGroup
+ [com.apache.dubbo.sample.basic.IGreeter2,
com.apache.dubbo.sample.basic.IGreeter]
+ ```
+
+## 4. 更多支持的注册中心
+
+参考
[dubbo-go-samples/registry](https://github.com/apache/dubbo-go-samples/tree/master/registry)
+
+
+
