jam2in/arcus-zookeeper

镜像概述

ZooKeeper for Arcus是专为Arcus分布式缓存系统设计的协调服务镜像。基于Apache ZooKeeper构建，集成了针对Arcus环境的预配置参数与节点结构，简化Arcus集群部署流程，提供可靠的分布式协调能力，支持Arcus节点注册、配置同步与故障检测。

核心功能与特性### 1. Arcus兼容性优化

• 内置与Arcus缓存集群的通信协议支持
• 预配置Arcus所需的ZooKeeper节点层次结构（如/arcus根节点及子节点模板）
• 针对Arcus数据交互模式优化的ZooKeeper会话超时与重试机制

2. 开箱即用的配置

• 默认启用适合中小规模Arcus集群的参数（tickTime=2000ms，initLimit=10，syncLimit=5）
• 预定义数据持久化策略，平衡性能与可靠性
• 兼容Arcus客户端的权限控制模型

3. 高可用支持

• 支持单节点与集群模式部署
• 内置集群选举与数据同步机制
• 数据与事务日志分离存储，提升稳定性

4. 运维友好特性

• 标准ZooKeeper监控接口暴露（JMX支持）
• 详细日志输出，便于问题排查
• 支持配置文件热更新（需通过卷挂载实现）

使用场景

• Arcus集群部署：作为协调中心管理Arcus节点的上下线与配置分发
• 开发测试环境：快速搭建包含协调服务的Arcus本地测试环境
• 生产环境部署：为大规模Arcus集群提供高可用协调服务
• Arcus迁移场景：在集群扩容或版本升级过程中维持配置一致性

使用方法### 基础部署（单节点模式）#### 快速启动命令

bash
docker run -d \
  --name arcus-zk \
  -p 2181:2181 \  # 客户端连接端口
  -v /host/data:/data \  # 数据持久化目录
  -v /host/datalog:/datalog \  # 事务日志目录
  arcus/zookeeper:latest
```#### 参数说明
- `-p 2181:2181`：映射ZooKeeper默认客户端端口
- `/data`：ZooKeeper数据存储目录，需持久化以避免数据丢失
- `/datalog`：事务日志目录，独立存储可提升性能

### 环境变量配置
通过环境变量自定义核心参数，支持的变量如下：

| 环境变量 | 描述 | 默认值 | 适用场景 |
|----------|------|--------|----------|
| `ZOO_CLIENT_PORT` | 客户端连接端口 | 2181 | 端口冲突时修改 |
| `ZOO_TICK_TIME` | 基础时间单位（毫秒） | 2000 | 调整集群响应灵敏度 |
| `ZOO_INIT_LIMIT` | Follower初始化超时（tick数） | 10 | 大型集群可增大至15-20 |
| `ZOO_SYNC_LIMIT` | Leader同步超时（tick数） | 5 | 网络延迟高时可增大 |
| `ZOO_MAX_CLIENT_CNXNS` | 最大客户端连接数 | 60 | 高并发场景可提高 |

#### 自定义端口示例
```bash
docker run -d \
  --name arcus-zk-custom \
  -p 2182:2182 \
  -e ZOO_CLIENT_PORT=2182 \
  -e ZOO_MAX_CLIENT_CNXNS=100 \
  -v /host/data:/data \
  arcus/zookeeper:latest

集群模式部署（生产环境）#### Docker Compose配置示例（3节点集群）

yaml
version: '3.8'
services:
  zk1:
    image: arcus/zookeeper:latest
    container_name: arcus-zk-1
    ports:
      - "2181:2181"
    environment:
      - ZOO_SERVER_ID=1  # 节点唯一ID（1-255）
      - ZOO_SERVERS=server.1=zk1:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=zk3:2888:3888;2181
    volumes:
      - ./zk1/data:/data
      - ./zk1/datalog:/datalog
    restart: unless-stopped

  zk2:
    image: arcus/zookeeper:latest
    container_name: arcus-zk-2
    ports:
      - "2182:2181"
    environment:
      - ZOO_SERVER_ID=2
      - ZOO_SERVERS=server.1=zk1:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=zk3:2888:3888;2181
    volumes:
      - ./zk2/data:/data
      - ./zk2/datalog:/datalog
    restart: unless-stopped

  zk3:
    image: arcus/zookeeper:latest
    container_name: arcus-zk-3
    ports:
      - "2183:2181"
    environment:
      - ZOO_SERVER_ID=3
      - ZOO_SERVERS=server.1=zk1:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=zk3:2888:3888;2181
    volumes:
      - ./zk3/data:/data
      - ./zk3/datalog:/datalog
    restart: unless-stopped
```#### 集群参数说明
- `ZOO_SERVER_ID`：集群节点唯一标识，必须为1-255的整数
- `ZOO_SERVERS`：集群节点列表，格式为`server.<id>=<hostname>:<peerPort>:<leaderPort>;<clientPort>`
  - `peerPort`（2888）：节点间数据同步端口
  - `leaderPort`（3888）：Leader选举端口
  - `clientPort`（2181）：客户端连接端口

### 高级配置（自定义配置文件）
如需完全自定义ZooKeeper配置，可通过卷挂载覆盖默认配置文件：

```bash
docker run -d \
  --name arcus-zk-custom \
  -p 2181:2181 \
  -v /host/custom/zoo.cfg:/conf/zoo.cfg \  # 挂载自定义配置文件
  -v /host/data:/data \
  -v /host/datalog:/datalog \
  arcus/zookeeper:latest
```#### 推荐自定义配置项（针对Arcus）
```ini
# 增大最大客户端连接数（适用于大规模Arcus集群）
maxClientCnxns=1000

# 启用四字命令（需谨慎使用，建议限制IP访问）
4lw.commands.whitelist=stat,ruok,conf,isro

# 调整快照与日志滚动策略
autopurge.snapRetainCount=10
autopurge.purgeInterval=24

验证部署

部署完成后，可通过ZooKeeper四字命令验证服务状态：

bash
# 检查服务是否正常运行
echo ruok | nc localhost 2181  # 正常返回"imok"

# 查看集群状态（集群模式）
echo stat | nc localhost 2181  # 输出包含节点角色（leader/follower）及连接信息