Zookeeper 是 Apache Hadoop 的子項(xiàng)目，是一個(gè)樹(shù)型的目錄服務(wù)，支持變更推送，適合作為 Dubbo 服務(wù)的注冊(cè)中心，工業(yè)強(qiáng)度較高，可用于生產(chǎn)環(huán)境，并推薦使用 （建議使用 2.3.3 以上版本的 zookeeper 注冊(cè)中心客戶端）。

流程說(shuō)明：

• 服務(wù)提供者啟動(dòng)時(shí): 向 /dubbo/com.foo.BarService/providers 目錄下寫(xiě)入自己的 URL 地址
• 服務(wù)消費(fèi)者啟動(dòng)時(shí): 訂閱 /dubbo/com.foo.BarService/providers 目錄下的提供者 URL 地址。并向 /dubbo/com.foo.BarService/consumers 目錄下寫(xiě)入自己的 URL 地址
• 監(jiān)控中心啟動(dòng)時(shí): 訂閱 /dubbo/com.foo.BarService 目錄下的所有提供者和消費(fèi)者 URL 地址。

支持以下功能：

• 當(dāng)提供者出現(xiàn)斷電等異常停機(jī)時(shí)，注冊(cè)中心能自動(dòng)刪除提供者信息
• 當(dāng)注冊(cè)中心重啟時(shí)，能自動(dòng)恢復(fù)注冊(cè)數(shù)據(jù)，以及訂閱請(qǐng)求
• 當(dāng)會(huì)話過(guò)期時(shí)，能自動(dòng)恢復(fù)注冊(cè)數(shù)據(jù)，以及訂閱請(qǐng)求
• 當(dāng)設(shè)置 <dubbo:registry check="false" /> 時(shí)，記錄失敗注冊(cè)和訂閱請(qǐng)求，后臺(tái)定時(shí)重試
• 可通過(guò) <dubbo:registry username="admin" password="1234" /> 設(shè)置 zookeeper 登錄信息
• 可通過(guò) <dubbo:registry group="dubbo" /> 設(shè)置 zookeeper 的根節(jié)點(diǎn)，不配置將使用默認(rèn)的根節(jié)點(diǎn)。
• 支持 * 號(hào)通配符 <dubbo:reference group="*" version="*" />，可訂閱服務(wù)的所有分組和所有版本的提供者

使用

在 provider 和 consumer 中增加 zookeeper 客戶端 jar 包依賴(lài)：

<dependency>
    <groupId>org.apache.zookeeper</groupId>
    <artifactId>zookeeper</artifactId>
    <version>3.8.0</version>
</dependency>

或直接下載。

Dubbo 支持 zkclient 和 curator 兩種 Zookeeper 客戶端實(shí)現(xiàn)：

注意:在2.7.x的版本中已經(jīng)移除了zkclient的實(shí)現(xiàn),如果要使用zkclient客戶端,需要自行拓展

使用 zkclient 客戶端

從 2.2.0 版本開(kāi)始缺省為 zkclient 實(shí)現(xiàn)，以提升 zookeeper 客戶端的健壯性。zkclient 是 Datameer 開(kāi)源的一個(gè) Zookeeper 客戶端實(shí)現(xiàn)。

缺省配置：

<dubbo:registry ... client="zkclient" />

或：

dubbo.registry.client=zkclient

或：

zookeeper://10.20.153.10:2181?client=zkclient

需依賴(lài)或直接下載：

<dependency>
    <groupId>com.github.sgroschupf</groupId>
    <artifactId>zkclient</artifactId>
    <version>0.11</version>
</dependency>

使用 curator 客戶端

從 2.3.0 版本開(kāi)始支持可選 curator 實(shí)現(xiàn)。Curator 是 Netflix  開(kāi)源的一個(gè) Zookeeper 客戶端實(shí)現(xiàn)。

如果需要改為 curator 實(shí)現(xiàn)，請(qǐng)配置：

<dubbo:registry ... client="curator" />

或：

dubbo.registry.client=curator

或：

zookeeper://10.20.153.10:2181?client=curator

需依賴(lài)或直接下載curator-framework, curator-recipes：

<properties>
    <curator.version>5.2.1</curator.version>
</properties>

<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-framework</artifactId>
    <version>${curator.version}</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>${curator.version}</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-x-discovery</artifactId>
    <version>${curator.version}</version>
</dependency>

Zookeeper 單機(jī)配置:

<dubbo:registry address="zookeeper://10.20.153.10:2181" />

或：

<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181" />

Zookeeper 集群配置：

<dubbo:registry address="zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181" />

或：

<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />

同一 Zookeeper，分成多組注冊(cè)中心:

<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 安裝

安裝方式參見(jiàn): Zookeeper安裝手冊(cè)，只需搭一個(gè)原生的 Zookeeper 服務(wù)器，并將 Quick Start 中 Provider 和 Consumer 里的 conf/dubbo.properties 中的 dubbo.registry.address 的值改為 zookeeper://127.0.0.1:2181 即可使用。

可靠性聲明

阿里內(nèi)部并沒(méi)有采用 Zookeeper 做為注冊(cè)中心，而是使用自己實(shí)現(xiàn)的基于數(shù)據(jù)庫(kù)的注冊(cè)中心，即：Zookeeper 注冊(cè)中心并沒(méi)有在阿里內(nèi)部長(zhǎng)時(shí)間運(yùn)行的可靠性保障，此 Zookeeper 橋接實(shí)現(xiàn)只為開(kāi)源版本提供，其可靠性依賴(lài)于 Zookeeper 本身的可靠性。

兼容性聲明

因 2.0.8 最初設(shè)計(jì)的 zookeeper 存儲(chǔ)結(jié)構(gòu)不能擴(kuò)充不同類(lèi)型的數(shù)據(jù)，2.0.9 版本做了調(diào)整，所以不兼容，需全部改用 2.0.9 版本才行，以后的版本會(huì)保持兼容 2.0.9。2.2.0 版本改為基于 zkclient 實(shí)現(xiàn)，需增加 zkclient 的依賴(lài)包，2.3.0 版本增加了基于 curator 的實(shí)現(xiàn)，作為可選實(shí)現(xiàn)策略。