bde2020/zookeeper

Zookeeper Docker镜像文档

镜像概述和主要用途

本Docker镜像提供了Apache Zookeeper的容器化部署方案，基于Zookeeper 3.5.2-alpha版本和Java 1.8.0_72运行环境，适用于构建分布式协调服务集群。镜像设计支持动态配置管理和自动节点ID生成，便于在容器编排平台（如BDE平台）中快速部署和扩展Zookeeper集群。

版本信息：

• Zookeeper版本：3.5.2-alpha
• Java版本：1.8.0_72
• 安装目录：/app（符号链接至/usr/local/apache-zookeeper/current）

核心功能和特性

目录结构

• /app：符号链接至/usr/local/apache-zookeeper/zookeeper-3.5.2-alpha
• /config：符号链接至/usr/local/apache-zookeeper/zookeeper-3.5.2-alpha/conf
• /app/bin/zk-config：用于自动生成myid文件的脚本

关键特性

• 自动myid生成：包含bash脚本（zk-config），可读取zoo.cfg配置并自动创建myid文件（取值1-255），无需手动配置节点ID
• 动态配置支持：兼容Zookeeper 3.5.0+的动态配置文件机制，支持集群节点动态调整
• 灵活部署：支持数据目录映射以实现持久化存储（推荐但非强制）
• 平台兼容性：适配BDE平台，通过hostname或hostname -I命令识别节点身份，自动匹配集群配置

使用场景和适用范围

• 构建分布式系统的协调服务集群
• 在容器编排平台（如Docker Compose、Kubernetes）中部署Zookeeper
• 需要动态调整节点的分布式环境
• BDE（Big Data Europe）平台的分布式组件协调

使用方法和配置说明

基本操作

启动镜像

bash
docker run -i -t bde2020/zookeeper /bin/bash

构建镜像

bash
git clone https://github.com/big-data-europe/docker-zookeeper.git
docker build -t bde2020/zookeeper .

在BDE平台部署Zookeeper集群

前提条件

• 集群包含3个节点（示例中为bde-one.example.com、bde-two.example.com、bde-three.example.com）
• 需准备zoo.cfg（主配置文件）和zoo_replicated1.cfg.dynamic（动态配置文件）

步骤1：扩展镜像

创建Dockerfile以添加自定义配置：

bash
FROM bde2020/zookeeper
ADD zoo.cfg /config/
ADD zoo_replicated1.cfg.dynamic /config/

步骤2：配置文件内容

zoo.cfg（主配置）：

bash
standaloneEnabled=false
dataDir=/tmp/zookeeper
syncLimit=2
initLimit=5
tickTime=2000
dynamicConfigFile=/config/zoo_replicated1.cfg.dynamic

zoo_replicated1.cfg.dynamic（动态配置）：

bash
server.1=bde-one.example.com:31200:31201:participant;31202
server.2=bde-two.example.com:31200:31201:participant;31202
server.3=bde-three.example.com:31200:31201:participant;31202

步骤3：启动集群节点

bash
cd /app/bin && ./zk-config && zkServer.sh start-foreground

Docker Compose部署示例

以下示例基于SC6项目（完整示例见：https://github.com/big-data-europe/pilot-sc6-cycle2%EF%BC%89

扩展镜像Dockerfile

bash
FROM bde2020/zookeeper:latest
ADD zoo.cfg /config/
ADD zoo_replicated1.cfg.dynamic /config/

动态配置文件（zoo_replicated1.cfg.dynamic）

bash
server.1=sc6_zoo_1:31200:31201:participant;31202
server.2=sc6_zoo_2:31200:31201:participant;31202
server.3=sc6_zoo_3:31200:31201:participant;31202

docker-compose.yml配置

bash
services:
  sc6_zoo_1:
    image: "bde2020/sc6-zookeeper"
    ports: 
      - 31200:31200
      - 31201:31201
      - 31202:31202
    container_name: sc6_zoo_1
    command: "bash -c /startup"
    hostname: "sc6_zoo_1"
    environment:
      - "constraint:node==host-one.your-cluster.net"
  sc6_zoo_2:
    image: "bde2020/sc6-zookeeper"
    ports:
      - 31200:31200
      - 31201:31201
      - 31202:31202
    container_name: sc6_zoo_2
    command: "bash -c /startup"
    hostname: "sc6_zoo_2"
    environment:
      - "constraint:node==host-two.your-cluster.net"
  # 省略sc6_zoo_3配置...

说明：启动脚本会自动识别当前节点的主机名/IP，在动态配置文件中匹配对应条目，生成myid文件并启动Zookeeper服务。