NATS 通知设置
此页面记录了将 NATS 服务配置为目标的设置存储桶通知.发布事件到 NATS有关使用这些设置的教程。
您可以通过定义以下内容来建立或修改设置：
an 环境变量在启动或重启 MinIO 服务器之前，请在主机系统上设置此环境变量。 有关如何定义环境变量，请参阅操作系统的文档。
a 配置设置使用
mc admin config set.
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
某些设置只有环境变量或配置设置，但没有两者都提供。
重要
每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前，先在较低环境（如开发环境或测试环境）中测试配置变更。
多个 NATS 目标
您可以通过附加唯一标识符来指定多个NATS服务端点_ID将每组相关的NATS设置映射到顶层键。
Example
例如，以下命令设置两个不同的 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为的NATS服务端点相关联PRIMARY.
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 ...]
设置
启用
必需
用于定义NATS服务端点的顶级配置键MinIO 存储桶通知.
使用mc admin config set设置或更新 NATS 服务端点。address和subject参数是必需for each target.
指定额外的可选参数作为空格（" ")-分隔的列表。
mc admin config set notify_nats \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT="VALUE"] ... \
地址
必需
指定 MinIO 发布存储桶事件的目标 NATS 服务端点。
例如，nats-endpoint.example.com:4222.
Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态（是否可解析和可达）。 即使现有通知目标处于离线状态，MinIO 也不再阻止添加新的通知目标。
主题
必需
指定 MinIO 将事件发布到 NATS 端点时关联的订阅。
用户名
可选
指定用于连接到 NATS 服务端点的用户名。
密码
可选
指定用于连接到 NATS 服务端点的通行证。
在版本 RELEASE.2023-06-23T20-26-00Z 中的变更：MinIO 在作为部分结果返回时会遮蔽此值mc admin config get.
Token
可选
指定用于连接到 NATS 服务端点的令牌。
在版本 RELEASE.2023-06-23T20-26-00Z 中的变更：MinIO 在作为部分结果返回时会遮蔽此值mc admin config get.
用户凭据文件
可选
指定到用户凭证文件 <https://docs.nats.io/using-nats/developer/connecting/creds>用于连接到 NATS 服务端点。
TLS
可选
指定on以启用与 NATS 服务端点的 TLS 连接。
TLS 跳过验证
可选
启用或禁用对 NATS 服务端点 TLS 证书的 TLS 验证。
指定
on禁用 TLS 验证（默认）。指定
off启用 TLS 验证。
Ping 间隔
可选
指定客户端向 NATS 服务器发送 ping 的持续时间间隔。 MinIO 支持以下时间单位：
s- 秒，"60s"m- 分钟，"5m"h- 小时，"1h"d- 天，"1d"
Jetstream
可选
指定on启用 JetStream 支持，以便将流事件发送到 NATS JetStream 服务端点。
流式传输
已弃用
可选
指定on以支持将事件异步发布到 NATS 服务端点。
流式异步
已弃用
可选
指定on以支持将事件异步发布到 NATS 服务端点。
最大在途ACK响应数
已弃用
可选
指定要发布的消息数量，无需等待来自 NATS 服务端点的 ACK 响应。
Streaming Cluster ID
已弃用
可选
指定 NATS 流集群的唯一 ID。
客户端证书
可选
指定用于对 NATS 服务端点执行 mTLS 身份验证的客户端证书路径。
客户端密钥
可选
指定客户端私钥的路径，用于对 NATS 服务端点执行 mTLS 身份验证。
队列目录
可选
指定目录路径以启用 MinIO 的持久化事件存储，用于存放未送达的消息，例如/opt/minio/events.
MinIO 在 NATS 服务器/代理离线时将未送达的事件存储在指定存储中，并在连接恢复时重放已存储的事件。
队列限制
可选
指定未送达消息的最大限制。
默认值为100000.
评论
可选
指定要与 NATS 配置关联的注释。
