intzookeeperc/zookeeper

Apache ZooKeeper Docker镜像

镜像概述和主要用途

Apache ZooKeeper是一个开源的分布式协调服务，旨在为分布式应用提供高性能、高可用的协调机制。它通过维护层次化的命名空间（类似文件系统），支持配置管理、命名服务、分布式锁、分布式同步等核心功能，广泛应用于Hadoop、Kafka、Solr等大型分布式框架的协调组件。

核心功能和特性

• 分布式协调：提供可靠的分布式同步机制，支持分布式锁、屏障等协调原语
• 配置管理：集中存储和管理分布式系统配置信息，实现配置动态更新
• 命名服务：为分布式系统节点提供唯一命名，便于服务发现
• 组服务：维护分布式节点状态信息，支持节点加入/离开通知
• 高可用性：通过集群部署（通常3-5个节点）实现高可用，支持自动故障转移
• 一致性保证：基于ZAB协议提供强一致性的数据访问

使用场景和适用范围

• 分布式系统协调：如Hadoop namenode选举、Kafka分区领导者选举
• 服务发现：微服务架构中服务实例的注册与发现
• 分布式锁：保证分布式环境下资源的互斥访问
• 配置中心：集中管理应用配置，支持配置实时推送
• 集群管理：监控集群节点状态，实现故障检测与自动恢复

使用方法和配置说明

环境要求

• Docker Engine 1.13+
• Java 8运行环境（推荐u211或更高版本，用于容器内运行）

获取镜像

通过Docker Hub获取官方镜像：

bash
docker pull zookeeper:latest

基本运行命令（单节点模式）

适用于开发/测试环境：

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

• -d：后台运行容器
• --name zookeeper：指定容器名称
• -p 2181:2181：映射ZooKeeper客户端端口（默认2181）

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

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

yaml
version: '3'
services:
  zk1:
    image: zookeeper:latest
    restart: always
    hostname: 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
    restart: always
    hostname: 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
    restart: always
    hostname: 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

关键配置参数（环境变量）

• ZOO_MY_ID：节点ID（1-255），集群模式必填，每个节点唯一
• ZOO_SERVERS：集群节点配置，格式为server.id=host:port1:port2;clientPort，其中port1为follower与leader通信端口，port2为选举端口
• ZOO_CLIENT_PORT：客户端连接端口（默认2181）
• ZOO_TICK_TIME：基本时间单位（毫秒，默认2000），用于心跳和会话超时计算

数据持久化

通过挂载卷将数据目录（/data）和日志目录（/datalog）映射到宿主机，避免容器重启数据丢失：

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

构建说明（自定义镜像）

基于官方源码包构建（从ZooKeeper发布页下载apache-zookeeper-[version]-bin.tar.gz）：

dockerfile
FROM openjdk:8-jre
WORKDIR /zookeeper
COPY apache-zookeeper-[version]-bin.tar.gz .
RUN tar -zxf apache-zookeeper-[version]-bin.tar.gz --strip-components=1 && rm apache-zookeeper-[version]-bin.tar.gz
EXPOSE 2181 2888 3888
CMD ["bin/zkServer.sh", "start-foreground"]

贡献指南

欢迎参与项目贡献，详情参考如何贡献，包括提交补丁、Pull Request流程等。