withsin/zookeeper

docker-zookeeper

镜像概述

本镜像包含Apache ZooKeeper 3.4.8版本，封装为Docker容器化部署形式。ZooKeeper是一个分布式协调服务，为分布式系统提供高效、可靠的协调机制，常用于解决分布式环境下的一致性问题。

核心功能和特性

• 分布式协调：提供分布式系统中的同步、配置管理、命名服务等基础协调能力
• 高可靠性：基于ZAB（ZooKeeper Atomic Broadcast）协议保证数据一致性
• 简单易用：容器化部署简化安装配置流程，开箱即可使用
• 版本稳定：基于Apache ZooKeeper 3.4.8稳定版本构建

使用场景和适用范围

• 分布式系统中的配置中心
• 微服务架构下的服务注册与发现
• 分布式锁实现
• 分布式队列管理
• 大数据处理框架（如Hadoop、Kafka）的协调组件

使用方法和配置说明

基本运行

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

bash
docker run -d -p 2181:2181 --name zookeeper docker.xuanyuan.run/zookeeper:3.4.8

持久化数据

为保证数据持久化，可挂载数据卷：

bash
docker run -d -p 2181:2181 -v /host/path/to/data:/data --name zookeeper docker.xuanyuan.run/zookeeper:3.4.8

环境变量配置

支持以下常用环境变量配置：

示例：自定义端口和数据目录

bash
docker run -d -p 2182:2182 -e ZOO_PORT=2182 -e ZOO_DATA_DIR=/zkdata -v /host/path/to/zkdata:/zkdata --name zookeeper docker.xuanyuan.run/zookeeper:3.4.8

集群部署（docker-compose示例）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  zk1:
    image: docker.xuanyuan.run/zookeeper:3.4.8
    ports:
      - "2181:2181"
    environment:
      - ZOO_MY_ID=1
      - ZOO_SERVERS=server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk1/data:/data
      - ./zk1/datalog:/datalog

  zk2:
    image: docker.xuanyuan.run/zookeeper:3.4.8
    ports:
      - "2182:2181"
    environment:
      - ZOO_MY_ID=2
      - ZOO_SERVERS=server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk2/data:/data
      - ./zk2/datalog:/datalog

  zk3:
    image: docker.xuanyuan.run/zookeeper:3.4.8
    ports:
      - "2183:2181"
    environment:
      - ZOO_MY_ID=3
      - ZOO_SERVERS=server.1=zk1:2888:3888 server.2=zk2:2888:3888 server.3=zk3:2888:3888
    volumes:
      - ./zk3/data:/data
      - ./zk3/datalog:/datalog

启动集群：

bash
docker-compose up -d