docker-部署Elasticsearch

悠悠 2022-12-11 15:00 278阅读 0赞

# 前言 #

Elasticsearch是一款开源的搜索引擎框架，提供强大的搜索功能。下面简单介绍如何使用docker来部署Elasticsearch。更多信息请参考[官方文档][Link 1]。

## 拉取镜像 ##

获取Docker的Elasticsearch就像对Elastic Docker registry发出Docker pull命令一样简单。

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

或者，您可以下载其他Docker镜像，这些镜像只包含Apache 2.0许可下可用的特性。下载镜像,访问[www.docker.elastic.co][]。

## 用Docker启动单个节点集群 ##

要启动一个用于开发或测试的单节点Elasticsearch集群，请指定[单节点发现][Link 2]以绕过[引导检查][Link 3]:

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

## 用Docker组成启动多节点集群 ##

要在Docker中启动并运行三个节点的Elasticsearch集群，您可以使用Docker Compose:

1.  创建一个docker-compose.yml文件:

version: '3.7'
    services:
      es01:
        image: docker.elastic.co/elasticsearch/elasticsearch:7.9.2
        container_name: es01
        environment:
          - node.name=es01
          - cluster.name=es-docker-cluster
          - discovery.seed_hosts=es02,es03
          - cluster.initial_master_nodes=es01,es02,es03
          - bootstrap.memory_lock=true
          - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
        ulimits:
          memlock:
            soft: -1
            hard: -1
        volumes:
          - data01:/usr/share/elasticsearch/data
        ports:
          - 9200:9200
        networks:
          - elastic
      es02:
        image: docker.elastic.co/elasticsearch/elasticsearch:7.9.2
        container_name: es02
        environment:
          - node.name=es02
          - cluster.name=es-docker-cluster
          - discovery.seed_hosts=es01,es03
          - cluster.initial_master_nodes=es01,es02,es03
          - bootstrap.memory_lock=true
          - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
        ulimits:
          memlock:
            soft: -1
            hard: -1
        volumes:
          - data02:/usr/share/elasticsearch/data
        networks:
          - elastic
      es03:
        image: docker.elastic.co/elasticsearch/elasticsearch:7.9.2
        container_name: es03
        environment:
          - node.name=es03
          - cluster.name=es-docker-cluster
          - discovery.seed_hosts=es01,es02
          - cluster.initial_master_nodes=es01,es02,es03
          - bootstrap.memory_lock=true
          - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
        ulimits:
          memlock:
            soft: -1
            hard: -1
        volumes:
          - data03:/usr/share/elasticsearch/data
        networks:
          - elastic
    
    volumes:
      data01:
        driver: local
      data02:
        driver: local
      data03:
        driver: local
    
    networks:
      elastic:
        driver: bridge

这个示例Docker合成文件将显示一个三个节点的Elasticsearch集群。节点`es01`监听`localhost:9200`,`es02`和`es03`通过Docker网络与es01通信。

请注意，此配置在所有网络接口上公开了端口9200，并且考虑到Docker在Linux上操纵iptables的方式，这意味着您的Elasticsearch集群是可以公开访问的，可能会忽略任何防火墙设置。如果您不想公开端口9200，而是使用反向代理，那么在docator-compose.yml文件中将`9200:9200`替换为`127.0.0.1:9200:9200`。Elasticsearch将只能从主机本身访问。

名为`data01`、`data02`和`data03`的[Docker命名卷][Docker]存储节点数据目录，以便在重新启动时数据保持不变。如果它们还不存在，那么docker-compose将在启动集群时创建它们。

日志消息会到达控制台，并由配置的Docker日志驱动程序处理。默认情况下，您可以使用docker logs访问日志。

要停止集群，请运行docker-compose down。当您使用Docker-compose up重启集群时，Docker卷中的数据将被保留并加载。要在关闭集群时删除数据卷，请指定-v选项:docker-compose down -v。

## 启动启用TLS的多节点集群 ##

请参阅[Elasticsearch Docker容器中的加密通信][Elasticsearch Docker]，并[在启用TLS的Docker中运行弹性堆栈][TLS_Docker]。

# 在生产中使用Docker镜像 #

以下要求和建议适用于在生产中Docker中运行Elasticsearch。

## 设置vm.max\_map\_count至少为262144 ##

对于生产使用，vm.max\_map\_count内核设置必须至少设置为262144(32k)。

## 配置文件必须是elasticsearch用户可读的 ##

默认情况下，Elasticsearch使用`uid:gid 1000:0`作为用户`elasticsearch`在容器内运行。

## 增加nofile和nproc的ulimit ##

对于Elasticsearch容器，必须对nofile和nproc增加ulimit。验证Docker守护进程的init系统将它们设置为可接受的值。

## 禁用交换 ##

为了性能和节点稳定性，需要禁用交换。有关此操作方法的信息，请参见[禁用交换][Link 4]。

# 配置Elasticsearch与Docker #

在Docker中运行时，[Elasticsearch配置文件][Elasticsearch]从`/usr/share/elasticsearch/config/`加载。

## 加载Elasticsearch配置文件 ##

创建自定义配置文件，并将它们绑定挂载到Docker镜像中的相应文件上。例如，绑定挂载`custom_elasticsearch.yml`与`docker`运行，指定:

-v full_path_to/custom_elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml

## 挂载一个Elasticsearch密钥库 ##

默认情况下，Elasticsearch将自动为安全设置生成一个密钥存储库文件。该文件是模糊的，但没有加密。如果希望使用密码对安全设置进行加密，则必须使用elasticsearch-keystore实用程序创建一个受密码保护的密钥存储，并将其绑定挂载到容器/usr/share/elasticsearch/config/elasticsearch.keystore。为了在Docker容器启动时提供密码，将Docker环境值KEYSTORE\_PASSWORD设置为您的密码值。例如，docker run命令可能有以下选项：

-v full_path_to/elasticsearch.keystore:/usr/share/elasticsearch/config/elasticsearch.keystore
    -E KEYSTORE_PASSWORD=mypassword

[Link 1]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/docker.html
[www.docker.elastic.co]: https://www.docker.elastic.co/
[Link 2]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/bootstrap-checks.html#single-node-discovery
[Link 3]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/bootstrap-checks.html
[Docker]: https://docs.docker.com/storage/volumes
[Elasticsearch Docker]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/configuring-tls-docker.html
[TLS_Docker]: https://www.elastic.co/guide/en/elastic-stack-get-started/7.9/get-started-docker.html#get-started-docker-tls
[Link 4]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/setup-configuration-memory.html
[Elasticsearch]: https://www.elastic.co/guide/en/elasticsearch/reference/7.9/settings.html#config-files-location