rdelvalle/zookeeper

Docker化ZooKeeper镜像（环境变量可配置版）

镜像概述

本镜像基于 https://github.com/bobrik/docker-zookeeper 项目构建，以Ubuntu 16.04为基础镜像，通过Ubuntu软件仓库安装ZooKeeper。与其他ZooKeeper镜像不同，本镜像支持通过环境变量或绑定挂载配置文件两种方式进行自定义配置，尤其支持仅通过环境变量即可构建ZooKeeper集群，无需手动绑定挂载配置文件。

核心功能和特性

• 灵活配置方式：支持通过环境变量或绑定挂载配置文件进行ZooKeeper配置
• 集群构建支持：可仅通过环境变量配置实现ZooKeeper集群部署
• 数据持久化：支持挂载数据目录和日志目录到宿主机，确保数据持久化
• 基于官方源：ZooKeeper从Ubuntu官方软件仓库安装，确保稳定性
• 端口开放：默认开放客户端端口2181，集群模式下支持2888（ follower通信）和3888（选举）端口

使用场景和适用范围

• 开发环境快速部署单节点ZooKeeper服务
• 生产环境构建高可用ZooKeeper集群
• 需要灵活调整ZooKeeper配置参数的场景
• 希望避免手动管理配置文件的容器化部署需求

使用方法和配置说明

环境变量配置

单节点快速部署

通过ZK_CONFIG环境变量指定基本配置，ZK_ID指定节点ID（单节点场景下ID可设为1）：

bash
docker run -d -p 2181:2181 \
  -e ZK_CONFIG=clientPort=2181 \
  -e ZK_ID=1 \
  docker.xuanyuan.run/bobrik/zookeeper

集群部署

集群模式需在ZK_CONFIG中添加集群相关配置，同时暴露2888和3888端口。以下为3节点集群示例配置：

节点1（zk1.local）：

bash
docker run -d -p 2181:2181 -p 2888:2888 -p 3888:3888 \
  -e ZK_CONFIG="tickTime=2000,initLimit=10,syncLimit=5,maxClientCnxns=8000,forceSync=no,autopurge.snapRetainCount=5,autopurge.purgeInterval=2,clientPort=2181,server.1=zk1.local:2888:3888,server.2=zk2.local:2888:3888,server.3=zk3:2888:3888" \
  -e ZK_ID=1 \
  docker.xuanyuan.run/bobrik/zookeeper

节点2（zk2.local）：

bash
docker run -d -p 2181:2181 -p 2888:2888 -p 3888:3888 \
  -e ZK_CONFIG="tickTime=2000,initLimit=10,syncLimit=5,maxClientCnxns=8000,forceSync=no,autopurge.snapRetainCount=5,autopurge.purgeInterval=2,clientPort=2181,server.1=zk1.local:2888:3888,server.2=zk2.local:2888:3888,server.3=zk3:2888:3888" \
  -e ZK_ID=2 \
  docker.xuanyuan.run/bobrik/zookeeper

节点3（zk3）：

bash
docker run -d -p 2181:2181 -p 2888:2888 -p 3888:3888 \
  -e ZK_CONFIG="tickTime=2000,initLimit=10,syncLimit=5,maxClientCnxns=8000,forceSync=no,autopurge.snapRetainCount=5,autopurge.purgeInterval=2,clientPort=2181,server.1=zk1.local:2888:3888,server.2=zk2.local:2888:3888,server.3=zk3:2888:3888" \
  -e ZK_ID=3 \
  docker.xuanyuan.run/bobrik/zookeeper

集群配置参数说明：

• tickTime：基本时间单位（毫秒），用于心跳和超时设置
• initLimit： follower初始化同步的最大tick数
• syncLimit： follower与leader同步的最大tick数
• maxClientCnxns：最大客户端连接数
• forceSync：是否强制将事务日志同步到磁盘
• autopurge.snapRetainCount：保留的快照文件数量
• autopurge.purgeInterval：自动清理间隔（小时）
• server.X：集群节点配置，格式为server.ID=host:port:port（ID需与ZK_ID对应）

绑定挂载配置

若已有现成的ZooKeeper配置文件，可通过绑定挂载方式覆盖容器内配置：

bash
docker run -d -p 2181:2181 \
  -v /path/to/your/zk/conf:/etc/zookeeper/conf \
  docker.xuanyuan.run/bobrik/zookeeper

数据持久化

为确保数据和日志持久化，建议挂载数据目录和日志目录：

bash
docker run -d -p 2181:2181 \
  -e ZK_CONFIG=clientPort=2181 \
  -e ZK_ID=1 \
  -v /host/path/data:/var/lib/zookeeper \
  -v /host/path/logs:/var/log/zookeeper \
  docker.xuanyuan.run/bobrik/zookeeper

其中：

• /var/lib/zookeeper：ZooKeeper数据存储目录
• /var/log/zookeeper：ZooKeeper日志目录