mjvdende/zookeeper

ZooKeeper Docker镜像

概述

该Docker镜像提供了在Docker容器中运行ZooKeeper的基础环境。启动脚本会根据容器环境变量生成ZooKeeper配置并启动服务。镜像中ZooKeeper版本定义在Dockerfile中，通常指向最新稳定版。

核心功能与特性

• 环境变量驱动配置：通过环境变量灵活配置ZooKeeper参数，无需手动修改配置文件
• 单节点/集群模式支持：默认单节点模式，通过指定集群节点信息可切换为集群模式
• 数据持久化：提供数据快照和日志卷，支持数据持久化存储
• 自动配置生成：启动脚本根据环境变量自动生成zoo.cfg配置文件
• 日志管理：日志按100MB大小轮转，保留10个日志文件

使用场景

• 开发环境中快速部署ZooKeeper服务
• 测试环境中模拟ZooKeeper单节点或集群部署
• 生产环境中作为ZooKeeper服务的基础镜像，用于构建可靠的分布式协调服务

使用方法

构建镜像

从包含Dockerfile的目录执行以下命令构建镜像：

bash
docker build -t yourusername/zookeeper:3.4.6 .

运行单节点模式

无需额外集群配置，直接运行容器即可启动单节点ZooKeeper：

bash
docker run -d \
  -e SERVICE_NAME=zookeeper \
  -e CONTAINER_NAME=zk-node-0 \
  -p 2181:2181 \
  -v /host/data:/var/lib/zookeeper \
  -v /host/logs:/var/log/zookeeper \
  yourusername/zookeeper:3.4.6

运行集群模式

以3节点集群为例，需为每个节点配置相应环境变量：

节点1（zk-node-0）：

bash
docker run -d \
  -e SERVICE_NAME=zookeeper \
  -e CONTAINER_NAME=zk-node-0 \
  -e ZOOKEEPER_SERVER_IDS=zk-node-0:1,zk-node-1:2,zk-node-2:3 \
  -e ZOOKEEPER_ZK_NODE_0_HOST=host1 \
  -e ZOOKEEPER_ZK_NODE_0_CLIENT_PORT=2181 \
  -e ZOOKEEPER_ZK_NODE_0_PEER_PORT=2888 \
  -e ZOOKEEPER_ZK_NODE_0_LEADER_ELECTION_PORT=3888 \
  -e ZOOKEEPER_ZK_NODE_1_HOST=host2 \
  -e ZOOKEEPER_ZK_NODE_1_CLIENT_PORT=2181 \
  -e ZOOKEEPER_ZK_NODE_1_PEER_PORT=2888 \
  -e ZOOKEEPER_ZK_NODE_1_LEADER_ELECTION_PORT=3888 \
  -e ZOOKEEPER_ZK_NODE_2_HOST=host3 \
  -e ZOOKEEPER_ZK_NODE_2_CLIENT_PORT=2181 \
  -e ZOOKEEPER_ZK_NODE_2_PEER_PORT=2888 \
  -e ZOOKEEPER_ZK_NODE_2_LEADER_ELECTION_PORT=3888 \
  -p 2181:2181 \
  -p 2888:2888 \
  -p 3888:3888 \
  -v /host/data/zk0:/var/lib/zookeeper \
  -v /host/logs/zk0:/var/log/zookeeper \
  yourusername/zookeeper:3.4.6

节点2和节点3需类似配置，修改CONTAINER_NAME及对应端口映射

环境变量说明

基础配置

集群配置

卷说明