Redis 通知设置
本页记录了将 Redis 服务配置为目标的设置存储桶通知.发布事件到 Redis有关使用这些设置的教程。
您可以通过定义以下内容来建立或修改设置：
an 环境变量在启动或重启 MinIO 服务器之前，请在主机系统上设置此环境变量。 有关如何定义环境变量，请参阅操作系统的文档。
a 配置设置使用
mc admin config set.
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
某些设置只有环境变量或配置设置，但没有两者都提供。
重要
每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前，先在较低环境（如开发环境或测试环境）中测试配置变更。
多个 Redis 目标
您可以通过附加唯一标识符来指定多个 Redis 服务端点_ID到每个相关 Redis 设置集合的顶级键的末尾。
例如，以下命令设置了两个不同的 Redis 服务端点作为PRIMARY和SECONDARY分别：
export MINIO_NOTIFY_REDIS_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_REDIS_ADDRESS_PRIMARY="redis-endpoint.example.net:9200"
export MINIO_NOTIFY_REDIS_KEY_PRIMARY="bucketevents"
export MINIO_NOTIFY_REDIS_FORMAT_PRIMARY="namespace"
export MINIO_NOTIFY_REDIS_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_REDIS_REDIS_ADDRESS_SECONDARY="redis-endpoint2.example.net:9200"
export MINIO_NOTIFY_REDIS_KEY_SECONDARY="bucketevents"
export MINIO_NOTIFY_REDIS_FORMAT_SECONDARY="namespace"
mc admin config set notify_redis:primary \
address="redis-endpoint.example.net:9200" \
key="bucketevents" \
format="namespace" \
[ARGUMENT="VALUE"] ... \
mc admin config set notify_redis:secondary \
address="redis-endpoint2.example.net:9200" \
key="bucketevents" \
format="namespace" \
[ARGUMENT="VALUE"] ...
设置
启用
必需
指定on以启用将存储桶通知发布到 Redis 服务端点。
默认值为off.
如果设置为，需要指定以下额外的环境变量on:
用于定义 Redis 服务器/代理端点的顶级配置键MinIO 存储桶通知.
使用mc admin config set要设置或更新 Redis 服务器/代理端点。
以下参数是必需对于每个端点：
将其他可选参数指定为空格分隔的" ")-分隔的列表。
mc admin config set notify_redis \
address="ENDPOINT" \
key="<string>" \
format="<string>" \
[ARGUMENT="VALUE"] ... \
地址
必需
指定 MinIO 发布存储桶事件的目标 Redis 服务端点。
例如：redis.example.com:6369.
Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态（是否可解析和可达）。 即使现有通知目标处于离线状态，MinIO 也不再阻止添加新的通知目标。
Key
必需
指定用于存储和更新事件的 Redis 键。 如果该键不存在，Redis 将自动创建。
格式
必需
指定写入 Redis 服务端点的事件数据格式。 MinIO 支持以下值：
namespace对于每个存储桶事件，MinIO 会创建一个 JSON 文档，将事件中的存储桶和对象名称作为文档 ID，并将实际事件作为文档正文的一部分。 对该对象的后续更新会修改该对象的现有索引条目。 同样地，删除对象也会删除相应的索引条目。
access对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并使用 Redis 生成的随机 ID 将其附加到键中。 对对象的额外更新将生成新的索引条目，现有条目保持不变。
密码
可选
指定 Redis 服务器的密码。
在版本 RELEASE.2023-06-23T20-26-00Z 中的变更：MinIO 在作为部分结果返回时会遮蔽此值mc admin config get.
用户
可选
版本 RELEASE.2024-03-21T23-13-43Z 中的新增功能。
指定 Redis 服务器的用户。
队列目录
可选
指定目录路径以启用 MinIO 的持久化事件存储，用于存放未送达的消息，例如/opt/minio/events.
MinIO 在 Redis 服务器/代理离线期间将未送达的事件存储在指定存储中，并在连接恢复时重放已存储的事件。
队列限制
可选
指定未送达消息的最大限制。
默认值为100000.
评论
可选
指定要与 Redis 配置关联的注释。
