garland/zookeeper

Zookeeper Docker镜像文档

镜像概述

本镜像基于https://github.com/jplock/docker-zookeeper%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84Apache Zookeeper分布式协调服务部署方案。Zookeeper是一个高性能的分布式协调服务，常用于分布式系统中的配置管理、命名服务、分布式锁和集群管理等场景。

核心功能与特性

• 分布式协调：提供可靠的分布式协调机制，支持分布式系统中的同步、配置管理和命名服务
• 高可用性：支持集群模式部署，通过 Zab 协议保证数据一致性和服务可用性
• 轻量级部署：基于Docker容器化部署，简化环境配置和版本管理
• 灵活配置：支持通过环境变量自定义Zookeeper配置，适应不同场景需求
• 数据持久化：支持数据卷挂载，确保服务重启后数据不丢失

使用场景

• 分布式系统中的服务注册与发现
• 微服务架构中的配置中心
• 大数据处理框架（如Hadoop、Kafka、Flink）的依赖协调服务
• 分布式锁实现（如分布式任务调度、资源竞争控制）
• 集群节点状态监控与管理

使用方法与配置说明

基本使用（单机模式）

通过以下命令快速启动单机版Zookeeper服务：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \  # 客户端连接端口
  -p 2888:2888 \  # 集群内通信端口（ follower 连接 leader ）
  -p 3888:3888 \  # 集群选举端口
  jplock/zookeeper

环境变量配置

集群模式部署（docker-compose示例）

创建docker-compose.yml文件，配置3节点Zookeeper集群：

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

  zk2:
    image: jplock/zookeeper
    container_name: zk2
    ports:
      - "2182:2181"
      - "2889:2888"
      - "3889:3888"
    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

  zk3:
    image: jplock/zookeeper
    container_name: zk3
    ports:
      - "2183:2181"
      - "2890:2888"
      - "3890:3888"
    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

启动集群：

bash
docker-compose up -d

数据持久化

为避免容器重启导致数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -v /path/to/local/data:/data \  # 持久化ZooKeeper数据
  -v /path/to/local/datalog:/datalog \  # 持久化事务日志
  jplock/zookeeper

验证服务

通过Zookeeper客户端连接验证服务状态：

bash
docker exec -it zookeeper zkCli.sh

连接成功后可执行ls /等命令查看根节点信息。