NATS通知设置
本页面记录了配置NATS服务作为 Bucket Notifications 目标的设置。 请参阅 将事件发布至NATS,了解如何使用这些设置的教程。
您可以通过定义以下内容来建立或修改设置:
在启动或重新启动 MinIO 服务器之前,在宿主系统上定义一个 环境变量。 请参阅您的操作系统的文档,了解如何定义环境变量。
使用
mc admin config set
命令来设置一个 配置项。使用 MinIO控制台 的 管理员 > 设置 页面来设置一个 配置项。
如果您同时定义了环境变量和类似的配置设置,MinIO 将使用环境变量的值。
有些设置只有环境变量或配置设置,而不是两者都有。
重要
每个配置设置都控制着MinIO的基本行为和功能。 MinIO 强烈建议 在较低的环境中,如DEV或QA,测试配置更改,然后再将其应用到生产环境中。
多个 NATS 目标
您可以通过在顶级键后附加每个相关NATS设置集的唯一标识符 _ID
来指定多个NATS服务端点。
例子
例如, 以下命令分别将两个不同的NATS服务端点设置为 PRIMARY
和 SECONDARY
:
export MINIO_NOTIFY_NATS_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_NATS_ADDRESS_PRIMARY="nats-endpoint.example.net:4222"
export MINIO_NOTIFY_NATS_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_NATS_ADDRESS_SECONDARY="nats-endpoint.example.net:4222"
在这些设置中,MINIO_NOTIFY_NATS_ENABLE_PRIMARY
环境变量表示与ID为 PRIMARY
的NATS服务端点相关联。
mc admin config set notify_nats:primary \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT=VALUE ...]
mc admin config set notify_nats:secondary \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT=VALUE ...]
设置
Enable
必需的
用于定义与 MinIO存储桶通知 一起使用的NATS服务端点的顶级配置键。
使用 :mc-cmd: mc admin config set 来设置或更新一个NATS服务端点。
对于每个目标,address
和 subject
参数是 必须 的。
将其他可选参数指定为空格 ( " "
) 分隔的列表。
mc admin config set notify_nats \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT="VALUE"] ... \
地址
必需的
指定MinIO发布存储桶事件的NATS服务端点。
例如, nats-endpoint.example.com:4222
。
在 RELEASE.2023-05-27T05-56-19Z 版本发生变更: 在添加目标之前,MinIO会检查指定URL的健康状况(如果其能被解析并可以访问)。 如果现有目标离线,MinIO不再阻止添加新的通知目标。
Subject
必需的
指定MinIO将事件关联到的NATS端点的订阅。
Username
可选
指定连接到NATS服务端点时的用户名。
Password
可选
指定连接到NATS服务端点时使用的通行证。
在 RELEASE.2023-06-23T20-26-00Z 版本发生变更: 当作为 mc admin config get
命令的一部分返回时,MinIO 会删除这个值。
Token
可选
指定连接到NATS服务端点时使用的令牌。
在 RELEASE.2023-06-23T20-26-00Z 版本发生变更: 当作为 mc admin config get
命令的一部分返回时,MinIO 会删除这个值。
用户凭据文件
可选
指定用于连接到NATS服务端点的 用户凭据文件<https://docs.nats.io/using-nats/developer/connecting/creds>。
TLS
可选
将 on
指定为启用到NATS服务端点的TLS连接。
TLS 跳过验证
可选
启用或禁用对NATS服务端点TLS证书的TLS验证。
指定
on
以禁用TLS验证(默认值)。指定
off
以启用 TLS 验证。
Ping Interval
可选
指定客户端向NATS服务器发送ping操作的持续时间间隔。 MinIO支持以下时间单位:
s
- seconds,60s
m
- minutes,5m
h
- hours,1h
d
- days,1d
Jetstream
可选
指定 on
以启用对流事件到NATS JetStream服务端点的支持。
Streaming
已弃用
可选
指定 on
以启用将事件异步发布到 NATS 服务端点。
异步流式传输
已弃用
可选
指定 on
以启用将事件异步发布到 NATS 服务端点。
Max ACK Responses In Flight
已弃用
可选
指定在没有从NATS服务端点等待ACK响应的情况下发布的消息数量。
流媒体集群ID
已弃用
可选
指定NATS流式集群的唯一ID。
证书颁发机构
可选
指定用于签署NATS服务端点TLS证书的证书颁发机构(Certificate Authority,CA)链的路径。
客户证书
可选
指定用于对NATS服务端点执行基于客户端证书的mTLS(多层传输层安全性)认证的客户端证书路径。
客户端密钥
可选
指定用于对NATS服务端点执行基于客户端私钥的mTLS(多层传输层安全性)认证的客户端私钥路径。
队列目录
可选
指定目录路径以启用MinIO的持久化事件存储,例如 /opt/minio/events
。
MinIO在NATS服务器/代理离线时,将在指定的存储中存储未交付的事件,并在连接恢复时重新播放存储的事件。
队列限制
可选
指定未发送消息的最大限制。
默认为 100000
。
Comment
可选
为NATS配置指定一个注释以与之关联。