基于 Docker18.09.0

---

介绍

Elasticsearch也可用作Docker镜像。图像使用centos:7作为基本图像。

有关所有已发布的Docker镜像和标记的列表，请访问 www.docker.elastic.co。源代码在 GitHub中。

获取镜像

官方文档

docker pull docker.elastic.co/elasticsearch/elasticsearch:6.5.2

启动

开发模式

可以使用以下命令快速启动Elasticsearch以进行开发或测试：

docker run -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" docker.elastic.co/elasticsearch/elasticsearch:6.5.1

生产模式

生产环境下， 内核参数 vm.max_map_count 最少设置为 262144

设置方法根据自己的平台设置：

• Linux

1. 编辑文件 /etc/sysctl.conf

$ grep vm.max_map_count /etc/sysctl.conf
vm.max_map_count=262144

2. 并执行如下 命令使之生效

sysctl -w 

• Mac

$ screen ~/Library/Containers/com.docker.docker/Data/vms/0/tty

sysctl -w vm.max_map_count=262144

Elasticsearch集群

下面的实例，将启动两个节点的集群

1. docker-compose.yml:

version: '2.2'
services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:6.5.1
    container_name: elasticsearch
    environment:
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata1:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    networks:
      - esnet
  elasticsearch2:
    image: docker.elastic.co/elasticsearch/elasticsearch:6.5.1
    container_name: elasticsearch2
    environment:
      - cluster.name=docker-cluster
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
      - "discovery.zen.ping.unicast.hosts=elasticsearch"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - esdata2:/usr/share/elasticsearch/data
    networks:
      - esnet

volumes:
  esdata1:
    driver: local
  esdata2:
    driver: local

networks:
  esnet:

2. 执行如下命令启动集群

• 前台启动

docker-compose up  

• 后台启动

docker-compose up -d

3. 停止集群

要停止群集，请键入:

docker-compose down

这样的话，数据量将持续存在，因此可以使用docker-compose up使用相同的数据再次启动集群。

要销毁群集和数据卷，只需键入:

docker-compose down -v

4. 检查机器状态

在宿主机上执行如下命令，进行健康检查。

curl http://127.0.0.1:9200/_cat/health

输出：
1544110980 15:43:00 docker-cluster green 2 2 0 0 0 0 0 0 - 100.0%

---

配置 Elasticsearch

使用容器实现的 Elasticsearch 可以用一下三种方式的任意一种来对其进行配置。

1. 在启动容器的时候，使用 -e 指定 docker 容器的环境变量的方式

例如，要定义群集名称:

-e  "cluster.name=my_ela_clustername"

双引号是必需的。

2. docker run 的时候，使用挂载本地文件到容器中的方式。

Elasticsearch 从下面的目录中加载其配置
/usr/share/elasticsearch/config/

一般，我们会在宿主机中编辑一个自定义的配置文件 elasticsearch.yml, 之后绑定到容器中

--mount type=bind,src=/full_path_to/custom_elasticsearch.yml,dst=/usr/share/elasticsearch/config/elasticsearch.yml

3. Dockerfile 实现

在某些环境中，准备包含配置的自定义映像可能更有意义。利用 Dockerfile 很容易就能实现。

Dockerfile

FROM docker.elastic.co/elasticsearch/elasticsearch:6.5.2 
COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/

默认情况下，Elasticsearch 在容器中，将使用名为 elasticsearch的用户,且 uid:gid 为 1000:1000 去运行。
所以注意目录和文件的权限问题。同时还有关注日志目录和数据目录的权限。

这样构建镜像

docker build -t elasticsearch-custom .
docker run -ti --monut type=bind,src=/ela/data,dst=/usr/share/elasticsearch/data elasticsearch-custom

默认值和生产环境下的建议

1. 程序启动的默认用户

在一个Elasticsearch 的容器中，运行程序的默认用户是 elasticsearch，并且其 uid:gid为 1000:1000

如果要绑定安装本地目录或文件，请确保此用户可以读取它，而数据和日志目录还需要写访问权限。
一个好的策略是授予gid 为 1000 的组访问本地目录的权限。

例如，要准备一个本地目录来通过bind-mount存储数据。

mkdir esdatadir
chmod g+rwx esdatadir
chgrp 1000 esdatadir

2. 设置 ulimits 的 nofile 和 nproc

ulimits 的 nofile 和 nproc 对于Elasticsearch容器是至关重要的参数。

可以在 docker run 的时候假如如下代码：

--ulimit nofile=65536:65536

检查以上参数的的默认值

docker run --rm centos:7 /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'

3. 设置 JAVA 虚拟机的堆大小

使用ES_JAVA_OPTS环境变量设置堆大小。
例如，使用16GB,在 docker run 时使用-e ES_JAVA_OPTS="-Xms16g -Xmx16g"

4. 建议始终使用绑定的卷 /usr/share/elasticsearch/data

好处：
a. 如果容器被杀死，弹性搜索节点的数据不会丢失
b. Elasticsearch对I/O敏感，Docker存储驱动程序不适合快速I/O.
c. 它允许使用高级 Docker卷插件

5. 关于存储驱动程序

如果您使用的是devicemapper存储驱动程序，请确保未使用默认loop-lvm模式。配置docker-engine 代替使用 direct-lvm。

6. 关于日志记录驱动程序

请考虑使用其他日志记录驱动程序集中日志。
另请注意，默认的 json-file日志记录驱动程序不适合生产使用。