CKAN Solr 镜像文档

1. 镜像概述和主要用途

CKAN Solr 镜像是为快速部署 CKAN（开源数据门户平台）而预配置的 Apache Solr 镜像。该镜像集成了与特定 CKAN 版本兼容的 Solr 配置，简化了 CKAN 部署流程中 Solr 搜索引擎的搭建步骤，适用于需要快速搭建 CKAN 环境的开发、测试或生产场景。

2. 核心功能和特性

• 预配置兼容性：内置针对 CKAN 优化的 Solr 配置（如索引 schema、字段定义等），无需手动调整 Solr 配置文件。
• 版本对应：镜像标签明确关联 CKAN 版本与 Solr 版本（如 2.10-solr9 表示适用于 CKAN 2.10 和 Solr 9），确保版本匹配。
• 即开即用：启动后可直接与 CKAN 连接，省去 Solr 核心初始化及索引配置步骤。

3. 使用场景和适用范围

• CKAN 部署环境：适用于需要集成 Solr 搜索引擎的 CKAN 平台搭建，包括开发、测试及生产环境。
• 简化配置需求：适合希望避免手动配置 Solr（如编写 schema.xml、调整索引参数）的用户或团队。
• 版本化部署：需根据 CKAN 版本选择对应 Solr 版本的场景，确保兼容性和稳定性。

4. 详细使用方法和配置说明

4.1 前提条件

• 已安装 Docker 环境（推荐 Docker Engine 19.03+）。
• 了解目标 CKAN 版本，以便选择对应标签的镜像。

4.2 镜像标签说明

镜像标签格式为 <CKAN版本>-solr<Solr版本>，表示与指定 CKAN 版本和 Solr 版本兼容。
可用标签及兼容性详情：访问 CKAN Solr 镜像 GitHub 仓库。

4.3 基本部署（Docker Run）

使用以下命令快速启动 Solr 容器（以 CKAN 2.10 + Solr 9 为例）：

docker run --name ckan-solr -p 8983:8983 -d ckan/ckan-solr:2.10-solr9

参数说明：

• --name ckan-solr：指定容器名称为 ckan-solr，便于管理。
• -p 8983:8983：将容器内 Solr 默认端口 8983 映射到主机 8983 端口，允许外部访问 Solr 服务。
• -d：以守护进程（后台）模式运行容器。
• ckan/ckan-solr:2.10-solr9：镜像名称及标签，需根据目标 CKAN 版本替换。

4.4 容器管理

• 查看容器状态：

  docker ps --filter "name=ckan-solr"
  

• 访问 Solr 管理界面：
  容器启动后，通过 http://localhost:8983/solr 访问 Solr 管理界面，验证服务是否正常运行。

• 停止/删除容器：

  docker stop ckan-solr  # 停止容器
  docker rm ckan-solr    # 删除容器（需先停止）
  

4.5 Docker Compose 部署（推荐生产环境）

适用于多容器部署（如同时运行 CKAN、数据库、Solr 等），示例 docker-compose.yml 配置：

version: '3'
services:
  ckan-solr:
    image: ckan/ckan-solr:2.10-solr9  # 替换为目标标签
    container_name: ckan-solr
    ports:
      - "8983:8983"  # 端口映射
    restart: unless-stopped  # 异常退出后自动重启
    volumes:
      - ckan-solr-data:/var/solr/data  # 挂载数据卷，持久化 Solr 数据

volumes:
  ckan-solr-data:  # 定义数据卷，避免容器删除导致数据丢失

启动命令：

docker-compose up -d  # 后台启动服务

5. 注意事项

• 端口冲突：若主机 8983 端口已被占用，可修改端口映射（如 -p 8984:8983 将主机 8984 端口映射到容器 8983 端口）。
• 数据持久化：生产环境需通过数据卷（如示例中的 ckan-solr-data）挂载 Solr 数据目录，防止容器删除导致索引数据丢失。
• 安全控制：生产环境中应限制 Solr 端口访问范围（如通过防火墙或反向代理），避免直接暴露公网。