jeygeethan/zookeeper-cluster

Docker-Zookeeper-Cluster镜像

镜像概述

本镜像旨在简化Zookeeper集群的搭建流程，解决现有单节点镜像无法快速构建多节点集群的问题，支持单主机或多主机环境下的集群部署，操作简单易理解。

核心功能

• 支持单/多主机环境下的Zookeeper集群创建
• 提供数据目录（/var/lib/zookeeper）和日志目录（/var/log/zookeeper）的持久化挂载
• 兼容Docker Swarm/UCP等容器编排工具，可通过节点约束指定部署主机
• 提供简洁的启动命令与Docker Compose配置示例

使用场景

• 分布式系统开发中需要快速搭建Zookeeper协调服务
• 学习Zookeeper集群原理与部署实践
• 构建基于Zookeeper的分布式应用（如Kafka集群）

配置说明

镜像拉取

docker pull jeygeethan/zookeeper-cluster

https://hub.docker.com/r/jeygeethan/zookeeper-cluster/

多主机集群手动部署

通用启动脚本（三节点示例）

docker run -d --restart=always \
      -p 2181:2181 \
      -p 2888:2888 \
      -p 3888:3888 \
      -v /var/lib/zookeeper:/var/lib/zookeeper \
      -v /var/log/zookeeper:/var/log/zookeeper  \
      jeygeethan/zookeeper-cluster [节点主机名/IP列表] [节点ID]

节点1（docker_host_1）启动命令

docker run -d --restart=always \
      -p 2181:2181 \
      -p 2888:2888 \
      -p 3888:3888 \
      -v /var/lib/zookeeper:/var/lib/zookeeper \
      -v /var/log/zookeeper:/var/log/zookeeper  \
      jeygeethan/zookeeper-cluster docker_host_1,docker_host_2,docker_host_3 1

节点2（docker_host_2）启动命令

docker run -d --restart=always \
      -p 2181:2181 \
      -p 2888:2888 \
      -p 3888:3888 \
      -v /var/lib/zookeeper:/var/lib/zookeeper \
      -v /var/log/zookeeper:/var/log/zookeeper  \
      jeygeethan/zookeeper-cluster docker_host_1,docker_host_2,docker_host_3 2

节点3（docker_host_3）启动命令

docker run -d --restart=always \
      -p 2181:2181 \
      -p 2888:2888 \
      -p 3888:3888 \
      -v /var/lib/zookeeper:/var/lib/zookeeper \
      -v /var/log/zookeeper:/var/log/zookeeper  \
      jeygeethan/zookeeper-cluster docker_host_1,docker_host_2,docker_host_3 3

Docker Compose配置示例（多主机集群）

version: '2'
services:
  zk_1:
    image: jeygeethan/zookeeper-cluster
    container_name: zk_1
    ports:
      - '2181:2181'
      - '2888:2888'
      - '3888:3888'
    volumes:
      - /var/lib/zookeeper:/var/lib/zookeeper
      - /var/log/zookeeper:/var/log/zookeeper
    command: docker_host_1,docker_host_2,docker_host_3 1
    environment:
      - constraint:node==docker_host_1
    networks:
      - some_overlay_network
  zk_2:
    image: jeygeethan/zookeeper-cluster
    container_name: zk_2
    ports:
      - '2181:2181'
      - '2888:2888'
      - '3888:3888'
    volumes:
      - /var/lib/zookeeper:/var/lib/zookeeper
      - /var/log/zookeeper:/var/log/zookeeper
    command: docker_host_1,docker_host_2,docker_host_3 2
    environment:
      - constraint:node==docker_host_2
    networks:
      - some_overlay_network
  zk_3:
    image: jeygeethan/zookeeper-cluster
    container_name: zk_3
    ports:
      - '2181:2181'
      - '2888:2888'
      - '3888:3888'
    volumes:
      - /var/lib/zookeeper:/var/lib/zookeeper
      - /var/log/zookeeper:/var/log/zookeeper
    command: docker_host_1,docker_host_2,docker_host_3 3
    environment:
      - constraint:node==docker_host_3
    networks:
      - some_overlay_network
networks:
  some_overlay_network:
    external: true