Elasticsearch容器化部署

Elasticsearch标准软件基于Bitnami Elasticsearch 构建。当前版本为8.11.3

你可以通过轻云UC部署工具直接安装部署，也可以手动按如下文档操作，该项目已经全面开源，可以从如下环境获取 配置文件地址: qingcloud-platform: 一站式、开箱即用、可扩展的组件化软件工厂！高效易用 低代码 组件化 软件开发设计器。助力中小微企业低成本快速实现数字化转型，提高开发人员工作效率。

qinghub自动安装部署配置库

简介

Elasticsearch是一个分布式、可扩展、实时的搜索与数据分析引擎。它不仅仅只是全文搜索，还支持结构化搜索、数据分析、复杂的语言处理、地理位置和对象间关联关系等。ES也是使用Java编写的，ES的底层依赖Lucene,它的内部使用Lucene做索引与搜索，它的目的是隐藏Lucene的复杂性，取而代之的提供一套简单一致的Restful API。

初始化一个新实例

使用Docker 容器网络，应用程序容器可以轻松访问容器内运行的 Elasticsearch 服务器。

连接到同一网络的容器可以使用容器名称作为主机名来相互通信。

使用命令行

第 1 步：创建网络

docker network create app-tier --driver bridge

第 2 步：启动 Elasticsearch 服务器实例

docker run 添加命令--network app-tier的参数, 将elasticsearch-server容器连接到网络app-tier。

docker run -d --name elasticsearch-server \
    --network app-tier \
    registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest

第 3 步：启动应用程序容器

docker run -d --name myapp \
    --network app-tier \
    YOUR_APPLICATION_IMAGE

重要：

1. 注意替换YOUR_APPLICATION_IMAGE_占位符
2. 在容器中，使用主机名elasticsearch-server连接到 Elasticsearch 服务器

使用 Docker Compose 文件

如果未指定，Docker Compose 会自动设置一个新网络并将所有已部署的服务附加到该网络。但是我们将显式定义一个bridge名为app-tier的新网络。在此示例中，我们假设您希望从您自己的自定义应用程序映像连接到 Elasticsearch 服务器，该映像在以下代码段中通过服务名称进行标识myapp。

version: '2'

networks:
  app-tier:
    driver: bridge

services:
  elasticsearch:
    image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest'
    networks:
      - app-tier
  myapp:
    image: 'YOUR_APPLICATION_IMAGE'
    networks:
      - app-tier

重要：

1. 注意替换YOUR_APPLICATION_IMAGE_占位符
2. 在容器中，使用主机名elasticsearch-server连接到 Elasticsearch 服务器

使用以下命令启动容器：

docker-compose up -d

配置

环境变量

当您启动elasticsearch镜像时，您可以通过在docker-compose文件或docker run命令行上传递一个或多个环境变量来调整实例的配置。

• 对于 Docker Compose，在应用程序部分下添加变量名称和值：

elasticsearch:
  ...
  environment:
    - ELASTICSEARCH_PORT_NUMBER=9201
  ...

...

• 对于手动执行，增加-e为每个变量和值添加一个选项：

$ docker run -d --name elasticsearch \
    -p 9201:9201 --network=elasticsearch_network \
    -e ELASTICSEARCH_PORT_NUMBER=9201 \
    -v /path/to/elasticsearch-data-persistence:/bitnami/elasticsearch/data \
    registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch

可用变量：

• BITNAMI_DEBUG：增加初始化日志的详细程度。默认false
• ELASTICSEARCH_EXTRA_FLAGS：elasticsearch守护进程的额外命令行参数
• ELASTICSEARCH_CLUSTER_NAME：Elasticsearch 集群名称。默认值：elasticsearch-cluster
• ELASTICSEARCH_CLUSTER_HOSTS：用于设置集群的elasticsearch主机列表。可用的分隔符为“ ”、“,”和“;”。没有默认值。
• ELASTICSEARCH_CLUSTER_MASTER_HOSTS：符合elasticsearch master资格的主机列表。可用的分隔符为“ ”、“,”和“;”。如果未提供任何值，它将具有与 相同的值ELASTICSEARCH_CLUSTER_HOSTS。
• ELASTICSEARCH_IS_DEDICATED_NODE：Elasticsearch 节点充当“专用节点”。默认值：false
• ELASTICSEARCH_NODE_TYPE：充当“专用节点”时的 Elasticsearch 节点类型。有效值：master、data、coordinating或ingest。
• ELASTICSEARCH_NODE_NAME：Elasticsearch 节点名称。没有默认值。
• ELASTICSEARCH_BIND_ADDRESS：Elasticsearch 绑定的地址/接口。默认值：0.0.0.0
• ELASTICSEARCH_PORT_NUMBER：Elasticsearch 端口。默认值：9200
• ELASTICSEARCH_NODE_PORT_NUMBER：Elasticsearch 节点到节点端口。默认值：9300
• ELASTICSEARCH_PLUGINS：逗号、分号或空格分隔的初始化时安装的插件列表。没有默认值。
• ELASTICSEARCH_KEYS：要存储的以逗号、分号或空格分隔的键值对 (key=value) 列表。没有默认值。
• ELASTICSEARCH_HEAP_SIZE：用于 Xmx 和 Xms java 堆值的内存。默认值：1024m
• ELASTICSEARCH_FS_SNAPSHOT_REPO_PATH：Elasticsearch 文件系统快照存储库路径。没有默认值。
• ELASTICSEARCH_DATA_DIR_LIST：逗号、分号或空格分隔的用于数据存储的目录列表。没有默认值。

设置集群

可以使用以下环境变量设置集群：

