baqend/zookeeper

docker-zookeeper 镜像文档

镜像概述

本Docker镜像旨在提供一种简单的方式部署多节点ZooKeeper集群。其核心设计目标是让容器能够自动创建ZooKeeper的myID文件，从而支持通过单行命令快速启动ZooKeeper容器。目前我们尚未发现其他更简便的实现方法。

相关资源：

• https://github.com/Baqend/tutorial-swarm-storm
• https://hub.docker.com/r/baqend/zookeeper/
• https://github.com/Baqend/docker-zookeeper

核心功能和特性

• 自动生成myID文件：无需手动创建ZooKeeper节点标识文件，容器启动时自动生成
• 简化多节点配置：通过指定集群节点列表和唯一ID即可完成配置
• 数据持久化：支持将ZooKeeper数据和日志目录映射到主机，确保容器故障后数据不丢失
• 标准端口暴露：默认暴露ZooKeeper所需的2181（客户端端口）、2888（ follower通信端口）和3888（选举端口）

使用场景

适用于需要快速部署多节点ZooKeeper集群的场景，尤其适合分布式系统协调、服务发现、配置管理等依赖ZooKeeper的应用环境。

使用方法

多节点集群部署示例

假设在主机名为zk1、zk2和zk3的机器上部署3节点ZooKeeper集群，在每个节点上执行以下命令：

bash
docker run -d --restart=always \
      -p 2181:2181 \
      -p 2888:2888 \
      -p 3888:3888 \
      -v /var/lib/zookeeper:/var/lib/zookeeper \
      -v /var/log/zookeeper:/var/log/zookeeper  \
      baqend/zookeeper zk1,zk2,zk3 $ID

参数说明：

• -p：端口映射，暴露ZooKeeper默认所需的三个端口
• -v：卷挂载，将容器内的/var/lib/zookeeper（数据目录）和/var/log/zookeeper（日志目录）映射到主机对应目录，实现数据持久化
• zk1,zk2,zk3：集群节点主机名列表，所有节点需使用相同的列表
• $ID：节点唯一标识，每个节点需指定不同的ID（分别为1、2、3）

注意事项

• ZooKeeper仅接受1到255之间的节点ID，需确保$ID在此范围内
• 所有节点的集群列表必须一致，以保证集群正常通信
• 卷挂载目录需确保主机有足够权限，避免容器启动失败

使用示例参考

可参考我们的https://github.com/Baqend/tutorial-swarm-storm%E4%BA%86%E8%A7%A3%E8%AF%A5%E9%95%9C%E5%83%8F%E7%9A%84%E5%AE%9E%E9%99%85%E5%BA%94%E7%94%A8%E5%9C%BA%E6%99%AF%E3%80%82