Elasticsearch 通知设置

本文档介绍如何配置 Elasticsearch 服务作为 存储桶通知 的目标。 有关如何使用这些设置的教程，请参阅 将事件发布到 Elasticsearch。

你可以通过以下方式建立或修改设置：

• 在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。 如何定义环境变量，请参考所用操作系统的文档。
• 使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

有些设置只有环境变量或配置项中的一种，而不是两者同时存在。

多个 Elasticsearch 目标

可通过为每组相关设置追加唯一标识符 _ID 来指定多个 Elasticsearch 服务端点。 例如，以下命令分别将两个不同的 Elasticsearch 服务端点设置为 PRIMARY 和 SECONDARY：

示例

• 环境变量
• 配置设置

export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_PRIMARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_PRIMARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_PRIMARY="namespace"

export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_SECONDARY="https://user:[email protected]:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_SECONDARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_SECONDARY="namespace"

mc admin config set notify_elasticsearch:primary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_elasticsearch:secondary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

设置

启用

必需

• 环境变量
• 配置项

mc admin config set notify_elasticsearch \
  url="https://user:[email protected]:9200" \
  [ARGUMENT="VALUE"] ... \

URL

必需

• 环境变量
• 配置项

指定 MinIO 将存储桶事件发布到的 Elasticsearch 服务端点。 例如：https://elasticsearch.example.com:9200。

MinIO 支持通过 URL 参数传递认证信息，格式为 PROTOCOL://USERNAME:PASSWORD@HOSTNAME:PORT。

Index

必需

• 环境变量
• 配置项

指定用于存储或更新 MinIO 存储桶事件的 Elasticsearch index 名称。 如果 index 不存在，Elasticsearch 会自动创建。

Format

必需

• 环境变量
• 配置项

指定写入 Elasticsearch index 的事件数据格式。 MinIO 支持以下取值：

namespace

对于每个存储桶事件，MinIO 会创建一个 JSON 文档，以事件中的存储桶名和对象名作为文档 ID，并将实际事件作为文档正文的一部分。 对该对象的后续更新会修改该对象在 index 中的现有条目。 同样，删除该对象也会删除对应的 index 条目。

access

对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并以 Elasticsearch 生成的随机 ID 将其追加到 index。 对对象的后续更新会产生新的 index 条目，而现有条目保持不变。

Username

可选

• 环境变量
• 配置项

用于连接启用了认证的 Elasticsearch 服务端点的用户名。

Password

可选

• 环境变量
• 配置项

用于连接启用了认证的 Elasticsearch 服务端点的密码。

队列目录

可选

• 环境变量
• 配置项

指定目录路径以启用 MinIO 针对未投递消息的持久化事件存储，例如 /opt/minio/events。

当 Elasticsearch 服务离线时，MinIO 会将未投递事件存储在指定存储中，并在连接恢复后重放这些已存储事件。

队列上限

可选

• 环境变量
• 配置项

指定未投递消息的最大上限。 默认为 100000。

注释

可选

• 环境变量
• 配置项

指定与 Elasticsearch 配置关联的注释。