fgaudin/elasticsearch

docker-elasticsearch 镜像文档

镜像概述和主要用途

docker-elasticsearch是用于部署和运行Elasticsearch的Docker镜像。Elasticsearch是一个开源的分布式搜索和分析引擎，基于Lucene构建，提供RESTful API接口，支持对结构化和非结构化数据进行高效的全文搜索、实时分析及复杂查询。该镜像旨在简化Elasticsearch的部署流程，便于快速搭建单节点或分布式集群环境。

核心功能和特性

• 分布式架构：支持水平扩展，可构建多节点集群，实现数据分片和副本机制，确保高可用性和容错能力。
• 全文搜索：基于Lucene的强大搜索能力，支持分词、模糊匹配、短语搜索等多种查询方式。
• 实时分析：提供近实时的数据索引和查询能力，延迟通常在秒级。
• RESTful API：通过HTTP接口进行数据索引、查询和管理操作，易于集成到各类应用系统。
• 多数据类型支持：兼容文本、数字、日期、地理坐标等多种数据类型，满足多样化业务需求。

使用场景和适用范围

• 日志与监控数据存储分析：收集、存储和分析系统日志、应用日志及监控指标。
• 全文检索系统：构建产品搜索、文档检索、内容推荐等功能。
• 业务数据分析：对用户行为、交易数据等业务数据进行实时统计和分析。
• 企业级搜索平台：为内部文档、知识库提供高效检索服务。

使用方法和配置说明

基本使用（单节点模式）

通过以下命令快速启动单节点Elasticsearch服务：

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

• -p 9200:9200：映射HTTP API端口，用于外部访问。
• -p 9300:9300：映射节点间通信端口（集群模式下使用）。
• -e "discovery.type=single-node"：指定单节点模式，无需集群发现。

环境变量配置

常用环境变量说明：

• ES_JAVA_OPTS：设置JVM参数，如-Xms512m -Xmx512m控制堆内存大小（建议设置为物理内存的50%，且不超过31GB）。
• cluster.name：指定集群名称，默认docker-cluster。
• node.name：指定节点名称，默认随机生成。
• network.host：绑定网络接口，默认0.0.0.0（允许外部访问）。

示例（自定义JVM内存和集群名称）：

bash
docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -e "discovery.type=single-node" \
  -e "ES_JAVA_OPTS=-Xms1g -Xmx1g" \
  -e "cluster.name=my-es-cluster" \
  docker-elasticsearch

Docker Compose配置（集群示例）

创建docker-compose.yml文件，部署3节点集群：

yaml
version: '3'
services:
  es01:
    image: docker-elasticsearch
    container_name: es01
    environment:
      - node.name=es01
      - cluster.name=es-cluster
      - discovery.seed_hosts=es02,es03
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
    volumes:
      - esdata01:/usr/share/elasticsearch/data
    networks:
      - es-network

  es02:
    image: docker-elasticsearch
    container_name: es02
    environment:
      - node.name=es02
      - cluster.name=es-cluster
      - discovery.seed_hosts=es01,es03
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    volumes:
      - esdata02:/usr/share/elasticsearch/data
    networks:
      - es-network

  es03:
    image: docker-elasticsearch
    container_name: es03
    environment:
      - node.name=es03
      - cluster.name=es-cluster
      - discovery.seed_hosts=es01,es02
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    volumes:
      - esdata03:/usr/share/elasticsearch/data
    networks:
      - es-network

volumes:
  esdata01:
  esdata02:
  esdata03:

networks:
  es-network:

启动集群：docker-compose up -d

验证服务

服务启动后，通过以下命令验证：

bash
curl http://localhost:9200/_cluster/health?pretty

返回集群健康状态（如"status" : "green"表示正常）。