中文文档

NSQ通知设置

本页面文档了配置NSQ服务作为 Bucket Notifications 目标的设置参考。 有关使用这些设置的教程,请参阅 将事件发布至NSQ

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

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

  • 使用 mc admin config set 命令来设置一个 配置项

  • 使用 MinIO控制台管理员 > 设置 页面来设置一个 配置项

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

有些设置只有环境变量或配置设置,而不是两者都有。

重要

每个配置设置都控制着MinIO的基本行为和功能。 MinIO 强烈建议 在较低的环境中,如DEV或QA,测试配置更改,然后再将其应用到生产环境中。

多个 NSQ 目标

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

export MINIO_NOTIFY_NSQ_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_PRIMARY="https://user:password@nsq-endpoint.example.net:9200"
export MINIO_NOTIFY_NSQ_TOPIC_PRIMARY="bucketevents"

export MINIO_NOTIFY_NSQ_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_NSQ_NSQD_ADDRESS_SECONDARY="https://user:password@nsq-endpoint.example.net:9200"
export 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"] ... \

设置

Enable

必需的

MINIO_NOTIFY_NSQ_ENABLE

on 指定为开启发布桶通知到NSQ端点的选项。

notify_nsq

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

使用 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不再阻止添加新的通知目标。

Topic

必需的

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

MinIO将在NSQ服务器/代理离线时,将未交付的事件存储在指定的存储中,并在连接恢复时重新播放存储的事件。

队列限制

可选

MINIO_NOTIFY_NSQ_QUEUE_LIMIT
notify_nsq queue_limit

指定未发送消息的最大限制。 默认为 100000

Comment

可选

MINIO_NOTIFY_NSQ_COMMENT
notify_nsq comment

指定一个注释以与NSQ配置相关联。

Join Slack 商业支持购买咨询