geerlingguy/solr

Apache Solr容器（基于Ansible构建）

项目组成

该项目包含三个主要部分：

• Ansible项目：维护于GitHub仓库https://github.com/geerlingguy/solr-container%EF%BC%8C%E6%89%80%E6%9C%89%E9%97%AE%E9%A2%98%E5%8F%8D%E9%A6%88%E3%80%81%E6%94%AF%E6%8C%81%E8%AF%B7%E6%B1%82%E8%AF%B7%E6%8F%90%E4%BA%A4%E8%87%B3%E8%AF%A5%E4%BB%93%E5%BA%93%E3%80%82
• Docker Hub镜像：直接使用Docker Hub上的https://hub.docker.com/r/geerlingguy/solr/%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8F%AF%E4%BB%8EDocker Hub拉取。
• Ansible角色：如需灵活适配传统服务器与容器化构建的Ansible角色，可参考Ansible Galaxy上的geerlingguy.solr（该角色负责管理Apache Solr容器的核心配置工作）。

版本支持

当前维护的版本包括：

• 9.x、[最新版本标签]、latest：Apache Solr 9.x
• 8.x、8.11.2：Apache Solr 8.x
• 7.x、7.7.3：Apache Solr 7.x
• 6.x、6.6.6：Apache Solr 6.x（** legacy - 无更新**）
• 5.x、5.5.5：Apache Solr 5.x（** legacy - 无更新**）
• 4.x、4.10.4：Apache Solr 4.x（** legacy - 无更新**）

独立使用

若只需使用Docker Hub的geerlingguy/solr镜像，无需安装整个项目，可通过以下方式快速部署：

Docker Run命令

bash
docker run -d --name=solr -p 8983:8983 geerlingguy/solr:latest /opt/solr/bin/solr start -p 8983 -f -force

对于Solr 4.x和5.x版本，需移除命令末尾的-force参数。

Docker Compose配置

可将配置整合到docker-compose.yml中简化管理：

yaml
version: "3"

services:
  solr:
    image: geerlingguy/solr:latest
    container_name: solr
    ports:
      - "8983:8983"
    restart: always
    # 卷配置参见下方"自定义和持久化Solr核心"
    volumes: []
    command: ["/opt/solr/bin/solr", "start", "-p", "8983", "-f", "-force"]

启动命令：

bash
docker-compose up -d

服务启动后，可通过http://localhost:8983/访问Solr管理界面。

自定义和持久化Solr核心

默认安装中，SOLR_HOME目录为/var/solr，包含默认核心collection1。Solr会通过搜索各子目录中的core.properties文件自动发现核心。

core.properties文件示例

对于名为mysearch的核心，创建core.properties文件：

properties
name=mysearch
config=solrconfig.xml
schema=schema.xml
dataDir=data

核心目录结构示例：

mysearch/
├── conf/
│   ├── schema.xml
│   ├── solrconfig.xml
│   └── ...（其他配置文件）
├── core.properties
└── data/

卷挂载方式

通过卷挂载实现核心配置自定义及数据持久化：

• 单核心：

  yaml
  volumes:
    - ./mysearch:/var/solr/mysearch:rw
  

• 多核心：

  yaml
  volumes:
    - ./cores:/var/solr/cores:rw  # cores目录下包含多个核心文件夹
  

Apache Solr 3.x注意事项

使用Solr 3.x时需注意：

• 不支持core.properties及核心自动发现，需将核心配置（至少包含conf和data目录）挂载至/opt/solr/example/solr。
• 暂不官方支持多核心。
• 启动命令需使用：java -jar start.jar（在/opt/solr/example目录下执行）。

许可证

MIT / BSD

作者信息

该容器构建由Jeff Geerling于2017年创建，他也是《Ansible for DevOps》一书的作者。