hivecell/zookeeper

ARM64 Zookeeper 镜像文档

镜像概述

本镜像基于 https://github.com/31z4/zookeeper-docker 项目构建，提供适用于ARM64架构的Apache Zookeeper服务。Zookeeper是一个分布式协调服务，常用于分布式系统中的服务注册与发现、配置管理、分布式锁等场景。本镜像支持Zookeeper 3.5的复制模式，包含默认配置与灵活的自定义配置选项。

核心功能与特性

• 多模式支持：支持独立模式（Standalone）和复制模式（Replicated）部署
• 端口暴露：默认暴露2181（客户端端口）、2888（ follower端口）、3888（选举端口）、8080（AdminServer端口）
• 持久化存储：配置/data（快照存储）和/datalog（事务日志存储）卷，确保数据持久化
• 灵活配置：支持通过环境变量或挂载自定义配置文件进行配置
• 日志管理：默认输出日志到控制台，可通过环境变量重定向至文件
• 自动重启：推荐配置--restart always确保服务故障后自动恢复

使用场景

• ARM64架构环境下的分布式系统协调服务
• 容器化部署的分布式应用（如Kafka、Hadoop等）的依赖服务
• 需要高可用配置的Zookeeper集群搭建
• 开发测试环境中的Zookeeper快速部署

使用方法

启动独立模式Zookeeper实例

console
$ docker run --name some-zookeeper --restart always -d %%IMAGE%%

由于Zookeeper采用"快速失败"机制，建议始终配置--restart always确保服务稳定性。

从其他容器连接Zookeeper

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

使用Zookeeper命令行客户端连接

console
$ docker run -it --rm --link some-zookeeper:zookeeper %%IMAGE%% zkCli.sh -server zookeeper

部署复制模式集群

使用Docker Compose/Stack部署

创建stack.yml文件：

yaml
version: '3'
services:
  zoo1:
    image: %%IMAGE%%
    restart: always
    hostname: zoo1
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
    ports:
      - "2181:2181"
    volumes:
      - zoo1-data:/data
      - zoo1-datalog:/datalog

  zoo2:
    image: %%IMAGE%%
    restart: always
    hostname: zoo2
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
    ports:
      - "2182:2181"
    volumes:
      - zoo2-data:/data
      - zoo2-datalog:/datalog

  zoo3:
    image: %%IMAGE%%
    restart: always
    hostname: zoo3
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
    ports:
      - "2183:2181"
    volumes:
      - zoo3-data:/data
      - zoo3-datalog:/datalog

volumes:
  zoo1-data:
  zoo1-datalog:
  zoo2-data:
  zoo2-datalog:
  zoo3-data:
  zoo3-datalog:

部署命令：

console
$ docker stack deploy -c stack.yml %%REPO%%  # Docker Swarm环境
# 或
$ docker-compose -f stack.yml up -d  # 单机Docker Compose环境

注意：单台机器上部署多节点集群无法提供真正的冗余。若物理机故障，所有节点将同时不可用。生产环境需确保每个节点部署在独立物理机上。

配置说明

挂载自定义配置文件

Zookeeper配置文件位于/conf目录，可通过挂载卷覆盖默认配置：

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

环境变量配置

若未提供自定义zoo.cfg，镜像将使用默认配置，可通过以下环境变量覆盖：

ZOO_TICK_TIME

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

ZOO_INIT_LIMIT

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

ZOO_SYNC_LIMIT

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

ZOO_MAX_CLIENT_CNXNS

• 默认值：60
• 描述：限制单个客户端（按IP识别）与Zookeeper节点的并发连接数。

ZOO_STANDALONE_ENABLED

• 默认值：true
• 描述：控制是否启用独立模式。默认情况下，单节点集群不允许扩容，多节点集群不允许缩容至少于2个节点。

ZOO_ADMINSERVER_ENABLED

• 默认值：true
• 描述：是否启用AdminServer（嵌入式Jetty服务器），提供HTTP接口访问四字命令（如stat），默认端口8080。

ZOO_AUTOPURGE_PURGEINTERVAL

• 默认值：0（小时）
• 描述：自动清理任务的触发间隔。设置为正整数（1及以上）启用自动清理，默认禁用。

ZOO_AUTOPURGE_SNAPRETAINCOUNT

• 默认值：3
• 描述：自动清理时保留的最新快照和事务日志数量，最小值为3。

ZOO_4LW_COMMANDS_WHITELIST

• 默认值：srvr
• 描述：允许使用的四字命令列表（逗号分隔）。默认仅启用srvr命令，其他命令需显式添加。

高级配置

对于未通过环境变量暴露的高级配置，可使用JVMFLAGS环境变量设置Java系统属性（格式：-Dproperty=value）：

示例1：使用Netty作为通信框架

console
$ docker run --name some-zookeeper --restart always -e JVMFLAGS="-Dzookeeper.serverCnxnFactory=org.apache.zookeeper.server.NettyServerCnxnFactory" %%IMAGE%%

示例2：设置JVM堆大小

console
$ docker run --name some-zookeeper --restart always -e JVMFLAGS="-Xmx1024m" %%IMAGE%%

完整高级配置项参见 Zookeeper高级配置文档。

复制模式必要配置

部署复制模式集群时，以下环境变量为必填项：

ZOO_MY_ID

• 描述：节点ID，在集群中必须唯一，取值范围1-255。若/data目录已存在myid文件，此变量无效。

ZOO_SERVERS

• 描述：集群节点列表，格式为server.id=host:port:port[:role];[client port address:]client port（Zookeeper 3.5+格式）。多个节点用空格分隔。若/conf目录已存在zoo.cfg文件，此变量无效。

数据存储

镜像配置了以下卷用于数据持久化：

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

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

日志配置

默认情况下，Zookeeper将标准输出/错误重定向到控制台。可通过ZOO_LOG4J_PROP环境变量重定向至/logs目录下的文件：

console
$ docker run --name some-zookeeper --restart always -e ZOO_LOG4J_PROP="INFO,ROLLINGFILE" %%IMAGE%%

日志将写入/logs/zookeeper.log。镜像已配置/logs卷方便日志持久化。更多日志配置参见 Zookeeper日志文档。