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服务端点设置为 PRIMARY
和 SECONDARY
:
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桶通知 一起使用的AMQP服务端点的顶级配置键。
使用 mc admin config set
来设置或更新一个AMQP服务端点。
对于每个目标,url
参数是 必需 的。
将其他可选参数指定为空格 ( " "
) 分隔的列表。
mc admin config set notify_amqp \
url="amqp://user:password@endpoint:port" \
[ARGUMENT="VALUE"] ...
URL
必需的
指定MinIO发布桶事件的AMQP服务器端点。
例如, amqp://myuser:mypassword@localhost:5672
.
在 RELEASE.2023-05-27T05-56-19Z 版本发生变更: 在添加目标之前,MinIO会检查指定URL的健康状况(如果其能被解析并可以访问)。 如果现有目标离线,MinIO不再阻止添加新的通知目标。
Exchange
可选
指定要使用的 AMQP 交换的名称。
Exchange Type
可选
指定 AMQP 交换的类型。
Routing Key
可选
指定发布事件的路由键。
Mandatory
可选
指定 off
以忽略未送达的消息错误。
默认为 on
.
Durable
可选
指定 on
以在代理重新启动时保留消息队列。
默认为 off
.
No Wait
可选
指定 on
以启用非阻塞消息传递。
默认为 off
.
Internal
可选
指定 on
以仅在它绑定到其他交换机时使用交换机。
有关AMQP交换机绑定的更多信息,请参阅RabbitMQ文档中的
Exchange to Exchange Bindings。
自动删除
可选
指定 on
以在没有任何消费者的情况下自动删除消息队列。
默认为 off
.
交付方式
可选
指定 1
以将消息传递模式设置为非持久化队列。
指定 2
以将消息传递模式设置为持久化队列。
队列目录
可选
指定目录路径以启用MinIO的持久化事件存储,例如 /opt/minio/events
。
MinIO 在 AMQP 服务离线时,将未投递的事件存储在指定的存储中,并在连接恢复时重新播放存储的事件。
队列限制
可选
指定未发送消息的最大限制。
默认为 100000
.
Comment
可选
在 AMQP 配置中指定一个注释。