存储桶通知
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
扫描器 查找具有超过 50,000 个子文件夹的前缀。
全局事件
MinIO 支持在以下全局事件上触发通知。您只能通过ListenNotification API 监听这些事件