yaronr/zookeeper

Zookeeper Docker镜像文档

镜像概述

本镜像为Zookeeper v3.4.7版本，体积仅242M，专为CoreOS环境设计，可结合SkyDNS或Weave实现服务发现，同时也适用于其他Docker部署场景。镜像默认配置支持3节点Zookeeper集群（zoo1-zoo3），使用标准端口，可通过目录映射自定义配置。

核心功能与特性

• 轻量高效：镜像体积仅242M，资源占用低
• 版本明确：基于Zookeeper v3.4.7稳定版本
• CoreOS支持：原生支持CoreOS环境，兼容SkyDNS和Weave服务发现工具
• 灵活配置：支持通过目录映射（-v）替换zoo.cfg配置文件
• 服务发现集成：内置与SkyDNS/Weave的集成配置，简化服务注册流程

使用场景

• CoreOS环境下的分布式服务发现
• 需要轻量级Zookeeper集群的开发/测试环境
• 基于Docker的多节点Zookeeper部署

使用方法

前提条件

• 已安装Docker环境
• 对于CoreOS环境，需提前部署SkyDNS或Weave网络

与SkyDNS配合使用

通过Systemd服务配置示例：

bash
Environment="CONTAINER_NAME=zoo%i"

ExecStart=/bin/bash -c  ' \
  bridge_ip="$(ifconfig docker0 | grep \'inet \' | awk \'{ print $2}\')" && \
  /usr/bin/docker run \
  --name=${CONTAINER_NAME} \
  --hostname ${CONTAINER_NAME}.multicloud.local \
  -e ZOOKEEPER_ID=%i \
  -p 2888:2888 -p 3888:3888 -p 2181:2181 \
  --dns=$bridge_ip \
  --dns-search multicloud.local \
  -e "SERVICE_2888_NAME=${CONTAINER_NAME}" \
  -e "SERVICE_3888_NAME=${CONTAINER_NAME}" \
  -e "SERVICE_2181_NAME=${CONTAINER_NAME}" \ 
  yaronr/zookeeper:latest '

参数说明：

• CONTAINER_NAME：容器名称，%i会被替换为节点编号（如zoo1、zoo2）
• ZOOKEEPER_ID：Zookeeper节点ID，需设置为唯一整数
• 端口映射：2181（客户端端口）、2888（ follower端口）、3888（选举端口）
• --dns：指定Docker桥接IP作为DNS服务器
• --dns-search：设置DNS搜索域为multicloud.local

与Weave配合使用

通过Systemd服务配置示例：

bash
ExecStart=/bin/bash -c  ' \
  bridge_ip="$(ifconfig docker0 | grep \'inet \' | awk \'{ print $2}\')" && \
  /usr/bin/docker run \
  --name=${CONTAINER_NAME} \
  --hostname=${CONTAINER_NAME}.weave.local \
  -e ZOOKEEPER_ID=%i \
  --rm \
  -p 2888:2888 -p 3888:3888 -p 2181 \
  --dns=$bridge_ip \
  --dns-search=weave.local \
  ${IMAGE_NAME}:latest '

额外要求：

使用Weave时，需配合sidekick unit执行weave attach命令，为容器分配IP并在Weave中注册DNS条目。详细配置方法可参考multicloud.io博客（即将发布）。

注意事项

1. 配置自定义：推荐通过-v参数映射本地zoo.cfg文件替换默认配置，以适应特定集群需求
2. 节点数量：默认配置假设3个Zookeeper节点（zoo1-zoo3），生产环境需根据实际规模调整
3. DNS解析：Dockerfile中设置了解析器忽略/etc/hosts，此配置对服务发现至关重要
4. 网络配置：bridge_ip变量获取docker0桥接接口IP，非强制配置，可根据实际网络环境调整