romzookeeperb/zookeeper

Apache ZooKeeper 镜像文档

镜像概述和主要用途

Apache ZooKeeper是一个开源的分布式协调服务，旨在为分布式系统提供高效、可靠的协调机制。该Docker镜像封装了ZooKeeper服务，方便用户快速部署和运行ZooKeeper实例，适用于构建分布式应用中的协调层，支持配置管理、命名服务、分布式锁、集群管理等场景。

核心功能和特性

• 分布式协调：提供分布式系统中的同步、配置管理、命名服务等基础协调能力
• 高可用性：支持集群部署，通过领导者选举机制确保服务持续可用
• 一致性保障：基于ZAB（ZooKeeper Atomic Broadcast）协议保证数据一致性
• 高性能：内存数据模型设计，支持高吞吐量和低延迟的读写操作
• 简单API：提供简洁的API接口，便于集成到各类分布式应用中

使用场景和适用范围

• 分布式配置管理：集中管理分布式应用的配置信息，支持动态更新
• 服务发现：帮助分布式系统中的服务实例注册与发现
• 分布式锁：实现跨节点的分布式锁机制，协调并发操作
• 集群管理：监控集群节点状态，实现节点故障检测与自动恢复
• 分布式队列：构建基于ZooKeeper的分布式队列，协调任务执行顺序

使用方法和配置说明

基本运行（单机模式）

通过以下命令快速启动单机模式的ZooKeeper实例：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -v /path/to/data:/data \
  -v /path/to/datalog:/datalog \
  apache/zookeeper:latest

• -p 2181:2181：映射ZooKeeper客户端端口
• -v /path/to/data:/data：挂载数据目录，持久化存储ZooKeeper数据
• -v /path/to/datalog:/datalog：挂载日志目录，存储事务日志

集群模式部署

使用docker-compose配置ZooKeeper集群（以3节点为例）：

yaml
version: '3'
services:
  zk1:
    image: apache/zookeeper:latest
    container_name: zk1
    ports:
      - "2181:2181"
      - "2888:2888"
      - "3888:3888"
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=zk1:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=zk3:2888:3888;2181
    volumes:
      - ./zk1/data:/data
      - ./zk1/datalog:/datalog

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

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

• ZOO_MY_ID：节点ID，取值范围1-255，集群中唯一
• ZOO_SERVERS：集群节点配置，格式为server.id=host:peerPort:leaderPort;clientPort

环境变量配置

常用环境变量说明：

• ZOO_MY_ID：当前节点ID（集群模式必填）
• ZOO_SERVERS：集群节点列表（集群模式必填）
• ZOO_TICK_TIME：ZooKeeper的基本时间单位（毫秒），默认2000
• ZOO_INIT_LIMIT：follower初始化同步的超时时间（tick数），默认10
• ZOO_SYNC_LIMIT：follower与leader同步的超时时间（tick数），默认5
• ZOO_MAX_CLIENT_CNXNS：最大客户端连接数，默认60

依赖要求

• 运行环境需支持Java 8及以上版本（推荐Java 8 u211或更高版本）
• 集群部署时，各节点间需保证网络互通，开放2181（客户端）、2888（peer通信）、3888（领导者选举）端口