bandsintown/zookeeper

Apache Zookeeper 镜像文档

镜像概述和主要用途

Apache Zookeeper是Apache软件基金会的开源项目，提供分布式配置服务、同步服务和命名注册功能，适用于大型分布式系统。本镜像基于Alpine Linux构建，提供便捷的Zookeeper部署方式，支持单机和复制模式，满足分布式协调需求。

核心功能和特性

• 基于Alpine Linux，镜像体积小，资源占用低
• 支持单机模式与复制模式部署
• 可通过环境变量灵活配置核心参数
• 内置数据卷/data（存储数据库快照）和/datalog（存储事务日志）
• 暴露必要端口：2181（客户端端口）、2888（follower端口）、3888（选举端口）

使用场景和适用范围

适用于需要分布式协调服务的场景，包括：

• 分布式应用的配置管理与同步
• 分布式锁与分布式协调控制
• 服务发现与命名注册
• 大数据处理框架（如Hadoop、Kafka）的协调服务

使用方法和配置说明

启动Zookeeper服务器实例

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

该命令启动一个Zookeeper实例，自动重启功能确保服务稳定性。镜像已配置端口暴露，支持容器链接，使其他容器可自动访问Zookeeper服务。

从应用容器连接Zookeeper

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

通过--link参数将应用容器与Zookeeper容器关联，应用可通过zookeeper主机名访问服务。

从命令行客户端连接

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

使用Zookeeper自带的zkCli.sh客户端连接到运行中的Zookeeper服务。

通过docker-compose部署复制模式集群

以下docker-compose.yml示例部署3节点Zookeeper集群：

yaml
version: '2'
services:
    zoo1:
        image: bandsintown/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: bandsintown/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: bandsintown/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端口。

注意：单台机器部署多节点无法提供真正冗余，建议在生产环境使用独立物理机或Docker Swarm实现高可用。

自定义配置

通过挂载卷覆盖默认配置文件：

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

环境变量配置

未提供自定义zoo.cfg时，可通过环境变量修改默认配置：

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

核心环境变量说明

• ZOO_TICK_TIME
  默认值：2000（毫秒），Zookeeper基本时间单位（滴答时间），用于调节心跳和超时机制（如最小会话超时为2个滴答）。

• ZOO_INIT_LIMIT
  默认值：5（滴答数），允许follower连接并同步到leader的最大时间，数据量大时建议增大此值。

• ZOO_SYNC_LIMIT
  默认值：2（滴答数），允许follower与leader同步的最大时间，超过此时间follower将被剔除。

复制模式必需环境变量

• ZOO_MY_ID
  集群节点唯一标识（1-255），若/data目录已存在myid文件则此变量失效。

• ZOO_SERVERS
  集群节点列表，格式：server.id=host:port:port（多个节点用空格分隔），若/conf目录已存在zoo.cfg则此变量失效。

数据存储

镜像使用以下卷存储关键数据：

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

性能提示：事务日志建议存储在专用设备，避免与其他繁忙IO设备共享，以保证性能。

许可证

查看镜像包含软件的https://github.com/apache/zookeeper/blob/release-3.4.10/LICENSE.txt%E3%80%82