metabrainz/solr

支持的标签及对应Dockerfile链接

• https://github.com/metabrainz/docker-openjdk8-solr7/blob/a607ea024403305229d493153b8c571b28c5fc52/7.7/alpine/Dockerfile

该镜像通过向https://github.com/metabrainz/docker-openjdk8-solr7提交PR进行更新，该仓库衍生自https://github.com/docker-solr/docker-solr。

什么是Apache Solr™？

Apache Solr是高可靠、可扩展且容错的搜索引擎，提供分布式索引、复制、负载均衡查询、自动故障转移与恢复、集中配置等功能，为全球众多大型网站的搜索和导航特性提供支持。

了解更多信息请访问http://lucene.apache.org/solr/和https://lucene.apache.org/solr/guide/。

***.org/wiki/Apache_Solr

Docker镜像快速开始

以下说明适用于solr:8.0.0及以上版本。

主机挂载目录运行Solr

通常用户首先希望在容器中运行单节点Solr服务器，创建单个核心存储数据，并将数据保存在本地目录。这对开发者很方便，也可用于单服务器生产环境。

console
$ mkdir solrdata
$ docker run -d -v "$PWD/solrdata:/var/solr" -p 8983:8983 --name my_solr solr:8 solr-precreate gettingstarted

打开浏览器访问http://localhost:8983/查看管理控制台（根据Docker主机调整 hostname）。在UI中点击"Core Admin"，应能看到"gettingstarted"核心。

加载容器内的示例数据：

console
$ docker exec -it my_solr post -c gettingstarted example/exampledocs/manufacturers.xml

在UI中选择"Core selector"菜单的"gettingstarted"核心，点击"Query"菜单，默认搜索*:*会返回所有文档，点击"Execute Query"即可看到结果。

Docker-compose单服务器部署

使用Docker Compose运行单节点服务器，可使用Docker卷替代主机挂载目录。示例docker-compose.yml：

yaml
version: '3'
services:
  solr:
    image: docker.xuanyuan.run/solr:8
    ports:
     - "8983:8983"
    volumes:
      - data:/var/solr
    command:
      - solr-precreate
      - gettingstarted
volumes:
  data:

运行命令：

console
docker-compose up -d

单命令演示

快速演示docker-solr：启动Solr、创建名为"demo"的集合并加载示例数据：

console
$ docker run --name solr_demo -d -p 8983:8983 solr:8 solr-demo

分布式Solr

查看https://github.com/docker-solr/docker-solr-examples/blob/master/docker-compose/docker-compose.yml获取启动Solr简单集群配置的Docker Compose文件。

镜像工作原理

容器包含Solr安装（通过https://lucene.apache.org/solr/guide/7_7/taking-solr-to-production.html#service-installation-script安装），Solr分发版存储在`/opt/solr`，数据和日志存储在`/var/solr`，配置文件为`/etc/default/solr`。若需持久化数据，挂载卷或目录到`/var/solr`。

docker-solr分发版在/opt/docker-solr/scripts添加脚本，方便Docker环境使用（如容器启动时创建核心）。

创建核心

Solr standalone模式下需创建"cores"存储数据。Docker-solr提供多种方式：

1. 启动容器后手动执行控制脚本：

console
$ docker run -d -p 8983:8983 --name my_solr solr:8 
$ docker exec -it my_solr solr create_core -c gettingstarted

2. 使用solr-precreate命令（推荐）：

console
$ docker run -d -p 8983:8983 --name my_solr solr:8 solr-precreate gettingstarted

3. 使用solr-create命令：

console
$ docker run -d -p 8983:8983 --name my_solr solr:8 solr-create -c gettingstarted

4. 自定义命令行：

console
$ docker run -p 8983:8983 -v $PWD/mysetup.sh:/mysetup.sh --name my_solr solr:8 bash -c "precreate-core gettingstarted && source /mysetup.sh && solr-foreground"

创建集合

SolrCloud集群中创建"collections"存储数据，方式包括：

1. 通过Solr Admin UI创建；
2. 在容器中执行Solr控制脚本；
3. 使用独立容器创建；
4. 使用远程API创建。

加载自定义数据

常见方式包括：

• 使用独立容器挂载数据卷并加载；
• 在集群网络中加载；
• 启动时挂载数据卷并通过docker exec或自定义脚本加载。

solr.in.sh配置

Solr常用solr.in.sh配置，可通过环境变量覆盖或挂载自定义配置文件：

console
$ docker run -d -p 8983:8983 -e SOLR_HEAP=800m solr

扩展镜像

容器运行时会执行/docker-entrypoint-initdb.d/目录下的脚本，可通过挂载卷或自定义Dockerfile添加脚本。示例： 创建custom.sh脚本：

console
#!/bin/bash
set -e
echo "容器启动前执行的自定义脚本"

运行命令：

console
$ docker run --name solr_custom1 -d -v $PWD/custom.sh:/docker-entrypoint-initdb.d/custom.sh solr

从Docker-solr5-7升级到8

Solr 8版本切换为使用服务安装脚本，存在向后不兼容变化，升级需注意：

• 数据存储路径从/opt/solr/server/solr改为/var/solr/data；
• 不再支持自定义SOLR_HOME；
• 不再支持覆盖SOLR_PORT。

关于本仓库

本仓库位于https://github.com/metabrainz/docker-openjdk8-solr7，官方构建在https://hub.docker.com/r/metabrainz/solr/。

许可证

Solr使用https://www.apache.org/licenses/LICENSE-2.0授权。本仓库同样使用该许可证。

用户反馈

问题报告

请在Bug Tracker报告镜像问题。Solr相关问题请参考http://lucene.apache.org/solr/resources.html#community。

贡献

若想贡献Solr，请查看http://lucene.apache.org/solr/resources.html#community。