behance/docker-zk-exhibitor

镜像概述

本镜像提供由Exhibitor（Netflix开源工具）管理的ZooKeeper实例，支持利用AWS S3存储进行备份和集群节点自动发现，可用于构建稳定的分布式协调服务。

核心功能

• 基于Exhibitor 1.5.5和ZooKeeper 3.4.6版本构建
• 通过S3实现集群备份与节点协调（可选配置）
• 支持HTTP Basic Auth认证保护Exhibitor UI
• 可配置HTTP代理以适应特定网络环境
• 允许自定义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_HOST（可选）：HTTP代理主机名
• HTTP_PROXY_PORT（可选）：HTTP代理端口
• HTTP_PROXY_USERNAME（可选）：HTTP代理用户名
• HTTP_PROXY_PASSWORD（可选）：HTTP代理密码

部署示例

Docker Run命令

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=<你的AWS访问密钥ID> \
    -e AWS_SECRET_ACCESS_KEY=<你的AWS秘钥> \
    -e HOSTNAME=<你的主机名> \
    mbabineau/zookeeper-exhibitor:latest

使用IAM角色部署（无需密钥）

若实例已绑定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=<你的主机名> \
    mbabineau/zookeeper-exhibitor:latest

验证方法

1. 检查Exhibitor状态：

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

预期返回集群节点状态（如服务中、是否为 leader）。

2. 检查ZooKeeper可用性：

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

预期返回imok。

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

AWS IAM政策示例

若使用IAM角色，需为实例配置以下S3权限政策：

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"
        }
    ]
}