masterzookeeperdu/zookeeper

Apache ZooKeeper 镜像文档!https://zookeeper.apache.org/images/zookeeper_small.gif "ZooKeeper"## 镜像概述Apache ZooKeeper是一个开源的分布式协调服务，旨在为分布式系统提供高效、可靠的协调机制。它通过维护一个简单的层次化文件系统结构（类似Linux文件系统），实现分布式环境下的配置管理、命名服务、分布式锁、集群管理等核心功能，确保分布式系统的一致性和可用性。

核心功能与特性-** 分布式协调 **：提供分布式环境下的同步、协调机制，支持分布式锁、屏障等原语

-** 一致性服务 ：基于ZAB（ZooKeeper Atomic Broadcast）协议保证数据一致性，支持顺序一致性和原子性操作 - 高可用架构 ：支持集群部署，通过Leader-Follower模式实现故障自动转移，确保服务持续可用 - 简单API ：提供简洁的文件系统操作接口（创建、删除、读取、更新节点等），易于集成到应用中 - 数据持久化 **：支持数据持久化存储，确保服务重启后数据不丢失

使用场景-** 配置管理 **：集中管理分布式系统的配置信息，实现配置动态更新

-** 服务发现 ：作为服务注册中心，帮助分布式系统中的服务找到彼此 - 分布式锁 ：实现跨进程、跨节点的分布式锁，解决并发资源竞争问题 - 集群管理 ：监控集群节点状态，实现节点加入/退出的动态感知 - 命名服务 **：为分布式系统中的资源（如服务、节点）提供唯一命名

镜像获取### 官方镜像可通过Docker Hub获取官方镜像：```bash

docker pull docker.xuanyuan.run/apache/zookeeper:latest 也可指定具体版本（如3.8.0）：bash docker pull docker.xuanyuan.run/apache/zookeeper:3.8.0 ### 本地构建若需基于源码构建，可从https://zookeeper.apache.org/releases.html下载源码包（`apache-zookeeper-[version].tar.gz`），通过Maven构建后制作镜像：bash

解压源码包

tar -zxvf apache-zookeeper-[version].tar.gz cd apache-zookeeper-[version]

构建项目

mvn clean install

生成API文档（可选）

mvn javadoc:aggregate # 文档生成在target/site/apidocs目录

## 使用方法### 基本单机运行```bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \  # 客户端连接端口
  -p 2888:2888 \  # 集群内通信端口（Leader选举）
  -p 3888:3888 \  # 集群内通信端口（Leader选举）
  -v /path/to/local/data:/data \  # 数据持久化目录
  -v /path/to/local/datalog:/datalog \  # 事务日志目录
  apache/zookeeper:latest
```### 集群配置（3节点示例）创建`docker-compose.yml`文件：```yaml
version: '3'
services:
  zk1:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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: docker.xuanyuan.run/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
```启动集群：```bash
docker-compose up -d

配置参数### 环境变量| 变量名 | 描述 | 默认值 |

|--------|------|--------| | ZOO_MY_ID | 节点ID（集群模式必填，1-255） | - | | ZOO_SERVERS | 集群节点列表，格式：server.id=host:port:port;clientPort | - | | ZOO_PORT | 客户端连接端口 | 2181 | | ZOO_TICK_TIME | 心跳间隔（毫秒） | 2000 | | ZOO_INIT_LIMIT | 初始同步阶段超时时间（tick数） | 10 | | ZOO_SYNC_LIMIT | 同步阶段超时时间（tick数） | 5 |

配置文件挂载如需自定义配置，可挂载本地zoo.cfg文件到容器/conf/zoo.cfg路径：```bash

docker run -d
--name zookeeper
-v /path/to/local/zoo.cfg:/conf/zoo.cfg
-v /path/to/data:/data
docker.xuanyuan.run/apache/zookeeper:latest

## 系统要求-** Java环境 **：运行需Java 8及以上版本，推荐使用Java 8 u211或更高版本
-** 内存 **：根据集群规模调整，单机模式建议至少512MB内存
-** 存储 **：数据和日志目录建议使用持久化存储，避免数据丢失

## 更多信息- 官方网站：https://zookeeper.apache.org
- 官方文档：https://cwiki.apache.org/confluence/display/ZOOKEEPER
- Maven中央仓库：https://repo1.maven.org/maven2/org/apache/zookeeper/zookeeper

## 贡献指南欢迎参与项目贡献，详情请参考https://cwiki.apache.org/confluence/display/ZOOKEEPER/HowToContribute。