siniida/zookeeper

siniida/zookeeper

镜像概述和主要用途

siniida/zookeeper是一个Apache ZooKeeper容器镜像，主要用于gennai集群环境（详见https://github.com/siniida/gennai.docker）。该镜像支持两种部署模式：单机模式和集群模式，提供了便捷的集群管理脚本，可快速实现ZooKeeper集群的创建、启动、状态查看和停止。

核心功能和特性

• 支持单机部署：可直接通过docker run命令快速启动单个ZooKeeper实例
• 集群模式支持：提供cluster.sh脚本，支持创建多节点ZooKeeper集群
• 集群管理功能：通过脚本实现集群的启动、停止、状态查询等操作
• 灵活配置：可指定集群名称、容器镜像、节点数量等参数

使用场景和适用范围

适用于需要ZooKeeper服务的gennai集群环境，可满足分布式系统中协调服务的需求，如配置管理、命名服务、分布式锁等场景。既支持开发测试环境的单机部署，也支持生产环境的多节点集群部署。

使用方法和配置说明

单机模式部署

直接通过docker run命令启动单个ZooKeeper实例：

bash
$ docker run -d siniida/zookeeper

集群模式部署

通过cluster.sh脚本进行ZooKeeper集群的管理，支持创建、启动、停止和状态查询等操作。

cluster.sh脚本基本用法

bash
Usage:
  cluster.sh [<OPTIONS>] COMMAND

Management Apache ZooKeeper containers.

OPTIONS:
  --version, -v           打印cluster.sh版本
  --help, -h              打印帮助信息
  --ensamble, -e STRING   指定集群名称（默认：zk）

COMMAND:
  start             启动集群
  stop              停止集群
  status            打印集群状态
  help COMMAND      打印指定命令的帮助信息

创建ZooKeeper集群

bash
Usage:
  cluster.sh start [<OPTIONS>] [SERVER_COUNT]

ZooKeeper集群启动。

OPTIONS:
  --container, -c STRING   指定容器镜像（默认：siniida/zookeeper）

SERVER_COUNT:
  指定ZooKeeper容器数量（默认：3）

示例：创建包含5个节点的ZooKeeper集群

bash
$ ./cluster.sh start 5

上述命令等效于执行以下操作：

bash
$ docker run -d --name=zk1 --hostname=zk1 --restart=always siniida/zookeeper
$ docker run -d --name=zk2 --hostname=zk2 --restart=always siniida/zookeeper
$ docker run -d --name=zk3 --hostname=zk3 --restart=always siniida/zookeeper
$ docker run -d --name=zk4 --hostname=zk4 --restart=always siniida/zookeeper
$ docker run -d --name=zk5 --hostname=zk5 --restart=always siniida/zookeeper

查看ZooKeeper集群状态

bash
Usage:
  cluster.sh status [<OPTIONS>]

ZooKeeper集群状态查询。

OPTIONS:
  --servers, -s   仅打印容器状态
  --link, -l      仅打印链接选项（例如：--link 1:1 --link...）
  --address, -a   仅打印访问字符串（例如：1:2181,2:2181,...）
  --ip, -i        打印IP地址

销毁ZooKeeper集群

停止并销毁整个ZooKeeper集群：

bash
$ ./cluster.sh stop