将事件发布到 MQTT

MinIO 支持将存储桶通知事件发布到MQTT 服务器/代理端点。

向 MinIO 部署添加 MQTT 端点

以下过程添加了一个新的 MQTT 服务端点，用于支持 MinIO 部署中的存储桶通知。

先决条件

MQTT 3.1 或 3.1.1 服务器/代理

此过程假设存在一个现有的 MQTT 3.1 或 3.1.1 服务器/代理，MinIO 部署可以连接到该服务器/代理。请参阅mqtt.org 软件列表，以获取 MQTT 兼容服务器/代理的列表。

如果 MQTT 服务需要身份验证，则必须在配置过程中提供相应的用户名和密码，以授予 MinIO 访问该服务的权限。

MinIO `mc` 命令行工具

此过程使用mc 命令行工具执行某些操作。请参阅 mc 快速入门，了解安装说明。

1) 将 MQTT 端点添加到 MinIO

您可以使用环境变量或设置运行时配置设置来配置新的 MQTT 服务端点。

环境变量

MinIO 支持使用环境变量指定 MQTT 服务端点和关联的配置设置。minio server 进程在其下次启动时应用指定的设置。

以下示例代码设置了与配置 MQTT 服务端点相关所有环境变量。最低必需变量为

MINIO_NOTIFY_MQTT_ENABLE
MINIO_NOTIFY_MQTT_BROKER
MINIO_NOTIFY_MQTT_TOPIC
MINIO_NOTIFY_MQTT_USERNAME 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必需
MINIO_NOTIFY_MQTT_PASSWORD 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必填项

set MINIO_NOTIFY_MQTT_ENABLE_<IDENTIFIER>="on"
set MINIO_NOTIFY_MQTT_BROKER_<IDENTIFIER>="ENDPOINT"
set MINIO_NOTIFY_MQTT_TOPIC_<IDENTIFIER>="TOPIC"
set MINIO_NOTIFY_MQTT_USERNAME_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_PASSWORD_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_QOS_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_KEEP_ALIVE_INTERVAL_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_RECONNECT_INTERVAL_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_QUEUE_DIR_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_QUEUE_LIMIT_<IDENTIFIER>="<string>"
set MINIO_NOTIFY_MQTT_COMMENT_<IDENTIFIER>="<string>"

将 <IDENTIFIER> 替换为 MQTT 服务端点的唯一描述性字符串。对于与新的 MQTT 服务端点相关的所有环境变量，使用相同的 <IDENTIFIER> 值。以下示例假设标识符为 PRIMARY。

如果指定的 <IDENTIFIER> 与 MinIO 部署中现有的 MQTT 服务端点匹配，则新设置将覆盖该端点的任何现有设置。使用 mc admin config get notify_mqtt 查看 MinIO 部署中当前配置的 MQTT 端点。
将 <ENDPOINT> 替换为 MQTT 服务端点的 URL。例如

tcp://hostname:port
将 TOPIC 替换为 MinIO 将发布到服务器/代理的事件关联到的 MQTT 主题。

有关每个环境变量的完整文档，请参阅用于存储桶通知的 MQTT 服务。

配置设置

MinIO 支持在正在运行的 minio server 进程上添加或更新 MQTT 端点，方法是使用 mc admin config set 命令和 notify_mqtt 配置键。您必须重新启动 minio server 进程以应用任何新的或更新的配置设置。

以下示例代码设置了与配置 MQTT 服务端点相关的所有设置。以下配置设置是 MQTT 服务器/代理端点所需的最低设置

代理
主题
username 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必填项
password 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必填项

mc admin config set ALIAS/ notify_mqtt:IDENTIFIER \
   broker="ENDPOINT" \
   topic="TOPIC" \
   username="username" \
   password="password" \
   qos="<integer>" \
   keep_alive_interval="60s|m|h|d"
   reconnect_interval="60s|m|h|d"
   queue_dir="<string>" \
   queue_limit="<string>" \
   comment="<string>"

将 IDENTIFIER 替换为 MQTT 服务端点的唯一描述性字符串。此过程中的以下示例假设标识符为 PRIMARY。

如果指定的 IDENTIFIER 与 MinIO 部署中现有的 MQTT 服务端点匹配，则新设置将覆盖该端点的任何现有设置。使用 mc admin config get notify_mqtt 查看 MinIO 部署中当前配置的 MQTT 端点。
将 ENDPOINT 替换为 MQTT 服务端点的 URL。例如

tcp://hostname:port
将 TOPIC 替换为 MinIO 将发布到服务器/代理的事件关联到的 MQTT 主题。

有关每个设置的完整文档，请参阅 MQTT 存储桶通知配置设置。

2) 重新启动 MinIO 部署

您必须重新启动 MinIO 部署才能应用配置更改。使用 mc admin service restart 命令重新启动部署。

mc admin service restart ALIAS

将 ALIAS 替换为要重新启动的部署的别名。

minio server 进程在启动时会为每个配置的 MQTT 目标打印一行，类似于以下内容

SQS ARNs: arn:minio:sqs::primary:mqtt

使用关联的 MQTT 部署作为目标配置存储桶通知时，必须指定 ARN 资源。

识别存储桶通知的 ARN

在之前创建端点时，您定义了要分配给存储桶通知目标 ARN 的 <IDENTIFIER>。以下步骤返回部署中配置的 ARN。通过查找您指定的 <IDENTIFIER> 来识别之前创建的 ARN。

查看 JSON 输出

复制并运行以下命令，将 ALIAS 替换为部署的别名。
```
mc admin info --json ALIAS
```
在 JSON 输出中，查找键 info.sqsARN。

