codice/ddf-solr

DDF兼容Solr容器镜像

镜像概述与主要用途

本镜像基于官方Solr镜像构建，通过添加必要组件实现与DDF（Distributed Data Framework）的完全兼容。主要用途是为DDF环境提供即插即用的Solr搜索引擎服务，简化DDF生态中搜索功能的部署与集成流程。

核心功能与特性

新增插件

• ddf.platform.solr:solr-xpath：提供XPath查询语法支持的Solr专用插件。

新增依赖库

• org.locationtech.jts:jts-core：地理空间数据处理核心库，支持空间索引与拓扑运算。

新增辅助工具

• create-ddf-core [核心名称...]：DDF兼容Solr核心创建脚本，支持批量创建多个核心（参数为空格分隔的核心名称列表）。

使用场景与适用范围

• DDF分布式数据框架环境的搜索引擎部署。
• 需要快速集成Solr且要求与DDF生态兼容的应用场景。
• 需扩展Solr核心数量、添加自定义插件或依赖库的DDF相关业务系统。

使用方法与配置说明

基本运行

通过以下命令启动容器，默认将Solr服务端口（容器内8983）映射至主机8994端口：

bash
docker container run -d -p 8994:8983 codice/ddf-solr:<ddf-version>

说明：<ddf-version>需替换为实际DDF版本号（如2.10.0）；端口映射可根据实际需求调整（格式：主机端口:容器端口）。

镜像扩展

当需要添加自定义核心、插件或依赖库时，可基于本镜像构建下游镜像：

1. 基础镜像引用
   在自定义Dockerfile中声明基础镜像：

   dockerfile
   FROM codice/ddf-solr:<ddf-version>
   

2. 核心创建
   使用内置脚本批量创建DDF兼容核心：

   dockerfile
   # 创建名为"metadata"和"assets"的两个DDF兼容核心
   RUN create-ddf-core metadata assets
   

3. 插件/库扩展
   通过COPY指令添加自定义文件至Solr目录（官方Solr镜像标准路径：/opt/solr/server/solr/lib/）：

   dockerfile
   # 添加自定义插件JAR包
   COPY ./custom-plugin.jar /opt/solr/server/solr/lib/
   

镜像推送至Docker.io（维护说明）

如需将镜像推送至docker.io/codice/ddf-solr仓库，需在Maven配置文件（settings.xml）中添加Docker.io服务器认证配置：

xml
<servers>
  <server>
    <id>docker.io</id>
    <username>[Docker.io用户名]</username>
    <password>[Docker.io密码]</password>
  </server>
</servers>

部署示例

Docker Run部署

bash
# 拉取指定版本镜像
docker pull codice/ddf-solr:2.10.0

# 启动容器（命名为ddf-solr-service，端口映射8994:8983）
docker run -d \
  --name ddf-solr-service \
  -p 8994:8983 \
  --restart unless-stopped \
  codice/ddf-solr:2.10.0

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  ddf-solr:
    image: codice/ddf-solr:<ddf-version>
    container_name: ddf-solr-node
    ports:
      - "8994:8983"
    restart: unless-stopped
    # 可选：挂载数据卷持久化核心数据
    volumes:
      - ./solr-data:/opt/solr/server/solr/mycores
    # 可选：添加环境变量（如JVM参数）
    environment:
      - SOLR_JAVA_MEM="-Xms512m -Xmx1g"

启动服务：

bash
docker-compose up -d