itzg/elasticsearch

Elasticsearch 镜像文档

镜像概述和主要用途

该Docker镜像提供易于配置的Elasticsearch节点，通过端口映射可轻松创建任意规模的集群。只要版本匹配，可将容器化节点与"真实"Elasticsearch节点混合使用，适用于快速搭建搜索服务、日志分析平台等场景。

Linux主机使用注意事项

Elasticsearch 5.x要求设置足够的虚拟内存mmap计数以确保稳定的生产使用，参考官方指南获取更多信息。

核心功能和特性

• 灵活配置：通过环境变量快速调整节点参数，支持动态修改配置
• 集群扩展：支持单节点和多节点部署，轻松构建分布式集群
• 健康监控：内置健康检查机制，定期查询_cat/health端点
• 节点类型：支持主节点、数据节点、网关节点等多种角色配置
• 插件支持：可通过环境变量指定并自动安装 Elasticsearch 插件
• 持久化存储：提供数据和配置卷，确保数据持久化和配置可管理

使用场景和适用范围

• 开发环境：快速搭建单节点Elasticsearch进行应用开发和测试
• 测试环境：部署多节点集群验证分布式搜索和索引功能
• 生产环境：通过Docker Swarm或Compose部署高可用集群，支持节点角色分离

使用方法

基本使用

启动单节点Elasticsearch，监听标准端口：

bash
docker run -d -p 9200:9200 -p 9300:9300 itzg/elasticsearch

验证节点是否存活，访问：http://DOCKERHOST:9200/，应返回类似以下响应：

json
{
  "status" : 200,
  "name" : "Charon",
  "version" : {
    "number" : "1.3.5",
    "build_hash" : "4a50e7df768fddd572f48830ae9c35e4ded86ac1",
    "build_timestamp" : "2014-11-05T15:21:28Z",
    "build_snapshot" : false,
    "lucene_version" : "4.9"
  },
  "tagline" : "You Know, for Search"
}

其中DOCKERHOST为运行Docker的主机实际 hostname。

多节点集群（单Docker主机）

在单台Docker主机上运行3节点集群：

bash
docker run -d --name es0 -p 9200:9200 itzg/elasticsearch
docker run -d --name es1 --link es0 -e UNICAST_HOSTS=es0 itzg/elasticsearch
docker run -d --name es2 --link es0 -e UNICAST_HOSTS=es0 itzg/elasticsearch

检查集群健康状态，访问：http://192.168.99.100:9200/_cluster/health?pretty，应返回类似：

json
{
  "cluster_name" : "elasticsearch",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 3,
  "number_of_data_nodes" : 3,
  "active_primary_shards" : 0,
  "active_shards" : 0,
  "relocating_shards" : 0,
  "initializing_shards" : 0,
  "unassigned_shards" : 0
}

Swarm模式部署

若已初始化Docker Swarm集群，下载https://raw.githubusercontent.com/itzg/dockerfiles/master/elasticsearch/docker-compose.yml%E5%B9%B6%E9%83%A8%E7%BD%B2%EF%BC%9A

bash
docker stack deploy -c docker-compose.yml es

通过docker service ls确认服务运行状态，应包含1个主节点、2个数据节点、1个网关节点和1个Kibana实例：

ID            NAME        MODE        REPLICAS  IMAGE
9nwnno8hbqgk  es_kibana   replicated  1/1       kibana:latest
f5x7nipwmvkr  es_gateway  replicated  1/1       es
om8rly2yxylw  es_data     replicated  2/2       es
tdvfilj370yn  es_master   replicated  1/1       es

Kibana可通过端口5601访问。

健康检查

容器内置HEALTHCHECK机制，每30秒查询_cat/health端点。通过docker ps查看容器状态，健康状态显示为：

Up 14 minutes (healthy)

通过docker inspect查看健康检查历史：

bash
docker inspect -f "{{json .State.Health}}" es

返回类似：

json
{"Status":"healthy","FailingStreak":0,"Log":[...

配置说明

端口

• 9200 - HTTP REST接口
• 9300 - 原生传输接口

卷

• /data - 数据存储路径（对应path.data）
• /conf - 配置文件路径（对应path.conf）

环境变量配置

通过docker run -e NAME=VALUE指定配置，或在运行容器的/conf/env文件中设置（格式为NAME=VALUE）。未明确支持的配置可通过OPTS环境变量传递，默认OPTS=-Dnetwork.bind_host=_non_loopback_（自2.0版本起，bind_host默认值为localhost，此设置便于容器端口映射）。

集群名称

指定集群名称（默认"elasticsearch"）：

bash
-e CLUSTER=dockers

Zen Unicast主机

多物理主机集群中，若网络不支持多播，可通过逗号分隔的HOST:PORT列表指定集群节点：

bash
-e UNICAST_HOSTS=HOST:PORT[,HOST:PORT]

示例：

bash
-e UNICAST_HOSTS=192.168.0.100:9300

插件安装

通过逗号分隔的插件ID列表安装插件：

bash
-e PLUGINS=ID[,ID]

示例（安装Marvel插件）：

bash
-e PLUGINS=elasticsearch/marvel/latest

更多插件参考官方插件列表。

发布地址

覆盖容器内部IP地址，指定物理网络地址和端口：

bash
-e PUBLISH_AS=DOCKERHOST:9301

作者注：实际使用中很少需要此配置，除日志显示的IP地址外，Elasticsearch对网络配置有良好的容错性。

节点名称

指定节点名称（默认随机分配）：

bash
-e NODE_NAME=Docker

节点类型

根据Elasticsearch节点文档，支持多种节点类型，通过TYPE变量指定：

• 未设置（默认）：兼具主节点资格和数据节点
• MASTER：主节点资格，不存储数据（大型集群建议配置3个以上）
• DATA（或NON_MASTER）：数据节点，处理搜索/索引请求
• NON_DATA：除数据存储外的所有职责
• GATEWAY（或COORDINATING）：仅作为客户端节点/智能路由器，需暴露9200端口
• INGEST：仅作为摄取节点，无主节点或数据节点资格

Docker Compose示例：

yaml
version: '3'

services:
  gateway:
    image: itzg/elasticsearch
    environment:
      UNICAST_HOSTS: master
      TYPE: GATEWAY
    ports:
      - "9200:9200"

  master:
    image: itzg/elasticsearch
    environment:
      UNICAST_HOSTS: gateway
      TYPE: MASTER
      MIN_MASTERS: 2

  data:
    image: itzg/elasticsearch
    environment:
      UNICAST_HOSTS: master,gateway
      TYPE: DATA

  kibana:
    image: kibana
    ports:
      - "5601:5601"
    environment:
      ELASTICSEARCH_URL: http://gateway:9200

最小主节点数

配置最小主节点数以避免网络中断时的“脑裂”问题，计算公式为(主节点数 / 2) + 1，通过MIN_MASTERS设置：

bash
-e MIN_MASTERS=2

结合上述Compose示例，扩展主节点至3个时：

bash
docker-compose scale master=3

多网络绑定（Swarm模式）

Docker Swarm模式下容器可能有多个网络设备，可通过DISCOVER_TRANSPORT_IP和DISCOVER_HTTP_IP指定网络设备：

bash
-e DISCOVER_TRANSPORT_IP=eth0
-e DISCOVER_HTTP_IP=eth2

JVM选项（堆大小等）

默认Java堆大小为1GB，通过ES_JAVA_OPTS调整JVM参数：

bash
-e ES_JAVA_OPTS="-Xms16g -Xmx16g"

更多信息参考Elasticsearch堆大小指南。