Dubbo Zookeeper Registry

超、凢脫俗 2022-04-12 03:22 171阅读 0赞

### [Dubbo Zookeeper Registry][] ###

**博客分类：**

*   
 *  [cloud][]

### http://code.alibabatech.com/wiki/display/dubbo/User+Guide\#UserGuide-RequiredDependencies ###

### Zookeeper Registry ###

建议使用dubbo-2.3.3以上版本的zookeeper注册中心客户端

**Zookeeper说明**  
Zookeeper是Apacahe Hadoop的子项目，是一个树型的目录服务，支持变更推送，适合作为Dubbo服务的注册中心，工业强度较高，可用于生产环境，并推荐使用，参见：[http://zookeeper.apache.org][http_zookeeper.apache.org]

**Zookeeper安装**  
安装方式参见: [Zookeeper安装手册][Zookeeper]，只需搭一个原生的Zookeeper服务器，并将[Quick Start][]中Provider和Consumer里的conf/dubbo.properties中的dubbo.registry.addrss的值改为zookeeper://127.0.0.1:2181即可使用

![32c67624-85be-375b-afba-4d73f1c41b3a.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。
 *  支持\*号通配符<dubbo:reference group="\*" version="\*" />，可订阅服务的所有分组和所有版本的提供者。

在provider和consumer中增加zookeeper客户端jar包依赖：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>groupId</code> 
      <code>&gt;org.apache.zookeeper&lt;/</code> 
      <code>groupId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>artifactId</code> 
      <code>&gt;zookeeper&lt;/</code> 
      <code>artifactId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>version</code> 
      <code>&gt;3.3.3&lt;/</code> 
      <code>version</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&lt;/</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或直接下载：[http://repo1.maven.org/maven2/org/apache/zookeeper/zookeeper][http_repo1.maven.org_maven2_org_apache_zookeeper_zookeeper]

支持zkclient和curator两种Zookeeper客户端实现：

#### ZKClient Zookeeper Registry ####

从2.2.0版本开始缺省为zkclient实现，以提升zookeeper客户端的健状性。

<table> 
 <tbody> 
  <tr> 
   <td><img src="http://code.alibabatech.com/wiki/images/icons/emoticons/check.gif" alt="" width="16" height="16"></td> 
   <td>ZKClient是Datameer开源的一个Zookeeper客户端实现，开源比较早，参见：<a style="color:#108ac6;text-decoration:underline;" href="https://github.com/sgroschupf/zkclient" rel="nofollow">https://github.com/sgroschupf/zkclient</a> </td> 
  </tr> 
 </tbody> 
</table>

缺省配置：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code>&nbsp; 
      <code>... </code> 
      <code>client</code> 
      <code>=</code> 
      <code>"zkclient"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>dubbo.registry.client=zkclient</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>zookeeper://10.20.153.10:2181?client=zkclient</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

需依赖：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>groupId</code> 
      <code>&gt;com.github.sgroschupf&lt;/</code> 
      <code>groupId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>artifactId</code> 
      <code>&gt;zkclient&lt;/</code> 
      <code>artifactId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>version</code> 
      <code>&gt;0.1&lt;/</code> 
      <code>version</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&lt;/</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或直接下载：[http://repo1.maven.org/maven2/com/github/sgroschupf/zkclient][http_repo1.maven.org_maven2_com_github_sgroschupf_zkclient]

#### Curator Zookeeper Registry ####

从2.3.0版本开始支持可选curator实现。

<table> 
 <tbody> 
  <tr> 
   <td><img src="http://code.alibabatech.com/wiki/images/icons/emoticons/check.gif" alt="" width="16" height="16"></td> 
   <td>Curator是Netflix开源的一个Zookeeper客户端实现，比较活跃，参见：<a style="color:#108ac6;text-decoration:underline;" href="https://github.com/Netflix/curator" rel="nofollow">https://github.com/Netflix/curator</a> </td> 
  </tr> 
 </tbody> 
</table>

如果需要改为curator实现，请配置：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code>&nbsp; 
      <code>... </code> 
      <code>client</code> 
      <code>=</code> 
      <code>"curator"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>dubbo.registry.client=curator</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>zookeeper://10.20.153.10:2181?client=curator</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

需依赖：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>groupId</code> 
      <code>&gt;com.netflix.curator&lt;/</code> 
      <code>groupId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>artifactId</code> 
      <code>&gt;curator-framework&lt;/</code> 
      <code>artifactId</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>&lt;</code> 
      <code>version</code> 
      <code>&gt;1.1.10&lt;/</code> 
      <code>version</code> 
      <code>&gt;</code> 
     </div> 
     <div> 
      <code>&lt;/</code> 
      <code>dependency</code> 
      <code>&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或直接下载：[http://repo1.maven.org/maven2/com/netflix/curator/curator-framework][http_repo1.maven.org_maven2_com_netflix_curator_curator-framework]

Zookeeper单机配置:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code>&nbsp; 
      <code>address</code> 
      <code>=</code> 
      <code>"zookeeper://10.20.153.10:2181"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

Or:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code>&nbsp; 
      <code>protocol</code> 
      <code>=</code> 
      <code>"zookeeper"</code>&nbsp; 
      <code>address</code> 
      <code>=</code> 
      <code>"10.20.153.10:2181"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

Zookeeper集群配置:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code> 
      <code>address</code> 
      <code>=</code> 
      <code>"zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

Or:

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div title="Hint: double-click to select code"> 
     <div> 
      <code>&lt;</code> 
      <code>dubbo:registry</code>&nbsp; 
      <code>protocol</code> 
      <code>=</code> 
      <code>"zookeeper"</code> 
      <code>address</code> 
      <code>=</code> 
      <code>"10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181"</code>&nbsp; 
      <code>/&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

同一Zookeeper，分成多组注册中心:

`<` `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"`  `/>`

[Dubbo Zookeeper Registry]: http://huyumin.iteye.com/blog/1912346
[cloud]: http://huyumin.iteye.com/category/281528
[http_zookeeper.apache.org]: http://zookeeper.apache.org/
[Zookeeper]: http://code.alibabatech.com/wiki/display/dubbo/Administrator+Guide#AdministratorGuide-ZookeeperRegistryInstallation
[Quick Start]: http://code.alibabatech.com/wiki/display/dubbo/User+Guide#UserGuide-QuickStart
[32c67624-85be-375b-afba-4d73f1c41b3a.jpg]: /images/20220412/0c7e917a2d0f4716abc1ddc05119d774.png
[http_repo1.maven.org_maven2_org_apache_zookeeper_zookeeper]: http://repo1.maven.org/maven2/org/apache/zookeeper/zookeeper
[http_repo1.maven.org_maven2_com_github_sgroschupf_zkclient]: http://repo1.maven.org/maven2/com/github/sgroschupf/zkclient
[http_repo1.maven.org_maven2_com_netflix_curator_curator-framework]: http://repo1.maven.org/maven2/com/netflix/curator/curator-framework