zookeepershz/zookeeper

Apache ZooKeeper Docker镜像文档

镜像概述

Apache ZooKeeper是一个开源的分布式协调服务，为分布式系统提供高效、可靠的协调能力。该Docker镜像封装了ZooKeeper服务，便于快速部署和运行，支持单机和集群模式，适用于需要分布式协调的应用场景。最新信息可访问官方网站：[***]

核心功能与特性

• 分布式协调：提供配置管理、命名服务、分布式锁、集群管理等核心协调能力
• 一致性保证：基于ZAB（ZooKeeper Atomic Broadcast）协议，确保分布式数据一致性
• 高可用架构：支持集群部署，通过leader-follower机制实现故障自动转移
• 多语言支持：提供Java、C、Python等多种编程语言的API接口
• 可扩展性：支持动态扩容，适应不同规模的分布式系统需求

使用场景与适用范围

• 分布式配置管理：集中管理分布式应用配置，支持配置动态更新
• 服务发现：实现分布式系统中服务的注册与发现
• 分布式锁：提供分布式环境下的互斥锁机制，保证资源有序访问
• 集群监控：监控集群节点状态，管理节点加入/退出
• 分布式队列：实现FIFO等模式的分布式任务队列

使用方法与配置说明

前提条件

• Docker Engine 1.13.0及以上版本
• 集群模式需确保节点间网络互通

快速启动（单机模式）

使用以下命令启动ZooKeeper单机实例：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  zookeeper:latest

参数说明：

• -d：后台运行容器
• --name zookeeper：指定容器名称
• -p 2181:2181：映射ZooKeeper客户端端口（默认2181）
• zookeeper:latest：使用最新版本镜像

集群模式部署（docker-compose）

创建docker-compose.yml配置3节点集群：

yaml
version: '3'
services:
  zk1:
    image: zookeeper:latest
    container_name: zk1
    ports:
      - "2181:2181"
    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: zookeeper:latest
    container_name: zk2
    ports:
      - "2182:2181"
    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: zookeeper:latest
    container_name: zk3
    ports:
      - "2183:2181"
    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

启动集群：

bash
docker-compose up -d

环境变量配置

数据持久化

通过挂载卷实现数据持久化：

• /data：存储ZooKeeper数据
• /datalog：存储事务日志

访问ZooKeeper服务

使用zkCli.sh工具连接服务：

bash
docker exec -it zookeeper zkCli.sh -server localhost:2181

相关资源

• 官方发布包下载：[***]
• Maven仓库：[***]
• 贡献指南：[***]