grumpydocker/zookeeper repository overview

⁠Dockerized ZooKeeper

This Docker image is designed to be parameterized via environment variables to specify each ZooKeeper ensemble member's hostname

The examples to follow work on a local machine assuming the use of an overlay network, such as Weave⁠, with DNS available

zookeeper-3.5.1-alpha is used specifically to include the patches for ZOOKEEPER-1506⁠, which fixes DNS re-resolution of nodes that leave/enter the ZooKeeper cluster whose IP changes but hostname remains the same. This happens often when using an overlay network such as Weave⁠

The zoo.cfg included supports up to 9 parameterized ensemble members

⁠Requirements

The ZK_MYID and at least two ZK_SERVER[X] environment variables must be set

⁠Example

Run a 3 node ensemble

weave run -dt -p :2181:2181 --name=zoo1 -e ZK_MYID=1 -e ZK_CLIENT_PORT=2181 -e ZK_SERVER1=zoo1.weave.local -e ZK_SERVER2=zoo2.weave.local -e ZK_SERVER3=zoo3.weave.local zookeeper
weave run -dt -p :2182:2182 --name=zoo2 -e ZK_MYID=2 -e ZK_CLIENT_PORT=2182 -e ZK_SERVER1=zoo1.weave.local -e ZK_SERVER2=zoo2.weave.local -e ZK_SERVER3=zoo3.weave.local zookeeper
weave run -dt -p :2183:2183 --name=zoo3 -e ZK_MYID=3 -e ZK_CLIENT_PORT=2183 -e ZK_SERVER1=zoo1.weave.local -e ZK_SERVER2=zoo2.weave.local -e ZK_SERVER3=zoo3.weave.local zookeeper

Run the Four Letter Words⁠

weave run -it --rm busybox sh -c 'echo stat | nc zoo1.weave.local 2181'

Run the ZooKeeper CLI

weave run -it --rm grumpydocker/zookeeper /zookeeper/bin/zkCli.sh -server zoo1.weave.local

⁠Runtime

The default /entrypoint.sh will look for ZK_MYID and ZK_SERVER[X] environment variables and dynamically setup /data/myid and /etc/zookeeper/zoo.cfg, before running

/zookeeper/bin/zkServer.sh start-foreground /etc/zookeeper/zoo.cfg

⁠Ports

2181 Client port

2888 Quorum port

3888 Leader election port

⁠Volumes

/data is the ZooKeeper dataDir volume

/datalog is the ZooKeeper dataLogDir volume