djenriquez/zookeeper-exhibitor

djenriquez/zookeeper-exhibitor 镜像说明

镜像概述

本镜像提供由https://github.com/Netflix/exhibitor%E7%AE%A1%E7%90%86%E7%9A%84ZooKeeper%E5%AE%9E%E4%BE%8B%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87AWS S3实现备份存储与集群自动发现，帮助快速构建高可用的分布式协调服务。

核心功能

• 基于Exhibitor简化ZooKeeper集群的配置与维护
• 利用S3实现集群数据备份与节点协调
• 支持HTTP Basic Auth保护Exhibitor管理界面
• 可配置HTTP代理适配不同网络环境
• 允许自定义ZooKeeper数据与日志存储目录

使用场景

• 分布式系统中的服务注册与发现
• 配置中心的数据存储与同步
• 分布式锁、队列等协调机制的基础组件
• 需要高可用ZooKeeper集群的业务场景

配置说明

容器需传入以下环境变量（部分为可选）：

• HOSTNAME：节点可访问的主机名（Exhibitor UI转发地址）
• S3_BUCKET（可选）：S3备份桶名
• S3_PREFIX（可选）：S3桶内键前缀
• AWS_ACCESS_KEY_ID（可选）：S3读写权限的AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY（可选）：对应密钥的秘密值
• AWS_REGION（可选）：S3桶区域（默认us-west-2）
• ZK_PASSWORD（可选）："zk"用户的HTTP Basic Auth密码
• ZK_DATA_DIR（可选）：ZooKeeper数据目录
• ZK_LOG_DIR（可选）：ZooKeeper日志目录
• HTTP_PROXY_*（可选）：HTTP代理的主机、端口、用户名、密码
• EXHIBITOR_PORT（可选）：Exhibitor端口（默认8181）

部署示例

带AWS密钥部署

bash
docker run -p 8181:8181 -p 2181:2181 -p 2888:2888 -p 3888:3888 \
    -e S3_BUCKET=<你的S3桶名> \
    -e S3_PREFIX=<你的键前缀> \
    -e AWS_ACCESS_KEY_ID=<你的访问密钥> \
    -e AWS_SECRET_ACCESS_KEY=<你的秘密密钥> \
    -e HOSTNAME=<你的主机名> \
    djenriquez/zookeeper-exhibitor:latest

IAM角色部署（AWS实例）

bash
docker run -p 8181:8181 -p 2181:2181 -p 2888:2888 -p 3888:3888 \
    -e S3_BUCKET=<你的S3桶名> \
    -e S3_PREFIX=<你的键前缀> \
    -e HOSTNAME=<你的主机名> \
    djenriquez/zookeeper-exhibitor:latest

验证方法

1. 检查Exhibitor状态：

bash
curl -s localhost:8181/exhibitor/v1/cluster/status | python -m json.tool

预期返回包含"serving"状态的JSON结果。

2. 访问Exhibitor UI： 浏览器打开http://<你的主机名>:8181/exhibitor/v1/ui/index.html

3. 验证ZooKeeper可用性：

bash
echo ruok | nc <你的主机名> 2181

预期返回imok。

AWS IAM策略示例

若使用IAM角色，实例需配置以下策略（替换<exhibitor-bucket>为实际桶名）：

json
{
    "Statement": [
        {
            "Resource": [
                "arn:aws:s3:::exhibitor-bucket/*",
                "arn:aws:s3:::exhibitor-bucket"
            ],
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:GetBucketAcl",
                "s3:GetBucketPolicy",
                "s3:GetObject",
                "s3:GetObjectAcl",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:ListMultipartUploadParts",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Effect": "Allow"
        }
    ]
}