liczookeeper/zookeeper

Apache ZooKeeper Docker镜像

镜像概述

Apache ZooKeeper是一个开源的分布式协调服务，旨在解决分布式系统中的一致性问题。本Docker镜像基于官方发布的二进制包构建，包含运行ZooKeeper所需的全部依赖，可快速部署单机或集群模式的ZooKeeper服务，适用于构建可靠的分布式系统。

核心功能与特性

• 分布式协调：提供高效的分布式协调机制，支持集群节点间的状态同步
• 配置管理：集中存储和管理分布式系统的配置信息，实现配置的动态更新
• 命名服务：为分布式系统中的资源提供统一的命名空间
• 分布式锁：支持分布式环境下的互斥锁和读写锁实现
• 集群协调：支持集群节点的加入/退出检测、领导者选举等功能
• 高可用性：支持多节点集群部署，通过Zab协议保证数据一致性和服务可用性

使用场景

• 分布式系统中的服务发现与注册
• 分布式配置中心（如与Spring Cloud Config、Apollo等集成）
• 分布式锁实现（如控制分布式任务的并发执行）
• 集群管理（如Kafka、Hadoop等分布式系统的协调组件）
• 分布式队列和屏障实现

使用方法

基本使用（单机模式）

通过以下命令快速启动一个单机模式的ZooKeeper服务：

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

参数说明：

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

环境变量配置

可通过环境变量自定义ZooKeeper配置：

示例：自定义心跳间隔和最大连接数

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -e ZOO_TICK_TIME=3000 \
  -e ZOO_MAX_CLIENT_CNXNS=100 \
  -v /path/to/data:/data \
  apache/zookeeper:latest

集群模式部署（docker-compose）

使用docker-compose部署3节点ZooKeeper集群：

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:port:port;clientPort，其中第一个port为follower与leader通信端口，第二个port为选举端口

构建与依赖

本镜像基于Apache ZooKeeper官方二进制包（apache-zookeeper-[version]-bin.tar.gz）构建，包含运行所需的全部JAR文件和文档。镜像内置Java 8运行环境（u211及以上版本），满足ZooKeeper的编译和运行要求。

相关资源

• 官方网站：[***]
• 官方文档：[***]
• 贡献指南：[***]