中文文档

AMQP 通知设置

本页面文档了配置AMQP服务作为 Bucket Notifications <minio-bucket-notifications>`目标的设置。 有关使用这些设置的教程,请参阅 :ref:`minio-bucket-notifications-publish-amqp

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

  • 在启动或重新启动 MinIO 服务器之前,在宿主系统上定义一个 环境变量。 请参阅您的操作系统的文档,了解如何定义环境变量。

  • 使用 mc admin config set 命令来设置一个 配置项

  • 使用 MinIO控制台管理员 > 设置 页面来设置一个 配置项

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

有些设置只有环境变量或配置设置,而不是两者都有。

重要

每个配置设置都控制着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 上,而不是每个单独的参数上。

设置

Enable

MINIO_NOTIFY_AMQP_ENABLE

如果设置为 on ,则需要指定 MINIO_NOTIFY_AMQP_URL 环境变量。

指定 on 以启用将桶通知发布到AMQP端点。

默认为 off .

notify_amqp

用于定义与 MinIO桶通知 一起使用的AMQP服务端点的顶级配置键。

使用 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 .

在 RELEASE.2023-05-27T05-56-19Z 版本发生变更: 在添加目标之前,MinIO会检查指定URL的健康状况(如果其能被解析并可以访问)。 如果现有目标离线,MinIO不再阻止添加新的通知目标。

Exchange

可选

MINIO_NOTIFY_AMQP_EXCHANGE
notify_amqp exchange

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

Exchange Type

可选

MINIO_NOTIFY_AMQP_EXCHANGE_TYPE
notify_amqp exchange_type

指定 AMQP 交换的类型。

Routing Key

可选

MINIO_NOTIFY_AMQP_ROUTING_KEY
notify_amqp routing_key

指定发布事件的路由键。

Mandatory

可选

MINIO_NOTIFY_AMQP_MANDATORY
notify_amqp mandatory

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

Durable

可选

MINIO_NOTIFY_AMQP_DURABLE
notify_amqp durable

指定 on 以在代理重新启动时保留消息队列。 默认为 off .

No Wait

可选

MINIO_NOTIFY_AMQP_NO_WAIT
notify_amqp no_wait

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

Internal

可选

MINIO_NOTIFY_AMQP_INTERNAL
notify_amqp internal

指定 on 以仅在它绑定到其他交换机时使用交换机。 有关AMQP交换机绑定的更多信息,请参阅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

MinIO 在 AMQP 服务离线时,将未投递的事件存储在指定的存储中,并在连接恢复时重新播放存储的事件。

队列限制

可选

MINIO_NOTIFY_AMQP_QUEUE_LIMIT
notify_amqp queue_limit

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

Comment

可选

MINIO_NOTIFY_AMQP_COMMENT
notify_amqp comment

在 AMQP 配置中指定一个注释。

Join Slack 商业支持购买咨询