apache/ranger-solr

镜像概述

该Docker镜像专为Apache Ranger设计，提供预配置的Solr服务环境，旨在简化Ranger审计日志存储与检索功能的部署流程。通过集成Solr，Ranger可将审计日志高效存储于Solr索引中，并支持快速检索与分析，解决传统部署中Ranger与Solr集成的复杂性问题。

核心功能与特性

• Ranger适配优化：内置适合Ranger审计日志的Solr集合（collection）配置，预定义索引schema，无需手动创建Ranger专用集合
• 一键部署：容器启动后自动完成Solr服务初始化、集合创建及配置加载，减少手动操作步骤
• 灵活配置：支持通过环境变量自定义Solr端口、内存分配、集合名称等核心参数
• 兼容性保障：兼容主流Ranger版本（2.x及以上）及Solr 7.x/8.x系列，确保审计数据存储功能稳定运行

适用场景

• Ranger审计日志管理：作为Ranger审计日志的存储后端，支持审计数据的高效写入与查询
• 开发/测试环境：快速搭建Ranger与Solr集成的测试环境，降低环境配置门槛
• 生产环境部署：作为Ranger生态的标准化组件，提供可靠的Solr服务支撑

使用方法与配置说明

快速启动（docker run）

通过以下命令可快速启动容器：

bash
docker run -d \
  --name ranger-solr \
  -p 8983:8983 \
  -e SOLR_MEMORY="2g" \
  -e RANGER_COLLECTION_NAME="ranger_audits" \
  ranger-solr:latest

环境变量配置

容器支持通过环境变量自定义配置，常用参数如下：

• SOLR_PORT：Solr服务端口，默认值8983
• SOLR_MEMORY：Solr JVM内存分配，默认值1g（格式示例：2g表示2GB）
• RANGER_COLLECTION_NAME：Ranger审计日志存储的Solr集合名称，默认值ranger_audits
• SOLR_HOST：Solr服务绑定地址，默认值0.0.0.0
• ZOOKEEPER_HOST：外部ZooKeeper地址（如需使用外部ZK集群，默认使用Solr内置ZK）
• RANGER_COLLECTION_SHARDS：集合分片数，默认值1
• RANGER_COLLECTION_REPLICATION：集合副本数，默认值1

Docker Compose配置示例

yaml
version: '3'
services:
  ranger-solr:
    image: ranger-solr:latest
    container_name: ranger-solr
    ports:
      - "8983:8983"
    environment:
      - SOLR_PORT=8983
      - SOLR_MEMORY=2g
      - RANGER_COLLECTION_NAME=ranger_audits
      - RANGER_COLLECTION_SHARDS=2
      - RANGER_COLLECTION_REPLICATION=1
    volumes:
      - solr-data:/var/solr/data  # 持久化Solr数据
    restart: unless-stopped

volumes:
  solr-data:

部署验证步骤

1. 容器启动后，访问Solr管理界面：http://<容器IP>:8983/solr
2. 导航至"Collections"页面，确认Ranger专用集合（如ranger_audits）已自动创建
3. 通过Ranger管理界面配置审计日志存储至Solr，验证日志写入与查询功能

注意事项

• 生产环境需挂载数据卷（/var/solr/data）以确保Solr数据持久化
• 根据审计日志量调整集合分片数（shards）与副本数（replication），建议分片数不小于2
• 内存配置（SOLR_MEMORY）需根据实际负载调整，生产环境建议不低于2GB
• 如需集成外部ZooKeeper，需配置ZOOKEEPER_HOST（格式：zk-host1:2181,zk-host2:2181）并确保网络连通性