文档

AMQP 通知设置

本文档说明了将 AMQP 服务配置为 存储桶通知 目标的相关设置。 有关如何使用这些设置的教程,请参阅 将事件发布到 AMQP (RabbitMQ)

你可以通过以下方式建立或修改设置:

  • 在启动或重启 MinIO Server 之前,在宿主机系统上定义 环境变量。 如何定义环境变量,请参考所用操作系统的文档。

  • 使用 mc admin config set 定义 配置项

如果同时定义了环境变量和对应的配置项,MinIO 使用环境变量的值。

有些设置只有环境变量或配置项中的一种,而不是两者同时存在。

Important

每个配置项都会控制 MinIO 的基础行为和功能。 MinIO 强烈建议 先在 DEV 或 QA 等较低级别环境中测试配置变更,再应用到生产环境。

多个 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 为 PRIMARY 的 AMQP 服务端点。

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

如果设置为 on,则必须指定 MINIO_NOTIFY_AMQP_URL

指定 on 以启用向 AMQP 端点发布存储桶通知。

默认值为 off

notify_amqp

用于定义 AMQP 服务端点以供 MinIO 存储桶通知 使用的顶层配置键。

使用 mc admin config set 设置或更新 AMQP 服务端点。 对于每个目标,url 参数都是*必需*的。 以空白字符(" ")分隔的列表形式指定其他可选参数。

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: 在添加目标之前,如果指定的 URL 可解析且可达, MinIO 会先检查其健康状态。 如果现有目标处于离线状态,MinIO 也不再阻止添加新的通知目标。

Exchange(交换机)

可选

MINIO_NOTIFY_AMQP_EXCHANGE
notify_amqp exchange

指定要使用的 AMQP exchange 名称。

Exchange 类型

可选

MINIO_NOTIFY_AMQP_EXCHANGE_TYPE
notify_amqp exchange_type

指定 AMQP exchange 的类型。

路由键

可选

MINIO_NOTIFY_AMQP_ROUTING_KEY
notify_amqp routing_key

指定用于发布事件的 routing key。

Mandatory(强制)

可选

MINIO_NOTIFY_AMQP_MANDATORY
notify_amqp mandatory

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

持久化

可选

MINIO_NOTIFY_AMQP_DURABLE
notify_amqp durable

指定 on 以在 broker 重启后保留消息队列。 默认值为 off

No Wait(不等待)

可选

MINIO_NOTIFY_AMQP_NO_WAIT
notify_amqp no_wait

指定 on 以启用非阻塞消息投递。 默认值为 off

Internal(内部)

可选

MINIO_NOTIFY_AMQP_INTERNAL
notify_amqp internal

指定 on 以仅在 exchange 绑定到其他 exchanges 时使用该 exchange。 有关 AMQP exchange 绑定的更多信息,请参阅 RabbitMQ 文档中的 Exchange to Exchange Bindings

自动删除

可选

MINIO_NOTIFY_AMQP_AUTO_DELETED
notify_amqp auto_deleted

指定 on 以在没有消费者时自动删除消息队列。 默认值为 off

投递模式

可选

MINIO_NOTIFY_AMQP_DELIVERY_MODE
notify_amqp delivery_mode

指定 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 comment

为 AMQP 配置指定注释。