zookeeperfork/zookeeper

Apache ZooKeeper Docker镜像文档

镜像概述和主要用途

Apache ZooKeeper是由Apache软件基金会开发的开源分布式协调服务，旨在解决分布式系统中的一致性问题。该Docker镜像封装了ZooKeeper服务，提供开箱即用的分布式协调能力，可用于维护配置信息、实现命名服务、分布式同步及组管理等场景，是构建可靠分布式系统的核心组件。

核心功能和特性

• 配置维护：集中存储和管理分布式系统的配置信息，支持动态更新
• 命名服务：为分布式资源提供唯一标识，便于服务发现
• 分布式同步：实现分布式锁、屏障等同步原语，确保跨节点操作的一致性
• 组服务：管理分布式节点组，提供节点加入/离开通知机制
• 高可用性：支持集群部署，通过领导者选举和数据复制保证服务持续可用
• 可靠性：采用ZAB（ZooKeeper Atomic Broadcast）协议保证数据一致性

使用场景和适用范围

• 分布式系统协调：作为Hadoop、Kafka、HBase等分布式系统的协调组件
• 服务发现：帮助微服务架构中的服务实例相互发现和通信
• 配置管理：集中管理应用配置，支持动态配置更新
• 分布式锁：实现跨节点资源互斥访问控制
• 领导者选举：在分布式系统中自动选举主节点
• 元数据存储：存储分布式系统的关键元数据信息

详细使用方法和配置说明

环境要求

• Docker环境（1.13.0+）
• Java 8 u211及以上版本（镜像内置运行时）

Docker部署示例

1. 单机模式（开发测试用）

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \  # 客户端连接端口
  -e ZOO_MY_ID=1 \  # 节点ID（单机模式固定为1）
  -e ZOO_SERVERS=server.1=localhost:2888:3888 \  # 服务器列表
  -v ./zk-data:/data \  # 数据持久化目录
  -v ./zk-datalog:/datalog \  # 事务日志目录
  apache/zookeeper:latest

2. 集群模式（生产环境）

使用docker-compose配置3节点集群：

yaml
version: '3'
services:
  zk1:
    image: apache/zookeeper:latest
    container_name: zk1
    ports:
      - "2181:2181"
    environment:
      ZOO_MY_ID: 1  # 节点唯一ID（1-255）
      ZOO_SERVERS: server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk1/data:/data
      - ./zk1/datalog:/datalog
    restart: always

  zk2:
    image: apache/zookeeper:latest
    container_name: zk2
    ports:
      - "2182:2181"
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk2/data:/data
      - ./zk2/datalog:/datalog
    restart: always

  zk3:
    image: apache/zookeeper:latest
    container_name: zk3
    ports:
      - "2183:2181"
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk3/data:/data
      - ./zk3/datalog:/datalog
    restart: always

启动集群：

bash
docker-compose up -d

核心配置参数说明

环境变量

数据持久化

• /data：存储ZooKeeper数据快照
• /datalog：存储事务日志（建议独立挂载以提升性能）

验证部署

使用ZooKeeper客户端工具连接服务：

bash
# 进入容器执行客户端
docker exec -it zookeeper zkCli.sh -server localhost:2181

# 执行简单命令验证
ls /
create /test "hello zookeeper"
get /test

相关资源

• 官方网站：[***]
• 官方文档：[***]
• 源码仓库：https://github.com/apache/zookeeper
• 贡献指南：[***]