您需要的 ARN 是与您指定的 <IDENTIFIER> 匹配的该键的值。

例如，arn:minio:sqs::primary:mqtt。

使用 jq 解析 JSON 以获取值

安装 jq
复制并运行以下命令，将 ALIAS 替换为部署的别名。
```
mc admin info --json ALIAS | jq  .info.sqsARN
```
这将返回用于通知的 ARN，例如 arn:minio:sqs::primary:mqtt

1) 使用 MQTT 端点作为目标配置存储桶通知

使用 mc event add 命令添加一个新的存储桶通知事件，并将配置的 MQTT 服务作为目标

mc event add ALIAS/BUCKET arn:minio:sqs::primary:mqtt \
  --event EVENTS

将 ALIAS 替换为 MinIO 部署的别名。
将 BUCKET 替换为要在其中配置事件的存储桶的名称。
将 EVENTS 替换为 MinIO 触发通知的事件的逗号分隔列表。

使用 mc event ls 查看给定通知目标的所有配置的存储桶事件

mc event ls ALIAS/BUCKET arn:minio:sqs::primary:MQTT

4) 验证配置的事件

对您为其配置新事件的存储桶执行操作，并在 MQTT 服务中检查通知数据。所需的操作取决于配置存储桶通知时指定的 事件。

例如，如果存储桶通知配置包含 s3:ObjectCreated:Put 事件，则可以使用 mc cp 命令在存储桶中创建一个新对象并触发通知。

mc cp ~/data/new-object.txt ALIAS/BUCKET

更新 MinIO 部署中的 MQTT 端点

以下过程更新了现有的 MQTT 服务端点，以支持 MinIO 部署中的存储桶通知。

先决条件

MQTT 3.1 或 3.1.1 服务器/代理端点

如果 MQTT 服务需要身份验证，则必须在配置过程中提供相应的用户名和密码，以授予 MinIO 访问该服务的权限。

MinIO `mc` 命令行工具

此过程使用mc 命令行工具执行某些操作。请参阅 mc 快速入门，了解安装说明。

1) 列出部署中配置的 MQTT 端点

使用 mc admin config get 命令列出部署中当前配置的 MQTT 服务端点

mc admin config get ALIAS/ notify_mqtt

将 ALIAS 替换为 MinIO 部署的别名。

命令输出类似于以下内容

notify_mqtt:primary  broker="tcp://mqtt-primary.example.net:port" password="" queue_dir="" queue_limit="0" reconnect_interval="0s"  keep_alive_interval="0s" qos="0" topic="" username=""
notify_mqtt:secondary  broker="tcp://mqtt-primary.example.net:port" password="" queue_dir="" queue_limit="0" reconnect_interval="0s"  keep_alive_interval="0s" qos="0" topic="" username=""

notify_mqtt 密钥是 MQTT 通知设置的顶级配置密钥。 broker 密钥指定给定 notify_mqtt 密钥的 MQTT 服务器/代理端点。 notify_mqtt:<IDENTIFIER> 后缀描述该 MQTT 服务端点的唯一标识符。

请注意您要更新的 MQTT 服务端点的标识符，以便于下一步操作。

2) 更新 MQTT 端点

使用 mc admin config set 命令设置 MQTT 服务端点的新的配置。

mc admin config set ALIAS/ notify_mqtt:<IDENTIFIER> \
   url="MQTT://user:password@hostname:port" \
   exchange="<string>" \
   exchange_type="<string>" \
   routing_key="<string>" \
   mandatory="<string>" \
   durable="<string>" \
   no_wait="<string>" \
   internal="<string>" \
   auto_deleted="<string>" \
   delivery_mode="<string>" \
   queue_dir="<string>" \
   queue_limit="<string>" \
   comment="<string>"

以下配置设置是 MQTT 服务器/代理端点所需的**最低**配置。

代理
主题
username 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必填项
password 如果 MQTT 服务器/代理强制执行身份验证/授权，则为必填项

所有其他配置设置均为**可选**。有关 MQTT 配置设置的完整列表，请参阅 MQTT 通知设置。

3) 重启 MinIO 部署

您必须重新启动 MinIO 部署才能应用配置更改。使用 mc admin service restart 命令重新启动部署。

mc admin service restart ALIAS

将 ALIAS 替换为要重新启动的部署的别名。

minio server 进程在启动时会为每个配置的 MQTT 目标打印一行，类似于以下内容

SQS ARNs: arn:minio:sqs::primary:mqtt

3) 验证更改

对使用更新的 MQTT 服务端点配置了事件的存储桶执行操作，并检查 MQTT 服务中的通知数据。所需的操作取决于配置存储桶通知时指定的 events 。

例如，如果存储桶通知配置包含 s3:ObjectCreated:Put 事件，则可以使用 mc cp 命令在存储桶中创建一个新对象并触发通知。

mc cp ~/data/new-object.txt ALIAS/BUCKET

将事件发布到 MQTT

向 MinIO 部署添加 MQTT 端点

先决条件

MQTT 3.1 或 3.1.1 服务器/代理

MinIO mc 命令行工具

1) 将 MQTT 端点添加到 MinIO

2) 重新启动 MinIO 部署

1) 使用 MQTT 端点作为目标配置存储桶通知

4) 验证配置的事件

更新 MinIO 部署中的 MQTT 端点

先决条件

MQTT 3.1 或 3.1.1 服务器/代理端点

MinIO mc 命令行工具

1) 列出部署中配置的 MQTT 端点

2) 更新 MQTT 端点

3) 重启 MinIO 部署

3) 验证更改

MinIO `mc` 命令行工具

MinIO `mc` 命令行工具