Solr Docker镜像文档

镜像概述和主要用途

本镜像为 Solr 9.9.0 版本的Docker化部署包，基于 Islandora-DevOps/isle-buildkit solr 项目构建。Solr是一个高性能的开源企业级搜索平台，基于Lucene构建，提供全文检索、分面搜索、实时索引等功能。本镜像旨在简化Solr的部署流程，适用于开发、测试及生产环境的快速搭建。

更多Solr详细功能请参考 Solr官方文档。

核心功能和特性

• 全文检索能力：支持复杂的文本分析、分词及相关性排序
• 多核心管理：可同时运行多个独立索引核心（cores），满足多场景数据隔离需求
• 灵活配置：通过环境变量自定义JVM参数、Jetty配置、日志级别及内存分配
• 数据持久化：核心配置与数据存储路径支持卷挂载，确保数据持久化
• 标准化部署：预配置Jetty服务，默认监听所有网络接口，开箱即可访问

使用场景和适用范围

• 企业级搜索应用：网站内容搜索、文档管理系统检索、电商商品搜索等
• 数据分析辅助：日志分析、用户行为数据检索、业务指标聚合查询
• 内容管理集成：与CMS（如Drupal、WordPress）集成提供搜索服务
• 开发测试环境：快速搭建独立Solr实例，验证索引配置及查询性能
• 微服务架构：作为独立搜索服务组件，通过HTTP API与其他服务交互

使用方法和配置说明

快速启动

通过以下命令可快速启动一个Solr实例，访问 http://localhost:8983/solr/ 即可打开管理界面：

docker run --rm -ti -p 8983:8983 islandora/solr

配置参数

环境变量

端口映射

数据卷

日志管理

Solr日志配置及查看方法请参考 Solr日志文档。日志级别可通过 SOLR_LOG_LEVEL 环境变量调整。

版本更新

如需修改镜像中的Solr版本，需调整Dockerfile中的构建参数 SOLR_VERSION 和 SOLR_FILE_SHA256：

1. 修改 SOLR_VERSION 为目标版本号
2. 重新计算目标版本安装包的SHA256校验和，命令如下：

   SOLR_VERSION=目标版本号
   SOLR_FILE="solr-${SOLR_VERSION}.tgz"
   SOLR_URL="[***]{SOLR_VERSION}/${SOLR_FILE}"
   wget --quiet "${SOLR_URL}"
   shasum -a 256 "${SOLR_FILE}" | cut -f1 -d' '
   rm "${SOLR_FILE}"
   

3. 将计算结果更新至 SOLR_FILE_SHA256 参数

Docker Compose部署示例

以下为使用docker-compose部署Solr的示例配置（docker-compose.yml）：

version: '3.8'

services:
  solr:
    image: islandora/solr:latest
    container_name: solr-service
    restart: unless-stopped
    ports:
      - "8983:8983"  # 映射HTTP端口
    environment:
      - SOLR_MEMORY=1g  # 调整JVM堆内存为1GB
      - SOLR_LOG_LEVEL=DEBUG  # 开启DEBUG日志
      - SOLR_JAVA_OPTS=-XX:+UseG1GC  # 额外JVM参数：使用G1垃圾收集器
    volumes:
      - solr-data:/opt/solr/server/solr  # 挂载数据卷持久化核心配置与数据
    networks:
      - solr-network

volumes:
  solr-data:  # 声明命名卷，确保数据持久化

networks:
  solr-network:  # 独立网络隔离
    driver: bridge

启动命令：docker-compose up -d
查看日志：docker-compose logs -f solr
停止服务：docker-compose down（如需保留数据，不加 -v 参数）