monsantoco/elasticsearch

ElasticSearch Docker镜像文档

镜像概述

这是一个高度可配置的ElasticSearch Docker镜像，通过https://registry.hub.docker.com/u/monsantoco/elasticsearch/%E6%B5%81%E7%A8%8B%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E5%B8%83%E5%88%B0%E5%85%AC%E5%85%B1https://registry.hub.docker.com/%E3%80%82

该镜像通常作为Logstash实例的后端，配合Kibana作为前端，共同组成通常所说的ELK栈。

核心功能与特性

已安装插件

• BigDesk：提供Elasticsearch集群的实时图表和统计信息。可通过浏览器访问http://localhost:9200/_plugin/bigdesk/（需根据实际环境修改主机和端口）自动连接到ES节点。
• Elasticsearch Head：Elasticsearch集群的Web前端。访问http://localhost:9200/_plugin/head/即可在Elasticsearch集群中运行该插件。
• Curator：帮助管理索引的工具。
• AWS Cloud：允许使用AWS API进行单播发现和S3存储库快照。

使用场景

• 快速部署ELK栈的ElasticSearch后端节点
• 构建需要持久化存储的ElasticSearch集群
• 需要通过环境变量灵活配置的ElasticSearch实例
• 集成AWS云服务的ElasticSearch部署

使用方法

基本容器启动（临时存储）

启动一个使用临时存储的基础容器：

sh
docker run --name %p \
  --publish 9200:9200 \
  --publish 9300:9300 \
  monsantoco/elasticsearch

带持久化存储的容器启动

容器内暴露/var/lib/elasticsearch卷，包含data、log和config子目录。以下命令启动带数据持久化存储的容器：

sh
mkdir -p /es/data
docker run --rm --name %p \
  --publish 9200:9200 \
  --publish 9300:9300 \
  --volume /var/lib/elasticsearch/data:/var/lib/elasticsearch/data \
  monsantoco/elasticsearch

持久化存储确保数据在容器重启后保留（有一些明显的注意事项）。建议通过数据容器实现，最好托管在AWS S3存储桶或其他外部化的分布式持久存储上。

配置说明

环境变量配置

支持通过环境变量提供进一步配置，仅处理以ES_为前缀的变量。这些变量会按以下规则添加到Elasticsearch配置文件elasticsearch.yml中：

1. 移除ES_前缀
2. 转换为小写
3. 将单下划线_替换为.，双下划线__替换为单下划线_

示例：

• 环境变量ES_CLUSTER_NAME=lscluster会生成cluster.name=lscluster
• 环境变量ES_CLOUD_AWS_ACCESS__KEY=GHKDFIADFNADFIADFKJG会生成cloud.aws.access_key=GHKDFIADFNADFIADFKJG

自定义配置文件

可通过设置ES_CFG_URL环境变量为有效URL来导入自定义配置文件。环境变量替换规则同样适用于自定义文件。