sroegner/zookeeper

sroegner/zookeeper Docker镜像文档

镜像概述

sroegner/zookeeper是基于Apache ZooKeeper的Docker镜像，提供开箱即用的分布式协调服务。ZooKeeper是一个高性能的分布式协调框架，常用于分布式系统中的配置管理、命名服务、分布式锁、集群管理等场景。该镜像简化了ZooKeeper的部署流程，可快速集成到开发、测试或生产环境中。

核心功能与特性

• 分布式协调：提供可靠的分布式协调机制，支持分布式系统节点间的同步与通信。
• 配置管理：集中存储和管理分布式系统的配置信息，支持动态配置更新。
• 命名服务：为分布式系统中的节点提供唯一命名，便于服务发现。
• 分布式锁：实现分布式环境下的互斥锁，保证资源的安全访问。
• 轻量级部署：基于Docker容器化部署，简化环境依赖，支持快速启停和迁移。

使用场景与适用范围

• 分布式系统开发：作为开发环境中的协调服务，支持多节点应用的本地测试。
• 微服务架构：为微服务提供服务注册与发现、配置中心等基础支撑。
• 集群管理：用于分布式集群的节点状态监控、选举与故障转移。
• 测试环境：快速搭建临时ZooKeeper服务，验证分布式应用逻辑。

使用方法与配置说明

基本运行命令

通过以下命令启动ZooKeeper服务：

bash
docker run -d -p 127.0.0.10:2181:2181 docker.xuanyuan.run/sroegner/zookeeper

参数说明：

• -d：后台运行容器
• -p 127.0.0.10:2181:2181：端口映射，将宿主机的127.0.0.10:2181端口映射到容器内的ZooKeeper默认端口2181（宿主机IP可根据实际需求调整）
• sroegner/zookeeper：镜像名称

持久化数据（可选）

为避免容器重启后数据丢失，可通过挂载宿主机目录持久化ZooKeeper数据：

bash
docker run -d \
  -p 127.0.0.10:2181:2181 \
  -v /path/on/host/zookeeper/data:/data \
  -v /path/on/host/zookeeper/datalog:/datalog \
  docker.xuanyuan.run/sroegner/zookeeper

说明：

• /data：ZooKeeper数据存储目录
• /datalog：ZooKeeper事务日志目录

docker-compose配置示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  zookeeper:
    image: docker.xuanyuan.run/sroegner/zookeeper
    ports:
      - "127.0.0.10:2181:2181"
    volumes:
      - ./zookeeper/data:/data
      - ./zookeeper/datalog:/datalog
    restart: always

启动服务：

bash
docker-compose up -d

验证服务可用性

服务启动后，可通过ZooKeeper客户端连接验证：

bash
# 进入容器
docker exec -it <container_id> /bin/bash

# 运行ZooKeeper客户端
zkCli.sh -server localhost:2181

成功连接后，可执行ls /等命令查看根节点，确认服务正常运行。

注意事项

• 默认配置适用于开发/测试环境，生产环境需根据实际需求调整内存、连接数等参数（可通过环境变量或配置文件覆盖默认设置）。
• 若需搭建ZooKeeper集群，需配置zoo.cfg文件，指定集群节点信息，并确保节点间网络互通。