存储桶通知
MinIO 存储桶通知允许管理员在某些对象或存储桶事件上向支持的外部服务发送通知。MinIO 支持类似于 Amazon S3 事件通知 的存储桶和对象级 S3 事件。
支持的通知目标
MinIO 支持将事件通知发布到以下目标
目标 |
描述 |
---|---|
AMQP (RabbitMQ) |
将通知发布到 AMQP 服务,例如 RabbitMQ。 有关教程,请参阅 将事件发布到 AMQP (RabbitMQ)。 |
MQTT |
将通知发布到 MQTT 服务。 有关教程,请参阅 将事件发布到 MQTT。 |
NATS |
将通知发布到 NATS 服务。 有关教程,请参阅 将事件发布到 NATS。 |
NSQ |
将通知发布到 NSQ 服务。 有关教程,请参阅 将事件发布到 NSQ |
Elasticsearch |
将通知发布到 Elasticsearch 服务。 有关教程,请参阅 将事件发布到 Elasticsearch。 |
Kafka |
将通知发布到 Kafka 服务。 有关教程,请参阅 将事件发布到 Kafka。 |
MySQL |
将通知发布到 MySQL 服务。 有关教程,请参阅 将事件发布到 MySQL。 |
PostgreSQL |
将通知发布到 PostgreSQL 服务。 有关教程,请参阅 将事件发布到 PostgreSQL。 |
Redis |
将通知发布到 Redis 服务。 有关教程,请参阅 将事件发布到 Redis。 |
Webhook |
将通知发布到 Webhook 服务。 有关教程,请参阅 将事件发布到 Webhook。 |
异步与同步存储桶通知
版本 RELEASE.2023-06-23T20-26-00Z 中的新增功能: MinIO 支持所有远程目标的异步(默认)或同步存储桶通知。
使用异步传递时,MinIO 会在配置的远程目标触发事件,并且**不会**等待响应,然后继续执行下一个事件。异步桶通知优先发送事件,如果远程目标在传输或处理过程中出现瞬时问题,则存在一些事件丢失的风险。
使用同步传递时,MinIO 会在配置的远程目标触发事件,然后等待远程目标确认成功接收,然后再继续执行下一个事件。同步桶通知优先确保事件的传递,但存在事件发送速度变慢和队列填满的风险。
要为**所有已配置的远程目标**启用同步桶通知,请使用以下任一设置
将
MINIO_API_SYNC_EVENTS
环境变量设置为on
,然后重新启动 MinIO 部署。将
api.sync_events
配置设置为on
,然后重新启动 MinIO 部署。
注意
对于同步和异步事件,MinIO 会维护一个每个远程目标的队列,用于存储未发送和挂起的事件。队列限制默认为 100000
。
当队列已满时,MinIO 会丢弃新的事件。
您可以根据需要增加队列大小,以更好地适应 MinIO 部署和远程目标的事件发送和处理速度。使用您的通知方法的 QUEUE_LIMIT
环境变量或配置设置来修改此限制。
对于异步事件,MinIO 允许最多 50000
个并发 send
调用。
支持的 S3 事件类型
MinIO 桶通知与 Amazon S3 事件通知 兼容。本节列出了所有支持的事件。
对象事件
MinIO 支持在以下 S3 对象事件上触发通知
指定通配符 *
字符以选择与前缀相关的所有事件
复制事件
MinIO 支持在以下 S3 复制事件上触发通知
指定通配符 *
字符以选择所有 s3:Replication
事件
ILM 过渡事件
MinIO 支持在以下 S3 ILM 过渡事件上触发通知
指定通配符 *
字符以选择与前缀相关的所有事件
扫描器事件
MinIO 支持在以下 S3 扫描器 过渡事件上触发通知
- s3:Scanner:ManyVersions
扫描器 找到具有 1000 多个版本的多个对象。
- s3:Scanner:BigPrefix
扫描器 找到具有 50000 多个子文件夹的前缀。
全局事件
MinIO 支持在以下全局事件上触发通知。您只能通过 ListenNotification API 监听这些事件