中文文档

NATS通知设置

NATS Streaming Deprecated

NATS流式传输已被弃用。 迁移到 JetStream 替代。

相关的MinIO配置选项和环境变量已被弃用。

本页面记录了配置NATS服务作为 Bucket Notifications 目标的设置。 请参阅 将事件发布至NATS,了解如何使用这些设置的教程。

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

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

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

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

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

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

重要

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

多个 NATS 目标

您可以通过在顶级键后附加每个相关NATS设置集的唯一标识符 _ID 来指定多个NATS服务端点。

例子

例如, 以下命令分别将两个不同的NATS服务端点设置为 PRIMARYSECONDARY

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_NOTIFY_NATS_ENABLE

on 指定为启用将存储桶通知发布到NATS服务端点。

默认为 off

notify_nats

用于定义与 MinIO存储桶通知 一起使用的NATS服务端点的顶级配置键。

使用 :mc-cmd: mc admin config set 来设置或更新一个NATS服务端点。 对于每个目标,addresssubject 参数是 必须 的。 将其他可选参数指定为空格 ( " " ) 分隔的列表。

mc admin config set notify_nats \
  address="nats-endpoint.example.com:4222" \
  subject="minioevents" \
  [ARGUMENT="VALUE"] ... \

地址

必需的

MINIO_NOTIFY_NATS_ADDRESS
notify_nats address

指定MinIO发布存储桶事件的NATS服务端点。 例如, nats-endpoint.example.com:4222

在 RELEASE.2023-05-27T05-56-19Z 版本发生变更: 在添加目标之前,MinIO会检查指定URL的健康状况(如果其能被解析并可以访问)。 如果现有目标离线,MinIO不再阻止添加新的通知目标。

Subject

必需的

MINIO_NOTIFY_NATS_SUBJECT
notify_nats subject

指定MinIO将事件关联到的NATS端点的订阅。

Username

可选

MINIO_NOTIFY_NATS_USERNAME
notify_nats username

指定连接到NATS服务端点时的用户名。

Password

可选

MINIO_NOTIFY_NATS_PASSWORD
notify_nats password

指定连接到NATS服务端点时使用的通行证。

在 RELEASE.2023-06-23T20-26-00Z 版本发生变更: 当作为 mc admin config get 命令的一部分返回时,MinIO 会删除这个值。

Token

可选

MINIO_NOTIFY_NATS_TOKEN
notify_nats token

指定连接到NATS服务端点时使用的令牌。

在 RELEASE.2023-06-23T20-26-00Z 版本发生变更: 当作为 mc admin config get 命令的一部分返回时,MinIO 会删除这个值。

用户凭据文件

可选

MINIO_NOTIFY_NATS_USER_CREDENTIALS
notify_nats user_credentials

指定用于连接到NATS服务端点的 用户凭据文件<https://docs.nats.io/using-nats/developer/connecting/creds>

TLS

可选

MINIO_NOTIFY_NATS_TLS
notify_nats tls

on 指定为启用到NATS服务端点的TLS连接。

TLS 跳过验证

可选

MINIO_NOTIFY_NATS_TLS_SKIP_VERIFY
notify_nats tls_skip_verify

启用或禁用对NATS服务端点TLS证书的TLS验证。

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

  • 指定 off 以启用 TLS 验证。

Ping Interval

可选

MINIO_NOTIFY_NATS_PING_INTERVAL
notify_nats ping_interval

指定客户端向NATS服务器发送ping操作的持续时间间隔。 MinIO支持以下时间单位:

  • s - seconds, 60s

  • m - minutes, 5m

  • h - hours, 1h

  • d - days, 1d

Jetstream

可选

MINIO_NOTIFY_NATS_JETSTREAM
notify_nats jetstream

指定 on 以启用对流事件到NATS JetStream服务端点的支持。

Streaming

已弃用

可选

MINIO_NOTIFY_NATS_STREAMING
notify_nats streaming

指定 on 以启用将事件异步发布到 NATS 服务端点。

异步流式传输

已弃用

可选

MINIO_NOTIFY_NATS_STREAMING_ASYNC
notify_nats streaming_async

指定 on 以启用将事件异步发布到 NATS 服务端点。

Max ACK Responses In Flight

已弃用

可选

MINIO_NOTIFY_NATS_STREAMING_MAX_PUB_ACKS_IN_FLIGHT
notify_nats streaming_max_pub_acks_in_flight

指定在没有从NATS服务端点等待ACK响应的情况下发布的消息数量。

流媒体集群ID

已弃用

可选

MINIO_NOTIFY_NATS_STREAMING_CLUSTER_ID
notify_nats streaming_cluster_id

指定NATS流式集群的唯一ID。

证书颁发机构

可选

MINIO_NOTIFY_NATS_CERT_AUTHORITY
notify_nats cert_authority

指定用于签署NATS服务端点TLS证书的证书颁发机构(Certificate Authority,CA)链的路径。

客户证书

可选

MINIO_NOTIFY_NATS_CLIENT_CERT
notify_nats client_cert

指定用于对NATS服务端点执行基于客户端证书的mTLS(多层传输层安全性)认证的客户端证书路径。

客户端密钥

可选

MINIO_NOTIFY_NATS_CLIENT_KEY
notify_nats client_key

指定用于对NATS服务端点执行基于客户端私钥的mTLS(多层传输层安全性)认证的客户端私钥路径。

队列目录

可选

MINIO_NOTIFY_NATS_QUEUE_DIR
notify_nats queue_dir

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

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

队列限制

可选

MINIO_NOTIFY_NATS_QUEUE_LIMIT
notify_nats queue_limit

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

Comment

可选

MINIO_NOTIFY_NATS_COMMENT
notify_nats comment

为NATS配置指定一个注释以与之关联。

Join Slack 商业支持购买咨询