文档

NSQ 通知设置

此页面记录了将 NSQ 服务配置为 存储桶通知 目标的设置。有关使用这些设置的教程,请参阅 将事件发布到 NSQ

您可以通过定义以下内容来建立或修改设置

  • 在启动或重新启动 MinIO 服务器之前,在主机系统上定义一个环境变量。有关如何定义环境变量,请参阅您的操作系统的文档。

  • 使用 mc admin config set 定义一个配置设置

  • 使用 MinIO 控制台的 管理员 > 设置 页面定义一个配置设置

如果您同时定义了环境变量和类似的配置设置,则 MinIO 将使用环境变量值。

某些设置仅具有环境变量或配置设置,而不是两者兼而有之。

重要

每个配置设置都控制着 MinIO 的基本行为和功能。MinIO **强烈建议**在将配置更改应用于生产环境之前,在较低的环境(如 DEV 或 QA)中进行测试。

多个 NSQ 目标

您可以通过将唯一的标识符 _ID 附加到每组相关 NSQ 设置的顶级密钥的末尾来指定多个 NSQ 服务端点。例如,以下命令将两个不同的 NSQ 服务端点分别设置为 PRIMARYSECONDARY

set MINIO_NOTIFY_NSQ_ENABLE_PRIMARY="on"
set MINIO_NOTIFY_NSQ_NSQD_ADDRESS_PRIMARY="https://user:[email protected]:9200"
set MINIO_NOTIFY_NSQ_TOPIC_PRIMARY="bucketevents"

set MINIO_NOTIFY_NSQ_ENABLE_SECONDARY="on"
set MINIO_NOTIFY_NSQ_NSQD_ADDRESS_SECONDARY="https://user:[email protected]:9200"
set MINIO_NOTIFY_NSQ_TOPIC_SECONDARY="bucketevents"
mc admin config set notify_nsq:primary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

mc admin config set notify_nsq:secondary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

设置

启用

必需

MINIO_NOTIFY_NSQ_ENABLE

指定 on 以启用将存储桶通知发布到 NSQ 端点。

notify_nsq

用于定义 NSQ 服务器/代理端点以与MinIO 桶通知一起使用的顶级配置键。

使用 mc admin config set 设置或更新 NSQ 服务器/代理端点。每个端点都需要以下参数

以空格 (" ") 分隔的列表形式指定其他可选参数。

mc admin config set notify_nsq                          \
   nsqd_address="https://nsq-endpoint.example.net:4150" \
   topic="<string>"                                     \
   [ARGUMENT="VALUE"] ...

NSQ 守护进程服务器地址

必需

MINIO_NOTIFY_NSQ_NSQD_ADDRESS
notify_nsq nsqd_address

指定 NSQ 守护进程运行的 NSQ 服务器地址。例如:

https://nsq-endpoint.example.net:4150

在版本 RELEASE.2023-05-27T05-56-19Z 中更改: 在添加目标之前,MinIO 会检查指定 URL 的健康状况(如果它可解析且可访问)。如果现有目标脱机,MinIO 现在不再阻止添加新的通知目标。

主题

必需

MINIO_NOTIFY_NSQ_TOPIC
notify_nsq topic

指定 MinIO 在将事件发布到代理时使用的 NSQ 主题名称。

TLS

可选

MINIO_NOTIFY_NSQ_TLS
notify_nsq tls

指定 on 以启用到 NSQ 服务代理的 TLS 连接。

跳过 TLS 验证

可选

MINIO_NOTIFY_NSQ_TLS_SKIP_VERIFY
notify_nsq tls_skip_verify

启用或禁用 NSQ 服务代理 TLS 证书的 TLS 验证。

  • 指定 on 以禁用 TLS 验证(默认值)。

  • 指定 off 以启用 TLS 验证。

队列目录

可选

MINIO_NOTIFY_NSQ_QUEUE_DIR
notify_nsq queue_dir

指定目录路径以启用 MinIO 的持久事件存储,用于未传递的消息,例如 /opt/minio/events

当 NSQ 服务器/代理脱机时,MinIO 将未传递的事件存储在指定的存储中,并在连接恢复时重播存储的事件。

队列限制

可选

MINIO_NOTIFY_NSQ_QUEUE_LIMIT
notify_nsq queue_limit

指定未传递消息的最大限制。默认为 100000

注释

可选

MINIO_NOTIFY_NSQ_COMMENT
notify_nsq comment

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