cybermaggedon/zookeeper

Zookeeper Docker镜像文档

镜像概述

本镜像提供Apache Zookeeper分布式协调服务的容器化部署，支持独立模式、数据持久化及集群部署，便于快速搭建可靠的分布式协调环境。

核心功能与特性

• 独立模式运行：快速启动单节点Zookeeper服务
• 数据持久化：支持通过卷挂载实现数据持久化存储
• 集群部署：支持多节点集群配置，满足高可用需求
• 灵活配置：通过环境变量自定义集群节点和节点ID

使用场景

• 分布式系统的配置管理
• 服务注册与发现
• 分布式锁实现
• 分布式协调与同步
• 命名服务

使用方法

1. 独立非持久化模式

快速启动单节点Zookeeper服务，数据仅保存在容器内部，容器销毁后数据丢失：

bash
docker run -p 2181:2181 cybermaggedon/zookeeper:3.6.1

2. 持久化模式

通过挂载卷到/data目录实现数据持久化：

bash
docker run -p 2181:2181 -v /data/zookeeper:/data cybermaggedon/zookeeper:3.6.1

3. 集群模式部署

需创建专用网络并配置固定IP，通过环境变量指定集群节点和当前节点ID：

1. 创建专用网络：

bash
docker network create --driver=bridge --subnet=10.10.10.0/24 my-zk-network

2. 启动第一个节点（ID=1）：

bash
docker run --rm --ip=10.10.10.10 --net my-zk-network \
  -e ZOOKEEPERS=10.10.10.10,10.10.10.11,10.10.10.12 \
  -e ZOOKEEPER_MYID=1 \
  --name zk1 -p 2181:2181 cybermaggedon/zookeeper:3.6.1

3. 启动第二个节点（ID=2）：

bash
docker run --rm -i -t --ip=10.10.10.11 --net my-zk-network \
  -e ZOOKEEPERS=10.10.10.10,10.10.10.11,10.10.10.12 \
  -e ZOOKEEPER_MYID=2 --name zk2 --link zk1:zk1 \
  cybermaggedon/zookeeper:3.6.1

4. 启动第三个节点（ID=3）：

bash
docker run --rm -i -t --ip=10.10.10.12 --net my-zk-network \
  -e ZOOKEEPERS=10.10.10.10,10.10.10.11,10.10.10.12 \
  -e ZOOKEEPER_MYID=3 --name zk3 --link zk1:zk1 \
  cybermaggedon/zookeeper:3.6.1

环境变量说明

• ZOOKEEPERS：集群所有节点的IP地址列表，用逗号分隔（如10.10.10.10,10.10.10.11,10.10.10.12）
• ZOOKEEPER_MYID：当前节点在集群中的唯一ID（整数，如1、2、3）

源码地址

http://github.com/cybermaggedon/zookeeper-docker