apache/ranger-zk

Ranger Zookeeper Docker镜像文档

1. 镜像概述和主要用途

1.1 概述

该Docker镜像专为Apache Ranger部署场景设计，提供预配置的Zookeeper服务。Apache Ranger作为Hadoop生态的权限管理框架，依赖Zookeeper实现配置存储、服务协调及分布式锁管理。本镜像通过容器化封装简化了Zookeeper与Ranger的集成流程，降低环境搭建复杂度。

1.2 主要用途

• 为Ranger Admin、Ranger KMS等组件提供分布式协调服务
• 存储Ranger配置元数据及服务状态信息
• 支持Ranger集群环境的分布式锁与配置同步
• 简化容器化部署场景下Ranger依赖组件的管理

2. 核心功能和特性

• 版本适配：兼容Zookeeper 3.4.x/3.5.x稳定版本，适配Ranger 2.0+主流版本
• 一键部署：预配置基础参数，无需手动修改配置文件即可快速启动
• 灵活配置：支持通过环境变量动态调整Zookeeper核心参数
• 数据持久化：原生支持数据卷挂载，保障事务日志与快照数据的持久性
• 网络隔离：支持自定义网络配置，可与Ranger其他组件实现内部通信
• 轻量优化：基于Alpine或Debian Slim基础镜像构建，减少资源占用

3. 使用场景和适用范围

3.1 使用场景

• Ranger快速部署：企业Hadoop集群权限管理环境的快速搭建
• 开发测试环境：Ranger功能开发与插件测试的隔离环境
• 容器化集群：Kubernetes或Docker Compose管理的Ranger服务栈
• CI/CD流水线：Ranger自动化测试环境的标准化部署

3.2 适用范围

• 支持Docker 19.03+及Kubernetes 1.18+环境
• 兼容Ranger 2.0.x、2.1.x、2.2.x版本
• 适用于单机开发环境及小规模生产集群
• 支持与Ranger Admin、Ranger Tagsync等组件协同工作

4. 使用方法和配置说明

4.1 镜像获取

bash
# 假设镜像仓库地址为registry.example.com，实际使用时替换为真实地址
docker pull registry.example.com/ranger-zookeeper:latest

4.2 基础使用（单机模式）

4.2.1 快速启动命令

bash
docker run -d \
  --name ranger-zookeeper \
  -p 2181:2181 \
  -v zk-data:/data \
  -v zk-datalog:/datalog \
  -e ZOO_TICK_TIME=2000 \
  -e ZOO_INIT_LIMIT=10 \
  -e ZOO_SYNC_LIMIT=5 \
  registry.example.com/ranger-zookeeper:latest

4.2.2 参数说明

• -p 2181:2181：映射Zookeeper客户端端口
• -v zk-data:/data：挂载数据卷存储Zookeeper快照
• -v zk-datalog:/datalog：挂载数据卷存储事务日志
• 环境变量用于配置Zookeeper核心参数

4.3 Docker Compose集成示例

yaml
version: '3.8'

services:
  ranger-zookeeper:
    image: registry.example.com/ranger-zookeeper:latest
    container_name: ranger-zookeeper
    ports:
      - "2181:2181"
    volumes:
      - zk-data:/data
      - zk-datalog:/datalog
    environment:
      - ZOO_PORT=2181
      - ZOO_TICK_TIME=2000
      - ZOO_INIT_LIMIT=10
      - ZOO_SYNC_LIMIT=5
    networks:
      - ranger-network
    restart: unless-stopped

  ranger-admin:
    image: registry.example.com/ranger-admin:latest
    depends_on:
      - ranger-zookeeper
    environment:
      - ZOOKEEPER_HOST=ranger-zookeeper
      - ZOOKEEPER_PORT=2181
    networks:
      - ranger-network

volumes:
  zk-data:
  zk-datalog:

networks:
  ranger-network:
    driver: bridge

4.4 核心配置参数

4.4.1 环境变量配置

4.4.2 自定义配置文件

通过挂载配置文件覆盖默认设置：

bash
docker run -d \
  --name ranger-zookeeper \
  -v /host/path/to/zoo.cfg:/conf/zoo.cfg \
  -v zk-data:/data \
  registry.example.com/ranger-zookeeper:latest

4.5 集群模式配置（3节点示例）

bash
# 节点1
docker run -d \
  --name zk-node1 \
  --network ranger-network \
  -e ZOO_MY_ID=1 \
  -e ZOO_SERVERS="server.1=zk-node1:2888:3888 server.2=zk-node2:2888:3888 server.3=zk-node3:2888:3888" \
  -v zk-data-1:/data \
  registry.example.com/ranger-zookeeper:latest

# 节点2（仅ZOO_MY_ID和数据卷不同）
docker run -d \
  --name zk-node2 \
  --network ranger-network \
  -e ZOO_MY_ID=2 \
  -e ZOO_SERVERS="server.1=zk-node1:2888:3888 server.2=zk-node2:2888:3888 server.3=zk-node3:2888:3888" \
  -v zk-data-2:/data \
  registry.example.com/ranger-zookeeper:latest

# 节点3（仅ZOO_MY_ID和数据卷不同）
docker run -d \
  --name zk-node3 \
  --network ranger-network \
  -e ZOO_MY_ID=3 \
  -e ZOO_SERVERS="server.1=zk-node1:2888:3888 server.2=zk-node2:2888:3888 server.3=zk-node3:2888:3888" \
  -v zk-data-3:/data \
  registry.example.com/ranger-zookeeper:latest

4.6 服务验证

bash
# 检查容器状态
docker ps | grep ranger-zookeeper

# 查看服务日志
docker logs -f ranger-zookeeper

# 连接Zookeeper客户端
docker exec -it ranger-zookeeper zkCli.sh -server localhost:2181

# 验证Ranger根节点（Ranger启动后自动创建）
[zk: localhost:2181(CONNECTED) 0] ls /ranger

5. 注意事项

• 数据安全：生产环境必须配置数据卷备份策略，定期备份/data目录
• 资源配置：建议配置容器资源限制（如--cpus 1 -m 2G），避免资源竞争
• 版本匹配：需根据Ranger版本选择兼容的Zookeeper版本（参考Ranger官方文档）
• 防火墙配置：开放必要端口（客户端2181，集群2888/3888）
• 监控集成：可通过JMX暴露监控指标（添加-e JMXPORT=9999开启）