mpidlisnyi/zookeeper Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Apache Zookeeper Docker镜像

镜像概述和主要用途

本镜像克隆自31z4/zookeeper-docker项目，核心目标是解决Alpine基础镜像中resolv.conf文件导致的非FQDN名称解析问题。基于Apache Zookeeper构建，提供分布式配置服务、同步服务和命名注册功能，适用于构建大型分布式系统。

核心功能和特性

• 基于Apache Zookeeper，提供分布式系统的配置管理、同步和命名服务
• 解决Alpine镜像的DNS解析问题，支持非FQDN名称解析
• 支持单机模式和复制模式部署
• 包含默认配置，可通过环境变量或挂载配置文件自定义
• 暴露标准端口（2181客户端端口、2888 follower端口、3888选举端口）

使用场景和适用范围

• 分布式系统的协调服务
• 服务发现与注册
• 分布式锁实现
• 配置中心
• 大数据生态系统（如Kafka、Hadoop）的依赖组件

使用方法和配置说明

启动Zookeeper服务器实例

bash
$ docker run --name some-zookeeper --restart always -d mpidlisnyi/zookeeper

该镜像暴露2181（客户端端口）、2888（follower端口）和3888（选举端口），支持标准容器链接。由于Zookeeper采用"快速失败"机制，建议始终启用自动重启。

从其他Docker容器中的应用连接Zookeeper

bash
$ docker run --name some-app --link some-zookeeper:zookeeper -d application-that-uses-zookeeper

使用Zookeeper命令行客户端连接

bash
$ docker run -it --rm --link some-zookeeper:zookeeper mpidlisnyi/zookeeper zkCli.sh -server zookeeper

使用docker-compose部署

以下是复制模式的docker-compose.yml示例：

yaml
version: '2'
services:
    zoo1:
        image: mpidlisnyi/zookeeper
        restart: always
        ports:
            - 2181:2181
        environment:
            ZOO_MY_ID: 1
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

    zoo2:
        image: mpidlisnyi/zookeeper
        restart: always
        ports:
            - 2182:2181
        environment:
            ZOO_MY_ID: 2
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

    zoo3:
        image: mpidlisnyi/zookeeper
        restart: always
        ports:
            - 2183:2181
        environment:
            ZOO_MY_ID: 3
            ZOO_SERVERS: server.1=zoo1:2888:3888 server.2=zoo2:2888:3888 server.3=zoo3:2888:3888

执行docker-compose up启动复制模式集群，将暴露2181-2183端口。

注意：在单台机器上部署多个Zookeeper服务器无法提供真正的冗余。若主机发生故障，所有服务器将离线。完全冗余需要每台服务器部署在独立的物理机上。

建议在生产环境使用Docker Swarm部署复制模式。

配置

Zookeeper配置文件位于/conf目录。可通过挂载卷的方式自定义配置：

bash
$ docker run --name some-zookeeper --restart always -d -v $(pwd)/zoo.cfg:/conf/zoo.cfg mpidlisnyi/zookeeper

环境变量

若未提供zoo.cfg文件，将使用Zookeeper推荐默认配置，可通过以下环境变量覆盖：

bash
$ docker run -e "ZOO_INIT_LIMIT=10" --name some-zookeeper --restart always -d mpidlisnyi/zookeeper

ZOO_TICK_TIME

• 默认值：2000
• 描述：Zookeeper的滴答时间，单位为毫秒，用于调节心跳和超时时间。例如，最小会话超时为两个滴答时间。

ZOO_INIT_LIMIT

• 默认值：5
• 描述：允许follower连接并同步到leader的时间（以滴答时间为单位）。如果Zookeeper管理的数据量大，可增加此值。

ZOO_SYNC_LIMIT

• 默认值：2
• 描述：允许follower与leader同步的时间（以滴答时间为单位）。如果follower落后leader太多，将被剔除。

复制模式

运行复制模式时，以下环境变量为必填项：

ZOO_MY_ID

• 描述：集群中唯一的服务器ID，取值范围1-255。若/data目录已包含myid文件，此变量无效。

ZOO_SERVERS

• 描述：指定Zookeeper集群的服务器列表，格式为server.id=host:port:port，多个条目用空格分隔。若/conf目录已包含zoo.cfg文件，此变量无效。

数据存储位置

镜像配置了两个卷：

• /data：存储Zookeeper内存数据库快照
• /datalog：存储数据库更新的事务日志

注意：事务日志的存储位置至关重要。专用的事务日志设备是保证良好性能的关键，将日志放在繁忙设备上会影响性能。

许可证

查看镜像中包含软件的许可证信息。