doctrine/elasticsearch-with-plugins

ElasticSearch 插件预装镜像文档

镜像概述

本镜像基于官方ElasticSearch镜像构建，预先集成了ICU（International Components for Unicode）和LTR（Learning to Rank）插件，旨在简化需要多语言文本处理和机器学习排序功能的ElasticSearch部署流程。通过预装插件，避免了手动安装配置的复杂性，可直接用于生产或开发环境。

核心功能与特性

基础功能

• 完整继承官方ElasticSearch镜像的全部功能，包括分布式搜索、实时分析、水平扩展等核心能力
• 支持ElasticSearch官方版本的所有API和配置选项

预装插件功能

• ICU插件（analysis-icu）

  • 提供国际化文本处理能力，支持多语言分词、字符规范化和排序
  • 解决非英语语言的文本分析问题，如中文、日文、阿拉伯文等复杂语言处理

• LTR插件（elasticsearch-learning-to-rank）

  • 集成机器学习排序功能，支持通过训练模型优化搜索结果排序
  • 提供特征提取、模型训练和排序执行的完整工作流
  • 兼容ElasticSearch的查询DSL，可无缝集成到现有搜索流程

使用场景与适用范围

• 多语言搜索应用：需要处理中文、日文、阿拉伯文等非英语语言的企业搜索系统
• 智能排序系统：电商搜索、内容推荐、学术文献检索等需要精准排序的场景
• 国际化业务平台：跨国企业的日志分析、用户行为分析系统
• 快速原型开发：需要快速验证LTR排序效果或多语言处理能力的开发环境

使用方法与配置说明

基本部署

使用以下命令启动容器：

bash
docker run -d \
  --name es-plugin \
  -p 9200:9200 \
  -p 9300:9300 \
  -e "discovery.type=single-node" \
  elasticsearch-plugin-icu-ltr:latest

核心环境变量配置

插件验证

容器启动后，通过以下命令验证插件是否安装成功：

bash
# 验证ICU插件
curl http://localhost:9200/_cat/plugins | grep analysis-icu

# 验证LTR插件
curl http://localhost:9200/_cat/plugins | grep learning-to-rank

成功安装时，将分别返回包含analysis-icu和learning-to-rank的插件信息。

持久化数据配置

为避免数据丢失，建议挂载数据卷：

bash
docker run -d \
  --name es-plugin \
  -p 9200:9200 \
  -p 9300:9300 \
  -e "discovery.type=single-node" \
  -v es-data:/usr/share/elasticsearch/data \
  elasticsearch-plugin-icu-ltr:latest

注意：挂载数据卷时需确保宿主机目录权限正确（ElasticSearch容器内使用uid 1000运行）

注意事项

• 本镜像版本与官方ElasticSearch版本保持同步，使用时需注意版本兼容性
• LTR插件需要ElasticSearch 7.0+版本支持，低版本环境不适用
• 生产环境建议配置集群模式，单节点模式仅用于开发和测试
• 如需添加更多插件，可基于此镜像构建自定义Dockerfile