mbabineau/zookeeper-exhibitor

mbabineau/zookeeper-exhibitor 镜像说明

镜像概述

本镜像基于Alpine Linux构建，运行由Exhibitor（Netflix开源项目）管理的ZooKeeper（Apache开源项目）实例，支持通过AWS S3进行备份和自动节点发现。镜像体积约272MB，包含以下版本组件：

• Exhibitor 1.5.5
• ZooKeeper 3.4.6
• Java 1.8

核心功能

1. Exhibitor管理：简化ZooKeeper集群的配置、监控和维护；
2. S3集成：使用S3存储备份数据和集群协调信息；
3. 灵活认证：支持AWS IAM角色或访问密钥认证；
4. Web UI与API：提供可视化管理界面和REST API；
5. 代理支持：可配置HTTP代理访问外部服务。

使用场景

适用于需要分布式协调服务的场景，如：

• 微服务架构中的服务注册与发现；
• 分布式系统的配置中心；
• 分布式锁、队列等协调机制；
• 高可用性ZooKeeper集群部署。

配置说明

环境变量

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

• 必填：HOSTNAME（节点可访问的主机名）；
• 可选：
  • S3_BUCKET：S3存储桶名称；
  • S3_PREFIX：存储桶内的键前缀；
  • AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY：AWS访问密钥；
  • AWS_REGION：S3区域（默认us-west-2）；
  • ZK_PASSWORD：ZooKeeper HTTP Basic Auth密码；
  • ZK_DATA_DIR/ZK_LOG_DIR：ZooKeeper数据/日志目录；
  • HTTP_PROXY_*：HTTP代理相关配置。

部署示例

1. 使用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=<你的Access Key> \
  -e AWS_SECRET_ACCESS_KEY=<你的Secret Key> \
  -e HOSTNAME=<节点主机名> \
  mbabineau/zookeeper-exhibitor:latest

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

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

验证服务

• 检查Exhibitor状态：

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

• 检查ZooKeeper状态：

  bash
  echo ruok | nc <节点主机名> 2181
  

• 访问Web UI：http://<节点主机名>:8181/exhibitor/v1/ui/index.html

AWS IAM策略示例

若使用IAM角色，需为实例附加以下策略：

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