擦除码计算器 
参考硬件 将事件发布到 MQTT
MinIO 支持将 存储桶通知 事件发布到 MQTT 服务器/代理端点。
将 MQTT 端点添加到 MinIO 部署
以下步骤将添加一个新的 MQTT 服务端点，以支持 MinIO 部署中的 存储桶通知。
先决条件
MQTT 3.1 或 3.1.1 服务器/代理
此步骤假定存在一个现有的 MQTT 3.1 或 3.1.1 服务器/代理，MinIO 部署可以与其建立连接。请参阅 mqtt.org 软件列表，了解与 MQTT 兼容的服务器/代理列表。
如果 MQTT 服务需要身份验证，您 *必须* 在配置过程中提供相应的用户名和密码，以授予 MinIO 访问服务的权限。
MinIO mc 命令行工具
1) 将 MQTT 端点添加到 MinIO
您可以使用环境变量 *或* 运行时配置设置来配置新的 MQTT 服务端点。
MinIO 支持使用 环境变量 指定 MQTT 服务端点和相关的配置设置。 minio server 进程会在下次启动时应用指定的设置。
以下示例代码设置了与配置 MQTT 服务端点相关的所有环境变量。 最低要求的变量是：
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 服务器/代理端点的最低要求：
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 以获取该值
1) 使用 MQTT 端点作为目标配置存储桶通知
使用 mc event add 命令添加一个新的存储桶通知事件，并使用配置的 MQTT 服务作为目标
mc event add ALIAS/BUCKET arn:minio:sqs::primary:mqtt \
--event EVENTS
使用 mc event ls 查看为给定通知目标配置的所有存储桶事件
mc event ls ALIAS/BUCKET arn:minio:sqs::primary:MQTT
4) 验证配置的事件
对您配置了新事件的存储桶执行操作，并检查 MQTT 服务以获取通知数据。所需的操作取决于在配置存储桶通知时指定的events。
例如，如果存储桶通知配置包含s3:ObjectCreated:Put事件，您可以使用mc cp命令在存储桶中创建新的对象并触发通知。
mc cp ~/data/new-object.txt ALIAS/BUCKET
在 MinIO 部署中更新 MQTT 端点
以下步骤将更新现有的 MQTT 服务端点，以支持在 MinIO 部署中存储桶通知。
先决条件
MQTT 3.1 或 3.1.1 服务器/代理端点
此步骤假定存在一个现有的 MQTT 3.1 或 3.1.1 服务器/代理，MinIO 部署可以与其建立连接。请参阅 mqtt.org 软件列表，了解与 MQTT 兼容的服务器/代理列表。
如果 MQTT 服务需要身份验证，您 *必须* 在配置过程中提供相应的用户名和密码，以授予 MinIO 访问服务的权限。
MinIO 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 服务器/代理端点所需的最小设置
所有其他配置设置都是可选的。有关 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
