renci/zookeeper

Apache ZooKeeper Docker镜像

镜像概述

本镜像基于CentOS 7和Oracle Java 8构建，提供Apache ZooKeeper的Docker化部署方案，参考了31z4/zookeeper-docker、binarybabel/docker-jdk及krallin/tini-images等项目的实现思路。ZooKeeper是一款分布式协调服务，旨在简化分布式应用的配置管理、同步等复杂问题。

核心功能

• 配置管理：集中维护分布式应用的配置信息，确保所有节点配置一致。
• 命名服务：为分布式系统中的节点提供唯一标识和查找能力。
• 分布式同步：实现分布式锁、屏障等同步机制，保证操作的原子性。
• 组服务：管理分布式节点的状态，支持节点加入/退出的通知机制。

使用场景

• 分布式应用的配置统一管理场景。
• 微服务架构中的服务发现与注册。
• 分布式任务调度中的同步控制。
• 集群节点的状态监控与管理。

配置说明

环境变量（可覆盖默认配置）

• ZOO_TICK_TIME：基础时间单位（毫秒），默认2000。
• ZOO_INIT_LIMIT： follower与leader的初始同步超时（tick数），默认5。
• ZOO_SYNC_LIMIT： follower与leader的同步超时（tick数），默认2。
• ZOO_MAX_CLIENT_CNXNS：单IP最大并发连接数，默认60。
• ZOO_STANDALONE_ENABLED：是否启用 standalone 模式，默认false。
• 复制模式必填变量：
  • ZOO_MY_ID：节点唯一ID（1-255）。
  • ZOO_SERVERS：集群节点列表，格式为server.id=host:port:port。

数据存储

镜像默认将数据快照和事务日志分别存储在/data和/datalog目录，建议通过卷挂载持久化。

部署示例

从Docker Hub拉取镜像

bash
docker pull docker.xuanyuan.run/renci/zookeeper:3.4.11

启动单节点实例

bash
docker run --name some-zookeeper --restart always -d docker.xuanyuan.run/renci/zookeeper:3.4.11

连接ZooKeeper客户端

bash
docker run -it --rm --link some-zookeeper:zookeeper docker.xuanyuan.run/renci/zookeeper:3.4.11 zkCli.sh -server zookeeper

3节点集群部署（docker-compose）

yaml
version: '3.1'
services:
  zoo1:
    image: docker.xuanyuan.run/renci/zookeeper:3.4.11
    restart: always
    hostname: zoo1
    ports:
      - 2181:2181
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888
  zoo2:
    image: docker.xuanyuan.run/renci/zookeeper:3.4.11
    restart: always
    hostname: zoo2
    ports:
      - 2182:2181
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=0.0.0.0:2888:3888 server.3=zoo3:2888:3888
  zoo3:
    image: docker.xuanyuan.run/renci/zookeeper:3.4.11
    restart: always
    hostname: zoo3
    ports:
      - 2183:2181
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=0.0.0.0:2888:3888

执行部署命令：

bash
docker-compose -f stack.yml up -d

注意事项

• 复制模式下，建议每个节点部署在独立物理机以保证冗余性。
• 事务日志应存储在专用设备上以提升性能。
• 镜像遵循Apache ZooKeeper的开源许可协议。