docker-solr 镜像文档

1. 镜像概述和主要用途

1.1 概述

docker-solr 是由 amazee.io 团队构建的 Solr 镜像，基于 Alpine Linux 发行版的 Solr 基础镜像构建，专为 amazee.io 托管平台设计和优化。

1.2 主要用途

提供高性能、轻量级的 Apache Solr 服务，满足 amazee.io 托管平台上各类应用的全文搜索、分布式索引、数据分析等需求，支持应用快速集成搜索功能。

2. 核心功能和特性

2.1 基础特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低，启动速度快。
• Solr 原生功能：支持全文搜索、分面搜索、分布式索引、实时分析、RESTful API 等 Solr 核心能力。
• 版本兼容性：与官方 Solr 版本保持兼容，支持标准 Solr 配置和插件。

2.2 平台优化

• 针对 amazee.io 托管平台的网络架构、服务发现机制进行适配，确保与平台其他组件（如数据库、应用服务）无缝集成。
• 内置基础安全配置，符合 amazee.io 平台的安全标准。

3. 使用场景和适用范围

3.1 适用场景

• amazee.io 托管平台环境下的 Web 应用、内容管理系统（如 Drupal、WordPress）等需要集成全文搜索功能的场景。
• 需要轻量级 Solr 服务支持的开发、测试及生产环境。

3.2 适用范围

• 适用环境：仅推荐在 amazee.io 托管平台中使用。
• 不适用环境：未针对 OpenShift 容器平台优化，不建议在 OpenShift 环境中部署。

4. 使用方法和配置说明

4.1 基本使用（docker run）

通过 docker run 命令快速启动容器：

docker run -d \
  --name amazee-solr \
  -p 8983:8983 \
  -v /path/to/solr/data:/opt/solr/server/solr \
  -e SOLR_HOME=/opt/solr/server/solr \
  amazeeio/solr:latest

参数说明：

• -p 8983:8983：映射 Solr 默认端口（8983）到主机。
• -v /path/to/solr/data:/opt/solr/server/solr：挂载本地目录作为 Solr 数据卷，持久化索引数据和配置。
• -e SOLR_HOME：指定 Solr 主目录（默认 /opt/solr/server/solr）。

4.2 docker-compose 配置示例

在 amazee.io 平台中，可通过 docker-compose.yml 与其他服务集成：

version: '3.8'
services:
  solr:
    image: amazeeio/solr:latest
    container_name: amazee-solr
    ports:
      - "8983:8983"
    volumes:
      - solr-data:/opt/solr/server/solr
    environment:
      - SOLR_HOME=/opt/solr/server/solr
      - SOLR_PORT=8983
    restart: unless-stopped

volumes:
  solr-data:

4.3 核心配置参数

4.3.1 环境变量

4.3.2 数据持久化

通过挂载卷 /opt/solr/server/solr 持久化 Solr 核心配置、索引数据及日志，避免容器重启后数据丢失。

4.3.3 自定义配置

如需修改 Solr 配置（如 solr.xml、核心配置 core.properties 等），可将自定义配置文件挂载至 $SOLR_HOME 目录下的对应路径，容器启动时会自动加载。

5. 注意事项

• 环境限制：该镜像未针对 OpenShift 容器平台进行适配，在 OpenShift 环境中可能存在权限或网络配置冲突，不建议使用。
• 版本兼容性：使用前需确认镜像标签版本与应用依赖的 Solr 版本匹配，避免兼容性问题。
• 资源配置：根据应用负载调整 SOLR_JAVA_MEM 环境变量，避免内存不足导致服务异常。