ZK系列之ZooKeeper使用入门
准本条件
操作系统
ZK包含了很多组件，有些组件支持很多系统，而有些只支持部分。组件如下：
Client： Java客户端库，用于连接ZK。
Server： Java服务端运行在ZK集群节点。
Native Client：C实现的客户端，类似于Java客户端，应用程序连接ZK。
-
Contrib：可选择的插件组件。
操作系统 Client Server Native Client Contrib GNU/Linux 支持 支持 支持 支持 Solaris 支持 支持 不支持 不支持 FreeBSD 支持 支持 不支持 不支持 Windows 支持 支持 不支持 不支持 Mac OS X 仅支持开发 仅支持开发 不支持 不支持
需要说明的是支持指的是开发和生产环境。从上面的表可以看出，需要根据需求选择合适的操作系统，以便使用ZK。
软件要求
ZK是使用Java语言编写，所以操作系统需要安装Java环境，JDK版本必须是1.6以上。若是采用zk集群方式，至少需要3个节点，最好运行在不同的机器上。
安装ZK
下载zookeeper-3.4.12.tar.gz，然后解压到你喜欢的目录下即可。
单机模式与集群模式
ZK支持单机模式也支持集群模式，还有伪集群模式（一种退化的集群模式）。
配置文件
在conf目录下面，拷贝一份 zoo_sample.cfg,然后把名字改为 zoo.cfg。下面是一个简单的配置项：
tickTime=2000
initLimit=5
syncLimit=2
dataDir=../../../tmp/zk/data
dataLogDir=../../../tmp/zk/log
clientPort=2181
server.1=IP1:2888:3888
server.2=IP2:2888:3888
server.3=IP2:2888:3888
注意：将IPi修改为服务器1，在单机模式中无须配置；
参数说明：
-
tickTime：Zookeeper服务器之间或客户端与服务器之间维持心跳的时间间隔，也就是每个tickTime时间就会发送一个心跳。 -
initLimit:用来配置Zookeeper接受客户端(ZK服务集群中连接到Leader的Follower服务器)初始化连接时最长能忍受多少个心跳时间间隔数；时间长度：initLimit*tickTime。 -
syncLimit:Leader与Follower 之间发送消息，请求和应答时间长度，最长不能超过多少个 tickTime 的时间长度，syncLimit*tickTime -
dataDir：Zookeeper 保存数据的目录，默认情况下，Zookeeper 将写数据的日志文件也保存在这个目录里。 -
dataLogDir:zk保存日志的地方。 -
clientPort：这个端口就是客户端连接 Zookeeper 服务器的端口，Zookeeper 会监听这个端口，接受客户端的访问请求。 -
server.A=B：C：D：其中 A 是一个数字（1~255），表示这个是第几号服务器，；B 是这个服务器的 ip 地址；C 表示的是这个服务器与集群中的 Leader 服务器交换信息的端口；D 表示的是万一集群中的 Leader 服务器挂了，需要一个端口来重新进行选举，选出一个新的 Leader，而这个端口就是用来执行选举时服务器相互通信的端口。如果是伪集群的配置方式，由于 B 都是一样，所以不同的 Zookeeper 实例通信端口号不能一样，所以要给它们分配不同的端口号。
需要在dataDir目录下创建myid文件，里面的内容为A，注意每台机器需要一一对应
脚本说明
在 ZooKeeper的bin目录下的脚本内容：
| 脚本 | 说明 |
|---|---|
zkCleanup |
清理ZooKeeper历史数据，包括事务日志文件和快照数据文件 |
zkCli |
ZooKeeper的一个简易客户端 |
zkEnv |
设置ZooKeeper的环境变量 |
zkServer |
ZooKeeper服务器的启动、停止和重启脚本 |
单机模式
配置zoo.cfg
单机模式只适合在开发模式，在conf/zoo.cfg配置如下内容：
tickTime=2000
dataDir=../../../tmp/zk/data
dataLogDir=../../../tmp/zk/log
clientPort=2181
启动服务
进入到bin目录，执行脚本:zkServer.sh(linux) 或 zkServer.cmd（win）。
检测
- 使用
netstat -ano命令
启动服务之后，使用netstat -ano查看，比如在win中的命令：netstat -ano | findstr 2181;在linux下使用：netstat -nao | grep 2181
- 使用
telnet 127.0.0.1 2181, 输入stat：
Zookeeper version: 3.4.12-e5259e437540f349646870ea94dc2658c4e44b3b, built on 03/27/2018 03:55 GMT
Clients:/127.0.0.1:56800[0](queued=0,recved=1,sent=0)
Latency min/avg/max: 0/0/0
Received: 1
Sent: 0
Connections: 1
Outstanding: 0
Zxid: 0x23
Mode: standalone
Node count: 11
注意： Mode: standalone，表示单机模式。
集群模式
我们在一台机器上构建3个节点的伪集群模式。真正的集群模式与之类似，只是在配置项中有少许不同。构建三个节点：
zookeeper-1
zookeeper-2
zookeeper-3
配置zoo.cfg
在zookeeper-1的conf/zoo.cfg：
tickTime=2000
initLimit=5
syncLimit=2
dataDir=../../../tmp/zk1/data
dataLogDir=../../../tmp/zk1/log
clientPort=2181
server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
在zookeeper-2的conf/zoo.cfg：
tickTime=2000
initLimit=5
syncLimit=2
dataDir=../../../tmp/zk2/data
dataLogDir=../../../tmp/zk2/log
clientPort=2182
server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
在zookeeper-3的conf/zoo.cfg：
tickTime=2000
initLimit=5
syncLimit=2
dataDir=../../../tmp/zk3/data
dataLogDir=../../../tmp/zk3/log
clientPort=2183
server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
从上面的配置可以看出，由于在同一台机器上，所以需要配置不同的clientPort, 每个server中的端口配置不同。若是在不同的机器上，clientPort配置一样，每个server中配置的IP不同，但后面两个端口一样，也就是说不同机器构建集群的话，三份配置文件是一样的。
在dataDir目录下新建myid文件，文件内容是server.x中的x，此示例中分别为1,2,3。
启动服务
分别进入：zookeeper-x\bin，执行zkServer脚本，启动服务。
检查是否启动成功
-
使用 netstat 命令：
netstat -ano | findstr 218[1,2,3]TCP 0.0.0.0:2181 0.0.0.0:0 LISTENING 8520 TCP 0.0.0.0:2182 0.0.0.0:0 LISTENING 9212 TCP 0.0.0.0:2183 0.0.0.0:0 LISTENING 8736 TCP [::]:2181 [::]:0 LISTENING 8520 TCP [::]:2182 [::]:0 LISTENING 9212 TCP [::]:2183 [::]:0 LISTENING 8736 使用
telnet
-
telnet 127.0.0.1 2181, 然后输入statZookeeper version: 3.4.12-e5259e437540f349646870ea94dc2658c4e44b3b, built on 03/27/2018 03:55 GMT Clients: /127.0.0.1:58669[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0/0 Received: 1 Sent: 0 Connections: 1 Outstanding: 0 Zxid: 0x300000002 Mode: follower Node count: 13 -
telnet 127.0.0.1 2182, 然后输入statZookeeper version: 3.4.12-e5259e437540f349646870ea94dc2658c4e44b3b, built on 03/27/2018 03:55 GMT Clients:/127.0.0.1:58691[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0/0 Received: 1 Sent: 0 Connections: 1 Outstanding: 0 Zxid: 0xb00000000 Mode: leader Node count: 13 -
telnet 127.0.0.1 2183, 然后输入statZookeeper version: 3.4.12-e5259e437540f349646870ea94dc2658c4e44b3b, built on 03/27/2018 03:55 GMT Clients: /127.0.0.1:58706[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0/0 Received: 1 Sent: 0 Connections: 1 Outstanding: 0 Zxid: 0x 300000002 Mode: follower Node count: 13
构建集群结构
从Mode来看，可以看出构建的集群结构是：
node2 --- leader
/ \
/ \
Follower --- Node1 Node3 --- Follower
zk基于层次型的目录树数据结构，并对树中的节点进行有效管理，为此提供了一套很好的分布式集群管理的机制。
客户端玩zk
- 连接server：
zkCli.cmd -server 127.0.0.1:2181 - 创建节点
-
查看节点
[zk: 127.0.0.1:2181(CONNECTED) 2] ls / [dubbo, zookeeper, app2, app1, app3] 创建节点
创建一个节点zk_test，关联到的数据是 my_data
[zk: 127.0.0.1:2181(CONNECTED) 3] create /zk_test my_data
Created /zk_test
[zk: 127.0.0.1:2181(CONNECTED) 4] ls /
[dubbo, zookeeper, app2, app1, app3, zk_test]
-
查看节点信息
[zk: 127.0.0.1:2181(CONNECTED) 5] get /zk_test my_data cZxid = 0xb00000002 ctime = Tue Mar 19 19:20:00 CST 2019 mZxid = 0xb00000002 mtime = Tue Mar 19 19:20:00 CST 2019 pZxid = 0xb00000002 cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 7 numChildren = 0 [zk: 127.0.0.1:2181(CONNECTED) 6] -
更新节点信息
[zk: 127.0.0.1:2181(CONNECTED) 6] set /zk_test junk cZxid = 0xb00000002 ctime = Tue Mar 19 19:20:00 CST 2019 mZxid = 0xb00000003 mtime = Tue Mar 19 19:57:15 CST 2019 pZxid = 0xb00000002 cversion = 0 dataVersion = 1 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 4 numChildren = 0 -
删除节点
[zk: 127.0.0.1:2181(CONNECTED) 7] delete /zk_test [zk: 127.0.0.1:2181(CONNECTED) 8] ls / [dubbo, zookeeper, app2, app1, app3] [zk: 127.0.0.1:2181(CONNECTED) 9] -
注意删除非空节点报：
Node not empty: xxx- 创建节点
[zk: 127.0.0.1:2181(CONNECTED) 11] create /zk_test my_test Created /zk_test- 创建子节点
[zk: 127.0.0.1:2181(CONNECTED) 12] ls / [dubbo, zookeeper, app2, app1, app3, zk_test] [zk: 127.0.0.1:2181(CONNECTED) 13] create /zk_test/child junk Created /zk_test/child [zk: 127.0.0.1:2181(CONNECTED) 14] ls / [dubbo, zookeeper, app2, app1, app3, zk_test] [zk: 127.0.0.1:2181(CONNECTED) 15] ls /zk_test [child]- 查看节点信息
[zk: 127.0.0.1:2181(CONNECTED) 16] get /zk_test my_test cZxid = 0xb00000005 ctime = Tue Mar 19 20:20:45 CST 2019 mZxid = 0xb00000005 mtime = Tue Mar 19 20:20:45 CST 2019 pZxid = 0xb00000006 cversion = 1 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 7 numChildren = 1[zk: 127.0.0.1:2181(CONNECTED) 17] get /zk_test/child junk cZxid = 0xb00000006 ctime = Tue Mar 19 20:21:05 CST 2019 mZxid = 0xb00000006 mtime = Tue Mar 19 20:21:05 CST 2019 pZxid = 0xb00000006 cversion = 0 dataVersion = 0 aclVersion = 0 ephemeralOwner = 0x0 dataLength = 4 numChildren = 0-
删除非空节点
[zk: 127.0.0.1:2181(CONNECTED) 18] delete /zk_test Node not empty: /zk_test [zk: 127.0.0.1:2181(CONNECTED) 19]
