文档

NSQ 通知设置

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

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

  • 在启动或重启 MinIO Server 之前,在宿主机系统上定义 环境变量。 如何定义环境变量,请参考所用操作系统的文档。

  • 使用 mc admin config set 定义 配置项

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

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

Important

每个配置项都会控制 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"] ... \

设置

启用

必填

MINIO_NOTIFY_NSQ_ENABLE

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

notify_nsq

用于定义 NSQ server/broker 端点的顶层配置键,供 MinIO 存储桶通知 使用。

使用 mc admin config set 设置或更新 NSQ server/broker 端点。 每个端点都*必须*包含以下参数:

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

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

NSQ Daemon 服务器地址

必填

MINIO_NOTIFY_NSQ_NSQD_ADDRESS
notify_nsq nsqd_address

指定 NSQ Daemon 运行所在的 NSQ 服务器地址。 例如:

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

Changed in version RELEASE.2023-05-27T05-56-19Z: 在添加目标之前,如果指定的 URL 可解析且可达, MinIO 会先检查其健康状态。 如果现有目标处于离线状态,MinIO 也不再阻止添加新的通知目标。

主题

必填

MINIO_NOTIFY_NSQ_TOPIC
notify_nsq topic

指定 MinIO 向 broker 发布事件时使用的 NSQ topic 名称。

TLS

可选

MINIO_NOTIFY_NSQ_TLS
notify_nsq tls

指定 on 以启用到 NSQ service broker 的 TLS 连接。

TLS 跳过校验

可选

MINIO_NOTIFY_NSQ_TLS_SKIP_VERIFY
notify_nsq tls_skip_verify

启用或禁用对 NSQ service broker TLS 证书的 TLS 校验。

  • 指定 on 可禁用 TLS 校验(默认)。

  • 指定 off 可启用 TLS 校验。

队列目录

可选

MINIO_NOTIFY_NSQ_QUEUE_DIR
notify_nsq queue_dir

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

当 NSQ server/broker 离线时,MinIO 会将未投递事件存储在指定存储中,并在连接恢复后重放这些已存储事件。

队列上限

可选

MINIO_NOTIFY_NSQ_QUEUE_LIMIT
notify_nsq queue_limit

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

备注

可选

MINIO_NOTIFY_NSQ_COMMENT
notify_nsq comment

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