文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

AMQP 通知设置

此页面记录了将 AMQP 服务配置为目标的设置存储桶通知.发布事件到 AMQP (RabbitMQ)有关使用这些设置的教程。

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

  • an 环境变量在启动或重启 MinIO 服务器之前,请在主机系统上设置此环境变量。 有关如何定义环境变量,请参阅操作系统的文档。

  • a 配置设置使用mc admin config set.

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

某些设置只有环境变量或配置设置,但没有两者都提供。

重要

每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前,先在较低环境(如开发环境或测试环境)中测试配置变更。

多个 AMQP 目标

您可以通过附加唯一标识符来指定多个 AMQP 服务端点_ID将每组相关的 AMQP 设置映射到顶级键。

示例

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

export MINIO_NOTIFY_AMQP_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_AMQP_URL_PRIMARY="amqp://user:password@amqp-endpoint.example.net:5672"

export MINIO_NOTIFY_AMQP_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_AMQP_URL_SECONDARY="amqp://user:password@amqp-endpoint.example.net:5672"

例如,MINIO_NOTIFY_AMQP_ENABLE_PRIMARY表示该环境变量与ID为的AMQP服务端点相关联PRIMARY.

mc admin config set notify_amqp:primary \
   url="user:password@amqp://amqp-endpoint.example.net:5672" [ARGUMENT=VALUE ...]

mc admin config set notify_amqp:secondary \
   url="user:password@amqp://amqp-endpoint.example.net:5672" [ARGUMENT=VALUE ...]

请注意,对于配置设置,唯一标识符会附加到amqp仅对整体,不对每个单独的参数。

设置

启用

MINIO_NOTIFY_AMQP_ENABLE

需要指定MINIO_NOTIFY_AMQP_URL如果设置为on.

指定on以启用将存储桶通知发布到 AMQP 端点的功能。

默认值为off.

notify_amqp

用于定义 AMQP 服务端点的顶级配置键MinIO 存储桶通知.

使用mc admin config set设置或更新 AMQP 服务端点。url参数是必需for each target. 指定额外的可选参数作为空格(" ")-分隔的列表。

mc admin config set notify_amqp \
  url="amqp://user:password@endpoint:port" \
  [ARGUMENT="VALUE"] ...

URL

必需

MINIO_NOTIFY_AMQP_URL
notify_amqp url

指定 MinIO 发布存储桶事件的目标 AMQP 服务器端点。 例如,amqp://myuser:mypassword@localhost:5672.

Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态(是否可解析和可达)。 即使现有通知目标处于离线状态,MinIO 也不再阻止添加新的通知目标。

交换

可选

MINIO_NOTIFY_AMQP_EXCHANGE
notify_amqp 交换

指定要使用的 AMQP 交换器名称。

Exchange Type

可选

MINIO_NOTIFY_AMQP_EXCHANGE_TYPE
notify_amqp exchange_type

指定 AMQP 交换机的类型。

路由键

可选

MINIO_NOTIFY_AMQP_ROUTING_KEY
notify_amqp routing_key

指定用于发布事件的路由键。

强制性

可选

MINIO_NOTIFY_AMQP_MANDATORY
notify_amqp 强制性的

指定off忽略未送达消息错误。 默认为on.

耐用

可选

MINIO_NOTIFY_AMQP_DURABLE
notify_amqp 耐用的

指定on在代理重启时保持消息队列持久化。 默认值为off.

无需等待

可选

MINIO_NOTIFY_AMQP_NO_WAIT
notify_amqp no_wait

指定on启用非阻塞消息传递。 默认为off.

Internal

可选

MINIO_NOTIFY_AMQP_INTERNAL
notify_amqp 内部

指定on仅当该交换器绑定到其他交换器时才使用它。 请参阅 RabbitMQ 文档中关于Exchange 到 Exchange 绑定有关 AMQP 交换绑定的更多信息。

自动删除

可选

MINIO_NOTIFY_AMQP_AUTO_DELETED
notify_amqp auto_deleted

指定on如果没有消费者,则自动删除消息队列。 默认为off.

交付模式

可选

MINIO_NOTIFY_AMQP_DELIVERY_MODE
notify_amqp 投递模式

指定1将传递模式设置为非持久队列。

指定2将传递模式设置为持久队列。

队列目录

可选

MINIO_NOTIFY_AMQP_QUEUE_DIR
notify_amqp queue_dir

指定目录路径以启用 MinIO 的持久化事件存储,用于存放未送达的消息,例如/opt/minio/events.

当 AMQP 服务离线时,MinIO 会将未送达的事件存储在指定存储区中,并在连接恢复时重放已存储的事件。

队列限制

可选

MINIO_NOTIFY_AMQP_QUEUE_LIMIT
notify_amqp queue_limit

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

评论

可选

MINIO_NOTIFY_AMQP_COMMENT
notify_amqp 评论

为 AMQP 配置指定注释。