misakai/zookeeper

ZooKeeper Docker镜像文档

镜像概述

ZooKeeper是一个集中式服务，主要用于维护配置信息、提供命名服务、实现分布式同步及组服务。这些服务在分布式应用中以各种形式被广泛使用。由于实现这类服务存在较高难度（如修复不可避免的bug和竞争条件），应用初期往往会简化实现，导致系统在变更时脆弱且难以管理；即使实现正确，不同服务实现也会增加应用部署后的管理复杂度。

了解更多关于ZooKeeper的信息，请访问http://zookeeper.apache.org/%E3%80%82

核心功能与特性

• 配置信息维护：集中管理分布式应用的配置数据，确保配置一致性
• 命名服务：为分布式系统中的资源（如服务、节点）提供唯一标识和查找能力
• 分布式同步：提供分布式锁、屏障等同步原语，协调分布式环境中的并发操作
• 组服务：管理分布式系统中的节点组，支持节点加入/离开通知及组状态维护

使用场景与适用范围

ZooKeeper适用于各类需要协调和管理的分布式系统，典型场景包括：

• 分布式协调：如分布式锁、领导者选举
• 服务发现：帮助服务消费者定位可用服务实例
• 配置管理：集中存储和动态更新应用配置
• 分布式队列：实现跨节点的任务排队和处理

使用方法与配置说明

基本运行（单机模式）

通过以下命令启动单机版ZooKeeper容器：

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \  # 客户端连接端口
  -p 2888:2888 \  # 集群内通信端口（集群模式使用）
  -p 3888:3888 \  # 选举端口（集群模式使用）
  zookeeper

环境变量配置

常用环境变量说明：

• ZOO_MY_ID：节点ID（集群模式必填，取值1-255）
• ZOO_SERVERS：集群节点列表，格式为server.id=host:port:port，如server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181
• ZOO_4LW_COMMANDS_WHITELIST：白名单化四字命令，默认允许srvr, mntr, ruok

集群模式示例（docker-compose）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  zoo1:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo1
    ports:
      - "2181:2181"
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo2:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo2
    ports:
      - "2182:2181"
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo3:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo3
    ports:
      - "2183:2181"
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

启动集群：

bash
docker-compose up -d