tugboatqa/solr

Solr (Tugboat 扩展版) 镜像文档

镜像概述

本镜像基于官方 https://hub.docker.com/_/solr/ 镜像扩展而来，专门适配 Tugboat 开发环境。它保留了 Solr 所有核心功能，并针对 Tugboat 的开发工作流进行了优化，旨在为开发团队提供与 Tugboat 无缝集成的企业级搜索服务，简化开发、测试阶段的环境配置流程。

核心功能与特性

1. 完整继承 Solr 核心能力
   保留官方 Solr 镜像的全部企业级搜索功能，包括高效全文检索、分面搜索、实时索引更新、分布式部署支持、丰富的查询语法等。

2. Tugboat 环境深度适配
   针对 Tugboat 开发环境的隔离性和动态配置特性进行优化，确保 Solr 服务在 Tugboat 工作流中稳定运行，支持环境变量自动注入、配置文件动态加载等特性。

3. 开发流程简化
   与 Tugboat 集成后，可快速搭建与生产环境一致的 Solr 服务实例，减少开发团队在环境配置上的时间成本，加速功能验证和协作开发。

使用场景与适用范围

• 企业级搜索功能开发
  适用于需要在 Tugboat 开发环境中构建、调试基于 Solr 的搜索功能的团队，如电商平台商品搜索、内容管理系统全文检索、日志分析系统等场景。

• 测试与演示环境搭建
  可作为 Tugboat 环境中的核心服务组件，用于搜索功能的自动化测试、性能评估及客户演示，确保开发环境与最终交付环境的一致性。

• 多团队协作开发
  适合多团队并行开发场景，通过 Tugboat 的隔离环境特性，每个团队可独立运行 Solr 服务实例，避免配置冲突和资源竞争。

使用方法与配置说明

前提条件

• 已安装 Docker 环境（推荐版本 20.10+）。
• 已配置 Tugboat 开发环境（参考 Tugboat 官方文档）。

获取镜像

通过 Docker Hub 拉取该扩展镜像（具体镜像名称以实际提供为准，以下示例使用 tugboat/solr）：

bash
docker pull tugboat/solr

基本使用（Docker Run）

在 Tugboat 环境中启动 Solr 服务的基础命令：

bash
docker run -d \
  --name tugboat-solr \
  -p 8983:8983 \  # 映射 Solr 管理界面端口
  tugboat/solr

与 Tugboat 集成配置

在 Tugboat 项目的 .tugboat/config.yml 文件中添加 Solr 服务定义，示例如下：

yaml
services:
  solr:
    image: tugboat/solr
    ports:
      - "8983"  # Tugboat 会自动分配端口，无需固定本地端口
    commands:
      # 预创建 Solr Core（根据项目需求调整 Core 名称和配置集）
      - solr-precreate my_core /opt/solr/server/solr/configsets/_default
    volumes:
      # 挂载自定义配置文件（如 schema.xml、solrconfig.xml）
      - ./solr-config:/opt/solr/server/solr/my_core/conf

环境变量配置

支持官方 Solr 镜像的所有环境变量（如 SOLR_JAVA_MEM 调整 JVM 内存），并新增 Tugboat 环境专用变量：

数据持久化

通过 Tugboat 卷配置确保 Solr 数据在环境重启后不丢失，在 .tugboat/config.yml 中添加卷定义：

yaml
services:
  solr:
    # ... 其他配置 ...
    volumes:
      - solr-data:/var/solr/data  # 挂载数据卷

volumes:
  solr-data:  # 声明持久化卷

访问 Solr 管理界面

服务启动后，可通过以下方式访问 Solr 管理界面：

• 本地开发环境：http://localhost:8983/solr（需映射 8983 端口）。
• Tugboat 远程环境：通过 Tugboat 项目 URL 访问，格式为 http://solr.[项目标识符].tugboatqa.com/solr。