【优选教程】使用 Docker 安装 Elasticsearch

要删除容器及其网络，请运行

# Remove the Elastic network
docker network rm elastic

# Remove Elasticsearch containers
docker rm es01
docker rm es02

# Remove the Kibana container
docker rm kib01

您现在已经设置好了一个测试 Elasticsearch 环境。在您开始使用 Elasticsearch 进行认真的开发或投入生产之前，请查看在生产环境中在 Docker 中运行 Elasticsearch 时要应用的要求和建议。

要停止集群，请运行 docker-compose down。Docker 卷中的数据将被保留，并在您使用 docker-compose up 重新启动集群时加载。

docker-compose down

要在您停止集群时删除网络、容器和卷，请指定 -v 选项

docker-compose down -v

您现在已经设置好了一个测试 Elasticsearch 环境。在您开始使用 Elasticsearch 进行认真的开发或投入生产之前，请查看在生产环境中在 Docker 中运行 Elasticsearch 时要应用的要求和建议。

对于生产用途，vm.max_map_count 内核设置必须设置为至少 262144。

如何设置 vm.max_map_count 取决于您的平台。

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

sysctl -w vm.max_map_count=262144

docker-machine ssh
sudo sysctl -w vm.max_map_count=262144

wsl -d docker-desktop -u root
sysctl -w vm.max_map_count=262144

[wsl2]
kernelCommandLine = "sysctl.vm.max_map_count=262144"

wsl -d docker-desktop -u root
vi /etc/sysctl.conf

vm.max_map_count = 262144

默认情况下，Elasticsearch 在容器内以用户 elasticsearch 的身份运行，使用 uid:gid 1000:0。

如果您要绑定挂载本地目录或文件，则它必须可由 elasticsearch 用户读取。此外，此用户必须具有对配置、数据和日志目录的写入权限（Elasticsearch 需要对 config 目录的写入权限，以便它可以生成密钥库）。一个好的策略是为本地目录授予对 gid 0 的组访问权限。

例如，要准备一个本地目录以通过绑定挂载来存储数据

mkdir esdatadir
chmod g+rwx esdatadir
chgrp 0 esdatadir

您还可以使用自定义的 UID 和 GID 运行 Elasticsearch 容器。您必须确保文件权限不会阻止 Elasticsearch 执行。您可以使用以下两种选项之一：

Elasticsearch 容器必须具有增加的 nofile 和 nproc 的 ulimit。请验证 Docker 守护程序的 初始化系统是否将其设置为可接受的值。

要检查 Docker 守护程序 ulimit 的默认值，请运行：

docker run --rm docker.elastic.co/elasticsearch/elasticsearch:8.17.0 /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'

如果需要，可以在守护程序中调整它们，或者为每个容器覆盖它们。例如，当使用 docker run 时，设置：

--ulimit nofile=65535:65535

出于性能和节点稳定性的考虑，需要禁用交换。有关禁用交换的方法的信息，请参阅禁用交换。

如果您选择 bootstrap.memory_lock: true 方法，则还需要在 Docker 守护程序中定义 memlock: true ulimit，或者如示例 compose 文件所示，为容器显式设置。 当使用 docker run 时，您可以指定：

-e "bootstrap.memory_lock=true" --ulimit memlock=-1:-1

该镜像公开了 TCP 端口 9200 和 9300。对于生产集群，建议使用 --publish-all 随机化发布的端口，除非您为每个主机固定一个容器。

默认情况下，Elasticsearch 会根据节点的角色和节点容器可用的总内存自动调整 JVM 堆的大小。 我们建议大多数生产环境使用此默认大小。 如果需要，您可以通过手动设置 JVM 堆大小来覆盖默认大小。

要在生产环境中手动设置堆大小，请在 /usr/share/elasticsearch/config/jvm.options.d 下绑定挂载一个 JVM 选项文件，其中包括您所需的堆大小设置。

对于测试，您还可以使用 ES_JAVA_OPTS 环境变量手动设置堆大小。例如，要使用 1GB，请使用以下命令。

docker run -e ES_JAVA_OPTS="-Xms1g -Xmx1g" -e ENROLLMENT_TOKEN="<token>" --name es01 -p 9200:9200 --net elastic -it docker.elastic.co/elasticsearch/elasticsearch:8.17.0

ES_JAVA_OPTS 变量会覆盖所有其他 JVM 选项。我们不建议在生产环境中使用 ES_JAVA_OPTS。

将您的部署固定到特定版本的 Elasticsearch Docker 镜像。例如 docker.elastic.co/elasticsearch/elasticsearch:8.17.0。

您应该将卷绑定到 /usr/share/elasticsearch/data，原因如下：

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

请考虑使用不同的 日志记录驱动程序来集中管理您的日志。另请注意，默认的 json-file 日志记录驱动程序并不适合在生产环境中使用。

创建自定义配置文件，并将其绑定挂载到 Docker 镜像中对应的文件上。例如，要使用 docker run 绑定挂载 custom_elasticsearch.yml，请指定：

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

如果您绑定挂载自定义的 elasticsearch.yml 文件，请确保其中包含 network.host: 0.0.0.0 设置。此设置可确保节点可用于 HTTP 和传输流量，前提是其端口已公开。Docker 镜像的内置 elasticsearch.yml 文件默认包含此设置。

默认情况下，Elasticsearch 将为安全设置自动生成密钥库文件。 此文件是混淆的，但未加密。

要使用密码加密您的安全设置并使其在容器外部持久保存，请使用 docker run 命令手动创建密钥库。 该命令必须：

例如：

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.17.0 \
bin/elasticsearch-keystore create -p

您还可以使用 docker run 命令在密钥库中添加或更新安全设置。系统会提示您输入设置值。如果密钥库已加密，系统还会提示您输入密钥库密码。

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.17.0 \
bin/elasticsearch-keystore \
add my.secure.setting \
my.other.secure.setting

如果您已创建密钥库并且不需要更新它，则可以直接绑定挂载 elasticsearch.keystore 文件。您可以使用 KEYSTORE_PASSWORD 环境变量在启动时向容器提供密钥库密码。例如，docker run 命令可能具有以下选项：

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

在某些环境中，准备包含您的配置的自定义镜像可能更有意义。为此，Dockerfile 可能像这样简单：

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

然后，您可以使用以下命令构建并运行该镜像：

docker build --tag=elasticsearch-custom .
docker run -ti -v /usr/share/elasticsearch/data elasticsearch-custom

某些插件需要额外的安全权限。您必须通过以下方式之一显式接受它们：

有关更多信息，请参阅插件管理。

以下是如何解决使用 Docker 运行 Elasticsearch 时出现的常见错误的方法。

Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: java.io.IOException: Is a directory: SimpleFSIndexInput(path="/usr/share/elasticsearch/config/elasticsearch.keystore") Likely root cause: java.io.IOException: Is a directory

与密钥库相关的 docker run 命令尝试直接绑定挂载一个不存在的 elasticsearch.keystore 文件。如果您使用 -v 或 --volume 标志来挂载一个不存在的文件，Docker 会创建一个同名的目录。

要解决此错误：

Exception in thread "main" java.nio.file.FileSystemException: /usr/share/elasticsearch/config/elasticsearch.keystore.tmp -> /usr/share/elasticsearch/config/elasticsearch.keystore: Device or resource busy

一个 docker run 命令尝试在直接绑定挂载 elasticsearch.keystore 文件的情况下更新密钥库。要更新密钥库，容器需要访问 config 目录中的其他文件，例如 keystore.tmp。

要解决此错误：