fixzookeepery/zookeeper

Apache ZooKeeper Docker镜像

镜像概述和主要用途

Apache ZooKeeper是一个开源的分布式协调服务，旨在为分布式系统提供可靠的协调机制。它通过维护简单的数据结构（如znodes）和提供原子性操作，帮助分布式应用实现配置管理、服务发现、分布式锁、集群管理等核心功能。该Docker镜像封装了ZooKeeper运行环境，便于快速部署和集成到分布式系统中。

核心功能和特性

• 分布式协调：提供分布式锁、选举、屏障等同步原语，确保分布式系统中各节点的协调一致。
• 配置管理：集中存储和管理分布式应用的配置信息，支持动态更新和通知。
• 命名服务：为分布式系统中的资源（如服务、节点）提供唯一命名和查找能力。
• 集群管理：监控集群节点状态，自动检测节点上线/下线，支持集群动态扩展。
• 高可用性：通过Leader-Follower架构实现数据复制和故障转移，确保服务持续可用。
• 高性能：基于内存数据模型和高效的网络通信，支持高并发读写操作。

使用场景和适用范围

• 分布式应用配置中心：集中管理微服务架构中的配置参数，实现配置热更新。
• 服务发现：作为注册中心，帮助服务消费者发现可用的服务提供者。
• 分布式锁：解决分布式环境下的资源竞争问题，如分布式任务调度、并发控制。
• 集群协调：管理分布式集群（如Kafka、Hadoop）的节点状态和元数据。
• 分布式事务：提供简单的事务协调能力，确保跨节点操作的一致性。

使用方法和配置说明

基本使用（单机模式）

通过以下命令快速启动单机版ZooKeeper容器：

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

集群模式部署（使用docker-compose）

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

yaml
version: '3'
services:
  zk1:
    image: docker.xuanyuan.run/zookeeper:latest
    container_name: zk1
    ports:
      - "2181:2181"
      - "2888:2888"
      - "3888:3888"
    environment:
      ZOO_MY_ID: 1  # 节点ID，唯一标识集群中的节点
      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: docker.xuanyuan.run/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: docker.xuanyuan.run/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

启动集群：

bash
docker-compose up -d

环境变量配置

配置文件自定义

ZooKeeper核心配置文件为zoo.cfg，可通过挂载本地配置文件覆盖容器内默认配置：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -v /path/to/local/zoo.cfg:/conf/zoo.cfg \  # 挂载自定义配置文件
  -v /path/to/data:/data \
  -v /path/to/datalog:/datalog \
  zookeeper:latest

注意事项

• Java环境：ZooKeeper运行依赖Java环境，镜像已内置Java 8（需u211或更高版本）。
• 数据持久化：生产环境中需挂载/data和/datalog目录，避免容器重启导致数据丢失。
• 集群规模：推荐集群节点数为奇数（3、5、7等），以确保选举机制正常工作。
• 版本选择：建议使用稳定版本（如3.8.x系列），可通过zookeeper:3.8指定具体版本。

更多信息请访问官方网站：http://zookeeper.apache.org/ 或官方wiki：https://cwiki.apache.org/confluence/display/ZOOKEEPER%E3%80%82