bbvalabs/zookeeper

ZooKeeper Docker镜像

镜像概述和主要用途

本项目旨在创建和使用ZooKeeper Docker镜像，提供便捷的容器化部署方式。镜像包含指定版本的ZooKeeper发行版，并集成了动态配置脚本，支持在运行时通过环境变量自定义配置，适用于各类容器化环境中的分布式协调服务部署。

核心功能和特性

• 版本可控：通过构建参数指定ZooKeeper版本，确保环境一致性
• 动态配置：提供zk_setup.sh脚本，支持基于环境变量动态生成配置文件
• 辅助脚本：包含zk_download.sh（用于下载ZooKeeper发行版）和zk_env.sh（导出环境变量）
• 灵活配置：支持通过环境变量自定义zoo.cfg、log4j.properties和java.env等核心配置文件

构建镜像

构建命令

bash
export ZOO_HOME="/opt/zookeeper"
export ZOO_VERSION="3.4.10"
docker build --build-arg ZOO_VERSION=$ZOO_VERSION --build-arg ZOO_HOME=$ZOO_HOME \
-t engapa/zookeeper:${ZOO_VERSION} .

构建说明

• zk_download.sh脚本负责下载指定版本的ZooKeeper发行版
• 构建后的镜像将在$ZOO_HOME目录下包含完整的ZooKeeper发行版
• 镜像集成了zk_env.sh（导出环境变量）和zk_setup.sh（动态配置ZooKeeper）两个辅助脚本

运行容器

基本运行

容器默认入口点为zk_env.sh，无默认CMD，需用户指定运行命令：

bash
docker run -it -e "SETUP_DEBUG=true" engapa/zookeeper:${ZOO_VERSION}

注意：设置SETUP_DEBUG=true环境变量可查看配置文件的生成过程

动态配置

通过特定前缀的环境变量可动态配置ZooKeeper的核心配置文件，变量名与配置文件的对应关系如下：

配置示例

bash
# 通过环境变量配置日志级别
docker run -it -d -e "LOG4J_log4j_rootLogger=DEBUG, stdout" engapa/zookeeper:3.4.10

# 从文件加载环境变量
docker run -it -d --env-file ./zk.env engapa/zookeeper:3.4.10

# 挂载自定义配置文件（不使用动态配置）
docker run -it -d -v /path/to/custom/zoo.cfg:${ZOO_HOME}/config/zoo.cfg engapa/zookeeper:3.4.10

Kubernetes支持

在镜像的k8s目录中提供了Kubernetes部署资源，基于Kubernetes官方https://github.com/kubernetes/contrib/tree/master/statefulsets/zookeeper%E9%A1%B9%E7%9B%AE%E3%80%82

OpenShift支持

在镜像的openshift目录中提供了OpenShift部署模板，可用于在OpenShift环境中快速部署ZooKeeper。

作者

Enrique Garcia *******