luky/elasticsearch

Docker镜像文档

镜像概述

本镜像为基于Elasticsearch的扩展镜像，预安装了kopf、delete-by-query和analysis-icu三个核心插件，旨在提供更完善的Elasticsearch集群管理、数据操作及文本处理能力。通过预设环境变量，可快速配置集群名称及索引参数。

核心功能与特性

内置插件

• kopf：Elasticsearch集群管理插件，提供Web界面用于监控集群状态、索引管理、节点信息查看等操作。
• delete-by-query：支持通过查询条件批量删除Elasticsearch文档，简化数据清理流程。
• analysis-icu：基于ICU（International Components for Unicode）库的文本分析插件，提供多语言分词、字符 normalization 等国际化文本处理能力。

环境变量配置

• CLUSTER_NAME：设置Elasticsearch集群名称，默认值为cqb。
• INDEX_NUMBER_OF_SHARDS：设置默认索引分片数量，默认值为1。
• INDEX_NUMBER_OF_REPLICAS：设置默认索引副本数量，默认值为0。

使用场景

• 需要可视化管理Elasticsearch集群的场景。
• 需按查询条件批量清理Elasticsearch文档的场景。
• 处理多语言文本数据，需进行精准分词和国际化文本分析的场景。

使用方法

基本运行命令

bash
docker run -d \
  -e CLUSTER_NAME=my-cluster \
  -e INDEX_NUMBER_OF_SHARDS=3 \
  -e INDEX_NUMBER_OF_REPLICAS=1 \
  -p 9200:9200 \
  -p 9300:9300 \
  [镜像名称]

参数说明

• -e CLUSTER_NAME：自定义集群名称，替换my-cluster为实际集群名。
• -e INDEX_NUMBER_OF_SHARDS：设置索引分片数，根据数据量调整（如3分片）。
• -e INDEX_NUMBER_OF_REPLICAS：设置索引副本数，提升可用性（如1副本）。
• -p 9200:9200：映射Elasticsearch HTTP端口，用于API访问和kopf插件Web界面。
• -p 9300:9300：映射Elasticsearch节点间通信端口。

插件访问

• kopf插件：启动容器后，通过http://localhost:9200/_plugin/kopf/访问Web管理界面。
• delete-by-query插件：通过Elasticsearch API使用，示例：

  bash
  curl -X DELETE "http://localhost:9200/index_name/_delete_by_query" -H "Content-Type: application/json" -d '{"query": {"match": {"field": "value"}}}'
  

• analysis-icu插件：创建索引时指定分析器，示例：

  bash
  curl -X PUT "http://localhost:9200/index_name" -H "Content-Type: application/json" -d '{
    "settings": {
      "analysis": {
        "analyzer": {
          "icu_analyzer": {
            "type": "custom",
            "tokenizer": "icu_tokenizer"
          }
        }
      }
    }
  }'