muxzookeeperv/zookeeper

Apache ZooKeeper Docker镜像文档

!ZooKeeper

镜像概述和主要用途

Apache ZooKeeper是由Apache软件基金会开发的分布式协调服务，旨在解决分布式系统中的一致性问题。该Docker镜像封装了ZooKeeper服务，提供开箱即用的分布式协调能力，适用于构建需要可靠配置管理、服务发现、分布式锁和集群协调的分布式应用。

最新信息请访问官方网站：[]
项目文档请参考Wiki：[]

核心功能和特性

核心功能

• 配置维护：集中管理分布式系统的配置信息，实现配置的动态更新与同步
• 命名服务：提供分布式命名服务，便于服务发现和资源定位
• 分布式同步：支持分布式锁、屏障等同步原语，协调分布式进程
• 组服务：维护集群节点的状态信息，实现节点上下线监控
• 原子操作：保证数据操作的原子性，确保分布式环境下的数据一致性

主要特性

• 高可用性：支持集群部署，通过Leader-Follower机制实现故障自动转移
• 一致性保证：遵循ZAB（ZooKeeper Atomic Broadcast）协议，提供强一致性
• 层次化命名空间：采用类似文件系统的树形结构组织数据节点（znode）
• 可观测性：提供完整的监控指标和日志，支持问题诊断与性能优化
• 可扩展性：支持动态扩容，适应业务增长需求

使用场景和适用范围

典型使用场景

• 分布式系统配置中心：集中管理微服务配置，实现配置热更新
• 服务发现：注册服务实例信息，供客户端动态发现可用服务
• 分布式锁：实现跨节点资源竞争的同步控制
• 集群管理：监控集群节点状态，实现集群成员管理和故障检测
• 分布式队列：实现跨节点的任务排队和处理协调

适用范围

• 中小型分布式系统的协调需求
• 需要强一致性保证的分布式应用
• 微服务架构中的服务治理
• 大数据处理框架（如Hadoop、Kafka）的依赖组件

使用方法和配置说明

基本使用（单节点模式）

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  apache/zookeeper:latest

环境变量配置

集群部署示例（3节点）

使用docker-compose部署ZooKeeper集群：

yaml
version: '3'
services:
  zk1:
    image: apache/zookeeper:latest
    container_name: zk1
    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"
    ports:
      - "2181:2181"
    volumes:
      - ./zk1/data:/data
      - ./zk1/datalog:/datalog

  zk2:
    image: apache/zookeeper:latest
    container_name: zk2
    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"
    ports:
      - "2182:2181"
    volumes:
      - ./zk2/data:/data
      - ./zk2/datalog:/datalog

  zk3:
    image: apache/zookeeper:latest
    container_name: zk3
    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"
    ports:
      - "2183:2181"
    volumes:
      - ./zk3/data:/data
      - ./zk3/datalog:/datalog

数据持久化

通过挂载卷实现数据持久化，避免容器重启后数据丢失：

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

注意事项

• Java环境要求：镜像基于Java 8构建，推荐使用u211及以上版本以确保兼容性
• 集群配置：集群模式下需确保各节点间网络互通，ZOO_MY_ID需唯一且与ZOO_SERVERS配置对应
• 资源配置：根据集群规模调整CPU和内存资源，建议生产环境每个节点至少2GB内存
• 安全配置：生产环境需启用认证和授权机制，可通过挂载自定义zoo.cfg实现高级配置

相关资源

• 官方文档：[***]
• 镜像下载：https://hub.docker.com/r/apache/zookeeper
• 贡献指南：[***]