alectolytic/zookeeper

Apache Zookeeper on Fedora 镜像文档

镜像概述

本镜像基于Fedora系统构建，提供Apache Zookeeper分布式协调服务。Zookeeper是一个开源的分布式协调服务，常用于分布式系统中的服务注册、配置管理、分布式锁、集群协调等场景。该镜像支持数据、配置和日志的持久化存储，可通过环境变量和自定义配置文件灵活调整。

核心功能与特性

• 基于Fedora系统：采用Fedora作为基础镜像，提供稳定的运行环境
• 持久化存储：支持配置、数据和日志目录的挂载，确保数据持久化
• 灵活配置：可通过自定义配置文件（如zoo.cfg、log4j.properties）调整Zookeeper参数
• 环境变量支持：提供多个环境变量用于配置Zookeeper运行路径和用户
• 标准端口暴露：默认暴露Zookeeper客户端及集群通信所需端口

使用场景

• 分布式系统中的服务注册与发现
• 分布式配置管理
• 分布式锁实现
• 集群节点协调与选举
• 分布式队列与通知机制

使用方法

拉取镜像

bash
docker pull alectolytic/zookeeper

构建镜像（可选）

如需本地构建镜像：

bash
docker build --tag fedora/zookeeper .

运行容器

bash
# 定义主机目录（需提前创建）
HOST_DATA_DIR=/path/to/data
HOST_CONF_DIR=/path/to/conf
HOST_LOG_DIR=/path/to/log

# 启动容器
docker run \
    -p 2181:2181 \
    -v ${HOST_DATA_DIR}:/var/lib/zookeeper/data \
    -v ${HOST_CONF_DIR}:/var/lib/zookeeper/conf \
    -v ${HOST_LOG_DIR}:/var/lib/zookeeper/log \
    fedora/zookeeper

参数说明：

• -p 2181:2181：映射Zookeeper客户端端口
• -v ${HOST_DATA_DIR}:/var/lib/zookeeper/data：挂载数据目录，持久化Zookeeper数据
• -v ${HOST_CONF_DIR}:/var/lib/zookeeper/conf：挂载配置目录，提供自定义配置文件
• -v ${HOST_LOG_DIR}:/var/lib/zookeeper/log：挂载日志目录，持久化日志文件

配置说明

Zookeeper的配置文件（如zoo.cfg、log4j.properties等）需放置在挂载的配置目录（/var/lib/zookeeper/conf）中。容器启动时会将这些配置文件链接到/etc/zookeeper目录，供启动脚本使用。

常用配置文件说明：

• zoo.cfg：Zookeeper核心配置文件，包含数据目录、客户端端口、集群配置等
• log4j.properties：日志配置文件，控制日志输出级别和格式

环境变量

容器支持以下环境变量配置（完整列表请参考Dockerfile）：

挂载卷

可从主机挂载以下卷以实现持久化和自定义配置：

端口说明

容器暴露以下端口用于通信：