sumglobal/rpi-zookeeper

Apache ZooKeeper镜像（树莓派版）

镜像概述

Apache ZooKeeper是Apache软件基金会的开源项目，为大型分布式系统提供分布式配置服务、同步服务和命名注册功能。本镜像专为树莓派（Raspberry Pi）设备适配，支持单机和集群部署模式。

核心功能

• 分布式配置管理：统一存储和同步分布式系统的配置信息
• 分布式同步：实现分布式锁、屏障等同步机制
• 命名服务：为分布式系统中的节点提供唯一标识和发现能力
• 集群协调：支持多节点集群部署，保证高可用性

使用场景

• 分布式应用的配置中心
• 微服务架构中的服务发现
• 分布式任务调度的协调
• 大数据系统（如Hadoop、Kafka）的依赖组件

配置说明

单机部署

bash
docker run --name some-zookeeper --restart always -d sumglobal/rpi-zookeeper

暴露端口：2181（客户端端口）、2888（follower端口）、3888（选举端口）

集群部署（docker-compose示例）

yaml
version: '2'
services:
    zoo1:
        image: sumglobal/rpi-zookeeper
        restart: always
        ports:
            - 2181:2181
        environment:
            ZOO_MY_ID: 1
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

    zoo2:
        image: sumglobal/rpi-zookeeper
        restart: always
        ports:
            - 2182:2181
        environment:
            ZOO_MY_ID: 2
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

    zoo3:
        image: sumglobal/rpi-zookeeper
        restart: always
        ports:
            - 2183:2181
        environment:
            ZOO_MY_ID: 3
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

执行docker-compose up启动集群，端口2181-2183将被暴露。注意：单机器部署集群无冗余性，生产环境需分布在不同物理机器。

环境变量配置

可通过环境变量覆盖默认配置：

• ZOO_TICK_TIME：基础时间单位（毫秒），默认2000
• ZOO_INIT_LIMIT：follower连接同步到leader的超时时间（tick数），默认5
• ZOO_SYNC_LIMIT：follower与leader同步的超时时间（tick数），默认2
• ZOO_MY_ID：集群节点唯一ID（1-255，集群部署必填）
• ZOO_SERVERS：集群节点列表（集群部署必填，格式如server.id=host:port:port）

数据存储

镜像配置了/data（数据库快照）和/datalog（事务日志）两个卷，建议将事务日志存储在专用设备以提升性能。

许可证

查看https://github.com/apache/zookeeper/blob/release-3.4.10/LICENSE.txt