zinvoice/elasticsearch

Elasticsearch Docker容器

镜像概述和主要用途

本镜像基于BusyBox构建，提供轻量级、可配置的Elasticsearch服务，是ELK（Elasticsearch, Logstash, Kibana）栈的核心组件之一，用于日志存储、搜索和分析。

核心功能和特性

• 轻量级设计：基于BusyBox，最小化镜像占用空间
• 灵活配置：支持多种方式自定义Elasticsearch配置
• ELK栈兼容：可与以下镜像配合构建完整ELK栈：
  • zinvoice/logstash
  • sirile/kibanabox
  • progrium/logspout
  • tonistiigi/dnsdock

使用场景和适用范围

• 日志集中管理与分析系统
• 数据搜索与存储服务
• 需要部署ELK栈的开发/生产环境
• 容器化日志收集与处理架构

使用方法和配置说明

快速启动（使用docker-compose）

若已安装docker-compose，可下载docker-compose.yml文件，通过以下命令启动完整ELK栈：

bash
docker-compose up -d

手动快速启动

Elasticsearch单独启动

bash
docker run -d --name elasticsearch -h elasticsearch \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -p 9200:9200 \
    zinvoice/elasticsearch

ELK栈完整启动

如需启动完整ELK栈，可运行以下兼容容器：

Logstash

bash
docker run -d --name logstash -h logstash \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -p 9200:9200 \
    zinvoice/logstash

Kibana

bash
docker run -d --name kibana -h kibana \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -p 8000:80 \ 
    sirile/kibanabox

Logspout

bash
docker run -d --name logspout -h logspout \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -v /var/run/docker.sock:/tmp/docker.sock \
    -p 8100:8000 \ 
    progrium/logspout \
    syslog://<LOGSTASH的IP或主机名>:5000

若使用dnsdock，可直接使用logstash作为Logstash的DNS条目，无需指定IP或主机名。

工作原理

• 使用progrium/logspout容器（Docker守护进程感知型容器）将所有运行中容器的STDOUT和STDERR流转发至Logstash
• 通过dnsdock实现容器间DNS解析，无需手动链接容器

配置说明

Elasticsearch支持以下两种配置方式：

方法1：挂载自定义配置文件

将主机上的自定义elasticsearch.yml文件挂载到容器中：

bash
docker run -d --name elasticsearch -h elasticsearch \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -v /host/dir/elasticsearch.yml:/opt/elasticsearch/config/elasticsearch.yml \
    -p 9200:9200 \
    zinvoice/elasticsearch

替换/host/dir/elasticsearch.yml为您主机上的配置文件路径

方法2：使用配置容器

1. 创建配置容器Dockerfile，定义卷并复制配置文件：

   dockerfile
   FROM busybox
   VOLUME /opt/elasticsearch/config/
   COPY elasticsearch.yml /opt/elasticsearch/config/
   

2. 构建并创建配置容器（无需运行）：

   bash
   docker build -t your/config-container .
   

3. 启动Elasticsearch并挂载配置容器的卷：

   bash
   docker run -d --name elasticsearch -h elasticsearch \
       -v /etc/localtime:/etc/localtime:ro \
       -v /etc/timezone:/etc/timezone:ro \
       --volumes-from your/config-container \
       -p 9200:9200 \
       zinvoice/elasticsearch