bobrik/zookeeper

Docker化Zookeeper：支持环境变量配置的镜像

镜像概述和主要用途

本镜像解决了其他Zookeeper镜像需通过绑定挂载配置文件才能修改配置或构建集群的问题，支持通过环境变量直接配置，也可兼容绑定挂载配置文件的方式。基于Ubuntu 14.04系统，从Ubuntu仓库安装Zookeeper，适用于需要快速部署Zookeeper单节点或集群的场景。

核心功能和特性

• 环境变量配置：无需绑定配置文件，通过环境变量即可完成Zookeeper配置
• 集群支持：仅通过环境变量即可构建Zookeeper集群
• 配置兼容：同时支持环境变量配置和绑定挂载配置文件两种方式
• 数据持久化：支持将数据和日志目录挂载到主机，实现持久化存储

使用场景和适用范围

• 快速部署Zookeeper单节点服务
• 构建Zookeeper集群（2节点及以上）
• 需要通过环境变量简化配置管理的场景
• 需持久化存储Zookeeper数据和日志的生产环境

使用方法和配置说明

环境变量说明

• ZK_CONFIG：Zookeeper配置参数，格式为逗号分隔的键值对（如clientPort=2181,tickTime=2000）
• ZK_ID：节点ID，集群模式下每个节点需指定唯一ID（1,2,3...）

单节点部署

超简单的单节点启动命令：

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

• 暴露2181端口（Zookeeper客户端端口）
• 通过ZK_CONFIG设置客户端端口，ZK_ID设置节点ID为1

集群部署

集群部署需在ZK_CONFIG中添加集群节点配置，并暴露额外端口。以3节点集群为例：

1. 节点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 \
  bobrik/zookeeper

2. 节点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 \
  bobrik/zookeeper

3. 节点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 \
  bobrik/zookeeper

集群部署注意事项：

• 需暴露3个端口：2181（客户端端口）、2888（集群内通信端口）、3888（选举端口）
• 每个节点的ZK_ID需唯一且与server.X中的X对应
• server.X配置需包含集群所有节点的地址和端口

绑定挂载配置文件

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

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

• 将主机的配置目录挂载到容器内/etc/zookeeper/conf目录

数据和日志持久化

建议将数据和日志目录挂载到主机以实现持久化：

bash
docker run -d -p 2181:2181 \
  -v /host/path/data:/var/lib/zookeeper \  # 数据持久化
  -v /host/path/logs:/var/log/zookeeper \  # 日志持久化
  -e ZK_CONFIG=clientPort=2181 -e ZK_ID=1 \
  bobrik/zookeeper