zookeeperdeploye/zookeeper

Apache ZooKeeper 镜像文档

镜像概述

Apache ZooKeeper是一个开源的分布式协调服务，旨在为分布式系统提供高效、可靠的协调机制。它通过维护层次化文件系统结构（ZNode），支持分布式环境下的配置管理、命名服务、分布式锁、同步控制等核心功能，是构建可靠分布式系统的关键组件。

核心功能与特性

• 分布式协调：提供分布式环境下的同步、配置管理和命名服务
• 高可用性：支持集群部署，通过领导者选举和数据复制确保服务持续可用
• 一致性保证：实现强一致性的数据访问，确保所有节点看到相同的数据视图
• 层次化命名空间：采用类似文件系统的树形结构（ZNode）存储数据，支持灵活的数据组织
• 原子操作：所有操作要么完全执行，要么完全不执行，保证数据完整性

使用场景

• 分布式配置管理：集中管理分布式系统的配置信息，实现配置动态更新
• 服务注册与发现：作为服务注册中心，帮助分布式服务发现和通信
• 分布式锁：实现跨节点的分布式锁机制，协调并发访问共享资源
• 领导者选举：在分布式系统中自动选举主节点，确保系统高可用
• 分布式队列：实现跨节点的任务队列，协调分布式任务执行

使用方法

基本部署（单节点模式）

使用以下命令启动单节点ZooKeeper容器：

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

参数说明：

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

环境变量配置

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

• ZOO_MY_ID：节点ID（集群模式下必填，取值1-255）
• ZOO_SERVERS：集群节点列表，格式为server.1=ip1:2888:3888;2181 server.2=ip2:2888:3888;2181 ...
• ZOO_TICK_TIME：基本时间单位（毫秒），默认2000
• ZOO_INIT_LIMIT：follower初始化同步超时时间（tick数），默认10
• ZOO_SYNC_LIMIT：follower与leader同步超时时间（tick数），默认5

集群部署示例（docker-compose）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  zk1:
    image: apache/zookeeper:latest
    container_name: 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: apache/zookeeper:latest
    container_name: 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: apache/zookeeper:latest
    container_name: 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

构建与依赖

• Java版本要求：编译ZooKeeper需使用Java 8 u211及以上版本
• 发布工件：可从https://zookeeper.apache.org/releases.html%E4%B8%8B%E8%BD%BD%E4%BA%8C%E8%BF%9B%E5%88%B6%E5%8C%85%EF%BC%88%60apache-zookeeper-%5Bversion%5D-bin.tar.gz%60%EF%BC%89%EF%BC%8C%E5%8C%85%E5%90%AB%E8%BF%90%E8%A1%8C%E6%89%80%E9%9C%80%E7%9A%84JAR%E6%96%87%E4%BB%B6%E5%92%8C%E6%96%87%E6%A1%A3

贡献指南

欢迎参与ZooKeeper项目贡献，详情请参考https://cwiki.apache.org/confluence/display/ZOOKEEPER/HowToContribute%EF%BC%8C%E4%BA%86%E8%A7%A3%E6%8F%90%E4%BA%A4%E8%A1%A5%E4%B8%81%E5%92%8C%E8%B4%A1%E7%8C%AE%E6%B5%81%E7%A8%8B%E3%80%82