cfei/zookeeper

cfei/zookeeper Docker镜像文档

镜像概述

cfei/zookeeper是一个用于部署ZooKeeper服务的Docker镜像，支持单节点和集群模式部署。该镜像通过环境变量配置核心参数，提供数据持久化机制，并支持Kerberos认证及ACL访问控制，适用于需要分布式协调服务的场景。

核心功能与特性

• 集群部署支持：可通过环境变量配置多节点集群，每个节点需指定唯一ID及集群成员信息
• 灵活配置：通过环境变量自定义端口、会话超时、连接限制等核心参数
• 数据持久化：提供专用数据卷存储快照和事务日志，确保数据可靠性
• 安全认证：支持Kerberos认证机制，可通过API或本地keytab文件配置
• 访问控制：支持ACL（访问控制列表）配置，增强集群安全性

使用场景

• 分布式系统协调服务（如Kafka、Hadoop等分布式组件的协调）
• 服务发现与注册
• 分布式锁实现
• 配置中心
• 集群管理与监控

使用方法

基本部署（单节点示例）

使用docker-compose部署单节点ZooKeeper：

yaml
version: "3"

services:
  zoo:
    image: cfei/zookeeper
    ports:
      - 2181:2181  # 客户端连接端口
      - 2888:2888  #  leader连接端口
      - 3888:3888  #  leader选举端口
    environment:
      ZOO_ID: 1  # 节点唯一ID
      ZOO_PORT: 2181  # 客户端端口
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888  # 集群成员列表（单节点配置）

集群部署示例

3节点ZooKeeper集群配置（需在不同主机部署）：

yaml
version: "3"

services:
  zoo:
    image: cfei/zookeeper
    ports:
      - 2181:2181
      - 2888:2888
      - 3888:3888
    environment:
      ZOO_ID: 1  # 节点1的ID
      ZOO_PORT: 2181
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888,server.2=<<server_2_ip>>:2888:3888,server.3=<<server_3_ip>>:2888:3888

注意：每个主机建议只部署一个ZooKeeper实例，需确保各节点间网络互通。

配置说明

基本配置（必填）

其他配置（可选，使用默认值即可）

注意：部分配置项尚未完全实现，当前使用默认值。

数据卷

安全配置

Kerberos认证

1. 使用Kerberos API配置

yaml
version: "3"

services:
  zoo:
    image: cfei/zookeeper
    container_name: zookeeper
    ports:
      - 2181:2181
      - 2888:2888
      - 3888:3888
    environment:
      ZOO_ID: 1
      ZOO_PORT: 2181
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888,server.2=<<zookeeper2_ip>>:2888:3888,server.3=<<zookeeper3_ip>>:2888:3888
      ZOO_AUTHENTICATION: KERBEROS
      ZOO_KERBEROS_PUBLIC_URL: <<kerberos_public_dns>>
      ZOO_KERBEROS_API_URL: <<kerberos_api_public_dns>>/<<get_keytab_endpoint_route>>
      ZOO_KERBEROS_API_USERNAME: <<kerberos_zookeeper_principal_name>>
      ZOO_KERBEROS_API_PASSWORD: <<kerberos_api_zookeeper_password>>
      ZOO_KERBEROS_REALM: <<kerberos_realm>>

2. 不使用Kerberos API配置（需挂载keytab文件）

yaml
version: "3"

services:
  zoo:
    image: cfei/zookeeper
    ports:
      - 2181:2181
      - 2888:2888
      - 3888:3888
    environment:
      ZOO_ID: 1
      ZOO_PORT: 2181
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888,server.2=<<zookeeper2_ip>>:2888:3888,server.3=<<zookeeper3_ip>>:2888:3888
      ZOO_AUTHENTICATION: KERBEROS
      ZOO_KERBEROS_PRINCIPAL: <<zookeeper_kerberos_principal_name>>@<<kerberos_realm>>
      ZOO_KERBEROS_PUBLIC_URL: <<kerberos_public_dns>>
      ZOO_KERBEROS_REALM: <<kerberos_realm>>
    volumes:
      - ./zookeeper.service.keytab:/sasl/zookeeper.service.keytab  # 挂载本地keytab文件

ACL（访问控制列表）

启用主体名验证的ACL配置：

yaml
version: "3"

services:
  zoo:
    image: cfei/zookeeper
    container_name: zookeeper
    ports:
      - 2181:2181
      - 2888:2888
      - 3888:3888
    environment:
      ZOO_ID: 1
      ZOO_PORT: 2181
      ZOO_SERVERS: server.1=0.0.0.0:2888:3888,server.2=<<zookeeper2_ip>>:2888:3888,server.3=<<zookeeper3_ip>>:2888:3888
      ZOO_AUTHENTICATION: KERBEROS
      ZOO_KERBEROS_PUBLIC_URL: <<kerberos_public_dns>>
      ZOO_KERBEROS_API_URL: <<kerberos_api_public_dns>>/<<get_keytab_endpoint_route>>
      ZOO_KERBEROS_API_USERNAME: <<kerberos_zookeeper_principal_name>>
      ZOO_KERBEROS_API_PASSWORD: <<kerberos_api_zookeeper_password>>
      ZOO_KERBEROS_REALM: <<kerberos_realm>>
      ZOO_REMOVE_HOST_AND_REALM: "true"  # 仅使用主体名进行ACL验证