• ELASTICSEARCH_CLUSTER_NAME：Elasticsearch 集群名称。默认值：elasticsearch-cluster
• ELASTICSEARCH_CLUSTER_HOSTS：用于设置集群的elasticsearch主机列表。可用的分隔符为' ', ',' and ';'. No defaults.
• ELASTICSEARCH_CLIENT_NODE：Elasticsearch 节点充当 Kibana 应用程序的“智能路由器”。默认值：false
• ELASTICSEARCH_NODE_NAME：Elasticsearch 节点名称。没有默认值。
• ELASTICSEARCH_MINIMUM_MASTER_NODES：法定人数的最小 Elasticsearch 主节点。没有默认值。 对于较大的集群，您可以使用以下环境变量设置dedicated nodes：
• ELASTICSEARCH_IS_DEDICATED_NODE：Elasticsearch 节点充当dedicated nodes。默认值： no
• ELASTICSEARCH_NODE_TYPE：充当dedicated nodes时的 Elasticsearch 节点类型。有效值：master, data, coordinating or ingest。
• ELASTICSEARCH_CLUSTER_MASTER_HOSTS：符合elasticsearch master资格的主机列表。可用的分隔符为' ', ',' , ';'。如果未提供任何值，它将具有与ELASTICSEARCH_CLUSTER_HOSTS相同的值。

第 1 步：创建新网络

docker network create elasticsearch_network

步骤2：创建第一个节点

docker run --name elasticsearch-node1 \
  --net=elasticsearch_network \
  -p 9200:9200 \
  -e ELASTICSEARCH_CLUSTER_NAME=elasticsearch-cluster \
  -e ELASTICSEARCH_CLUSTER_HOSTS=elasticsearch-node1,elasticsearch-node2 \
  -e ELASTICSEARCH_NODE_NAME=elastic-node1 \
  registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest

在上面的命令中，容器被添加到elasticsearch-cluster使用ELASTICSEARCH_CLUSTER_NAME. 该ELASTICSEARCH_CLUSTER_HOSTS参数设置设置集群的节点的名称，因此我们需要为第二个节点启动其他容器。最后，该ELASTICSEARCH_NODE_NAME参数允许指定节点的已知名称，否则elasticsearch将生成一个随机名称。

步骤 3：创建第二个节点

docker run --name elasticsearch-node2 \
  --link elasticsearch-node1:elasticsearch-node1 \
  --net=elasticsearch_network \
  -e ELASTICSEARCH_CLUSTER_NAME=elasticsearch-cluster \
  -e ELASTICSEARCH_CLUSTER_HOSTS=elasticsearch-node1,elasticsearch-node2 \
  -e ELASTICSEARCH_NODE_NAME=elastic-node2 \
  registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest

在上面的命令中，一个新的elasticsearch节点被添加到由ELASTICSEARCH_CLUSTER_NAME指示的elasticsearch集群中。

您现在已经启动并运行了一个两节点 Elasticsearch 集群，可以通过添加/删除节点来扩展该集群。

通过 Docker Compose，可以使用以下命令设置集群配置：

version: '2'
services:
  elasticsearch-node1:
    image: registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest
    environment:
      - ELASTICSEARCH_CLUSTER_NAME=elasticsearch-cluster
      - ELASTICSEARCH_CLUSTER_HOSTS=elasticsearch-node1,elasticsearch-node2
      - ELASTICSEARCH_NODE_NAME=elastic-node1

  elasticsearch-node2:
    image: registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest
    environment:
      - ELASTICSEARCH_CLUSTER_NAME=elasticsearch-cluster
      - ELASTICSEARCH_CLUSTER_HOSTS=elasticsearch-node1,elasticsearch-node2
      - ELASTICSEARCH_NODE_NAME=elastic-node2

配置文件

为了使用自定义配置文件而不是开箱即用的默认配置文件，您可以创建一个名为的文件elasticsearch.yml并将其挂载于/opt/bitnami/elasticsearch/config/elasticsearch.yml以覆盖默认配置：

docker run -d --name elasticsearch \
    -p 9201:9201 \
    -v /path/to/elasticsearch.yml:/opt/bitnami/elasticsearch/config/elasticsearch.yml \
    -v /path/to/elasticsearch-data-persistence:/bitnami/elasticsearch/data \
    registry.cn-hangzhou.aliyuncs.com/qingcloudtech/elasticsearch:latest

或者通过更改docker-compose.yml文件：

elasticsearch:
  ...
  volumes:
    - /path/to/elasticsearch.yml:/opt/bitnami/elasticsearch/config/elasticsearch.yml
    - /path/to/elasticsearch-data-persistence:/bitnami/elasticsearch/data
  ...

请注意，整个配置文件将被提供的默认配置文件替换；确保您提供的语法和字段设置正确且详尽。

如果您宁愿扩展而不是用您的设置替换默认配置，请挂载自定义配置文件到容器/opt/bitnami/elasticsearch/config/my_elasticsearch.yml。

初始化一个新实例

当容器第一次执行时，它会执行/docker-entrypoint-initdb.d目录下扩展名为.sh的文件.

为了将自定义文件放入 Docker 容器中，您可以将它们挂载为卷。

日志

docker logs elasticsearch

或使用 Docker Compose：

docker-compose logs elasticsearch

如果您希望以不同方式使用容器日志，您可以使用该选项配置容器日志记录驱动程序。--log-driver在默认配置中，docker 使用json-file驱动程序。

此外，如果您想修改 Elasticsearch 日志记录配置，可以通过覆盖该文件来完成/opt/bitnami/elasticsearch/config/log4j2.properties。该文件的语法可以在 Elasticsearch日志记录文档中找到。