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

自定义ZooKeeper镜像文档

镜像概述

本镜像是基于31z4/zookeeper的定制版本，在保留原镜像核心功能的基础上，新增了自动清理旧快照（snapshots）和事务日志（logs）的机制。旨在解决ZooKeeper长期运行过程中，快照和日志文件不断累积导致磁盘空间耗尽的问题，适用于需要长期稳定运行ZooKeeper服务的场景。

核心功能与特性

核心功能

• 继承31z4/zookeeper的全部功能，包括标准ZooKeeper服务及配置
• 自动清理机制：定期检查并删除旧的快照文件和事务日志文件
• 可配置的清理策略，支持按文件数量或保留时间进行清理

特性

• 轻量级改造，不影响ZooKeeper核心服务性能
• 清理逻辑可通过环境变量灵活配置
• 与原31z4/zookeeper镜像兼容，可直接替换使用

使用场景

• 生产环境中长期运行的ZooKeeper单机实例或集群
• 磁盘空间有限的ZooKeeper部署环境
• 需要自动化管理ZooKeeper数据文件的场景
• 希望减少手动清理快照和日志操作的运维需求

使用方法

基本使用（Docker Run）

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -e KEEP_SNAPSHOTS=5 \          # 保留最近5个快照文件
  -e KEEP_LOGS=5 \              # 保留最近5个日志文件
  -e CLEANUP_INTERVAL=86400 \   # 清理间隔（秒），默认86400秒（24小时）
  your-image-name:tag

Docker Compose配置

yaml
version: '3'
services:
  zookeeper:
    image: your-image-name:tag
    container_name: zookeeper
    ports:
      - "2181:2181"
      - "2888:2888"
      - "3888:3888"
    environment:
      - KEEP_SNAPSHOTS=10          # 保留最近10个快照
      - KEEP_LOGS=10               # 保留最近10个日志
      - CLEANUP_INTERVAL=43200     # 每12小时清理一次
      - ZOO_MY_ID=1                # 集群节点ID（集群模式）
      - ZOO_SERVERS=server.1=0.0.0.0:2888:3888;2181  # 集群配置
    volumes:
      - zookeeper-data:/data
      - zookeeper-datalog:/datalog

volumes:
  zookeeper-data:
  zookeeper-datalog:

环境变量配置说明

注意事项

1. 清理操作仅删除超过保留数量的旧文件，不会影响当前使用中的快照和日志
2. 建议根据实际业务量和磁盘空间设置合理的保留数量和清理间隔
3. 集群环境中，各节点需单独配置清理参数，确保数据一致性
4. 首次运行时，若已有大量历史文件，清理机制会在第一个清理周期执行清理

维护与更新

• 本镜像基于31z4/zookeeper构建，可通过同步上游镜像版本保持ZooKeeper核心功能更新
• 清理逻辑相关问题可通过镜像issue跟踪或提交PR改进