ilios/opensearch

Ilios配置的Opensearch镜像

镜像概述

基于官方Opensearch构建的定制化镜像，专为Ilios教育管理平台设计。该镜像集成了与Ilios系统匹配的预配置参数，优化了搜索性能，提供开箱即用的搜索服务，无需额外手动配置即可与Ilios平台无缝集成。

核心功能与特性

• 预配置兼容性：内置与Ilios数据模型匹配的索引模板和映射配置，确保与Ilios API交互兼容性
• 优化搜索性能：针对教育场景数据特点（课程、用户、内容等）优化索引结构和查询性能
• 简化部署流程：省去手动配置Opensearch的步骤，降低集成复杂度
• 安全默认设置：包含基础安全配置，默认启用必要的认证机制（可根据需求调整）
• 版本同步：镜像版本与Ilios平台版本保持同步，确保功能匹配

使用场景

• Ilios教育平台部署环境中的搜索服务组件
• 教育机构课程管理系统中提供全文搜索功能
• Ilios平台本地化部署或容器化架构中的搜索服务节点

使用方法

基本部署

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

bash
docker run -d \
  --name ilios-opensearch \
  -p 9200:9200 \
  -p 9600:9600 \
  -e "discovery.type=single-node" \
  ilios/opensearch-configured:latest

数据持久化配置

为避免容器重启导致数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name ilios-opensearch \
  -p 9200:9200 \
  -p 9600:9600 \
  -e "discovery.type=single-node" \
  -v ilios-opensearch-data:/usr/share/opensearch/data \
  ilios/opensearch-configured:latest

说明：ilios-opensearch-data为持久化数据卷名称，首次运行时会自动创建

环境变量配置

支持通过环境变量调整核心参数：

docker-compose集成示例

在Ilios平台部署架构中，可通过docker-compose集成：

yaml
version: '3.8'
services:
  opensearch:
    image: ilios/opensearch-configured:latest
    container_name: ilios-opensearch
    ports:
      - "9200:9200"
      - "9600:9600"
    environment:
      - discovery.type=single-node
      - OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g
      - ILIOS_INDEX_PREFIX=ilios_prod_
      - TZ=America/New_York
    volumes:
      - opensearch-data:/usr/share/opensearch/data
    restart: unless-stopped

volumes:
  opensearch-data:

注意事项

• 生产环境建议根据负载调整OPENSEARCH_JAVA_OPTS参数，避免内存不足
• 多节点部署时需修改discovery.type参数并配置集群发现
• 定期备份opensearch-data卷数据，防止索引丢失
• 需根据Ilios平台版本选择对应标签的镜像，确保功能兼容性