siniida/zookeeper

siniida/zookeeper

镜像概述和主要用途

siniida/zookeeper是一个Apache ZooKeeper容器镜像，主要用于gennai集群环境（详见https://github.com/siniida/gennai.docker%EF%BC%89%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81%E4%B8%A4%E7%A7%8D%E9%83%A8%E7%BD%B2%E6%A8%A1%E5%BC%8F%EF%BC%9A%E5%8D%95%E6%9C%BA%E6%A8%A1%E5%BC%8F%E5%92%8C%E9%9B%86%E7%BE%A4%E6%A8%A1%E5%BC%8F%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E9%9B%86%E7%BE%A4%E7%AE%A1%E7%90%86%E8%84%9A%E6%9C%AC%EF%BC%8C%E5%8F%AF%E5%BF%AB%E9%80%9F%E5%AE%9E%E7%8E%B0ZooKeeper%E9%9B%86%E7%BE%A4%E7%9A%84%E5%88%9B%E5%BB%BA%E3%80%81%E5%90%AF%E5%8A%A8%E3%80%81%E7%8A%B6%E6%80%81%E6%9F%A5%E7%9C%8B%E5%92%8C%E5%81%9C%E6%AD%A2%E3%80%82

核心功能和特性

• 支持单机部署：可直接通过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