elytics/zookeeper-exhibitor-ecs

elytics/zookeeper-exhibitor-ecs 镜像说明

镜像概述

本镜像运行由https://github.com/Netflix/exhibitor%E7%AE%A1%E7%90%86%E7%9A%84http://zookeeper.apache.org/%E5%AE%9E%E4%BE%8B%EF%BC%8C%E5%88%A9%E7%94%A8AWS S3服务实现备份和自动节点发现，可在ECS环境中快速部署分布式协调服务。

核心功能

1. Exhibitor管理：通过Exhibitor实现ZooKeeper集群的自动化配置、监控与维护。
2. S3集成：使用S3存储备份数据并协调集群节点状态。
3. 灵活认证：支持AWS访问密钥认证或IAM角色绑定两种方式。
4. 多端口暴露：提供Exhibitor UI（8181）、ZooKeeper客户端（2181）及集群通信（2888、3888）端口。

使用场景

• ECS环境下的分布式系统协调服务部署。
• 需要高可用ZooKeeper集群的应用场景。
• 依赖S3进行数据备份和集群协调的场景。

版本信息

• Exhibitor: 1.5.5
• ZooKeeper: 3.4.6

配置说明

环境变量

容器运行支持以下可选环境变量：

• S3_BUCKET：Exhibitor用于备份和协调的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代理相关配置（主机、端口、用户名、密码）。

部署示例

使用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=<访问密钥ID> \
    -e AWS_SECRET_ACCESS_KEY=<秘钥> \
    docker.xuanyuan.run/elytics/zookeeper-exhibitor-ecs:latest

使用IAM角色部署

若实例已绑定IAM角色，可省略访问密钥：

bash
docker run -p 8181:8181 -p 2181:2181 -p 2888:2888 -p 3888:3888 \
    -e S3_BUCKET=<你的S3桶名> \
    -e S3_PREFIX=<键前缀> \
    docker.xuanyuan.run/elytics/zookeeper-exhibitor-ecs:latest

验证方法

1. 检查Exhibitor状态：

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

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

2. 访问Exhibitor Web UI：http://<主机IP>:8181/exhibitor/v1/ui/index.html

3. 检查ZooKeeper可用性：

bash
echo ruok | nc <主机IP> 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"
        }
    ]
}