将事件发布至Redis

MinIO 支持将桶通知事件发布到 Redis 服务端点。

将 Redis 端点添加到 MinIO 部署

以下步骤为 MinIO 部署添加一个新的 Redis 服务端点，以支持桶通知。

先决条件

MinIO `mc` 命令行工具

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

1) 将 Redis 端点添加到 MinIO

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

Environment Variables

MinIO支持指定Redis服务端点和关联配置设置使用环境变量. 当您设置环境变量后，minio server 进程将在下一次启动时应用这些设置。

以下示例代码设置所有环境变量与配置 Redis 服务端点相关。最低 必需的 变量是：

MINIO_NOTIFY_REDIS_ENABLE
MINIO_NOTIFY_REDIS_ADDRESS
MINIO_NOTIFY_REDIS_KEY
MINIO_NOTIFY_REDIS_FORMAT

   export MINIO_NOTIFY_REDIS_ENABLE_<IDENTIFIER>="on"
   export MINIO_NOTIFY_REDIS_ADDRESS_<IDENTIFIER>="<ENDPOINT>"
   export MINIO_NOTIFY_REDIS_KEY_<IDENTIFIER>="<STRING>"
   export MINIO_NOTIFY_REDIS_FORMAT_<IDENTIFIER>="<string>"
   export MINIO_NOTIFY_REDIS_PASSWORD_<IDENTIFIER>="<string>"
   export MINIO_NOTIFY_REDIS_QUEUE_DIR_<IDENTIFIER>="<string>"
   export MINIO_NOTIFY_REDIS_QUEUE_LIMIT_<IDENTIFIER>="<string>"
   export MINIO_NOTIFY_REDIS_COMMENT_<IDENTIFIER>="<string>"

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

如果指定的 <IDENTIFIER> 匹配MinIO部署上现有的 Redis服务端点，新的设置将覆盖该端点现有的任何设置。使用 mc admin config get notify_redis 来查看MinIO部署上当前配置的Redis端点。
将 <ENDPOINT> 替换为Redis服务端点的URL。例如： https://redis.example.com:6369

请参阅 Redis Service for Bucket Notifications 以获取有关每个环境变量的完整文档说明。

Configuration Settings

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

以下示例代码设置与配置相关的所有设置 Redis 服务端点。最小必需设置包括：

notify_redis address
notify_redis key
notify_redis format

mc admin config set ALIAS/ notify_redis:IDENTIFIER \
  address="ENDPOINT" \
  key="<string>" \
  format="<string>" \
  password="<string>" \
  queue_dir="<string>" \
  queue_limit="<string>" \
  comment="<string>"

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

如果指定的 IDENTIFIER 匹配 MinIO 部署中现有的 Redis 服务端点，则新设置将覆盖该端点的任何现有设置。使用 mc admin config get notify_redis 命令来查看 MinIO 部署上当前配置的 Redis 端点。
将 ENDPOINT 替换为 Redis 服务端点的 URL。例如： https://redis.example.com:6369

请参阅 Redis Bucket Notification Configuration Settings 了解每个设置的完整文档。

2) 重新启动MinIO部署。

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

mc admin service restart ALIAS

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

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

SQS ARNs: arn:minio:sqs::primary:redis

在配置将关联的 Redis 部署作为目标的桶通知时，您必须指定 ARN 资源。

Identifying the ARN for your bucket notifications

在创建端点之前，您定义了 <IDENTIFIER> 以便为您的存储桶通知分配目标ARN。以下是返回部署上配置的ARNs的步骤：识别之前创建的ARN，请查找您指定的 <IDENTIFIER> 。

查看 JSON 输出

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

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

例如, arn:minio:sqs::primary:redis.

使用 jq 解析 JSON 中的值

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

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

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

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

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

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

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

4) 验证配置的事件

对你配置了新事件的桶执行一个操作，并检查Redis服务以获取通知数据。所需的操作取决于在配置桶通知时指定的哪些 事件。

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

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

在MinIO部署中更新Redis端点

以下步骤将更新MinIO部署中现有Redis服务的端点，以支持桶通知。

先决条件

MinIO `mc` 命令行工具

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

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

要列出部署中当前配置的Redis服务端点，请使用 mc admin config get 命令：

mc admin config get ALIAS/ notify_redis

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

命令的输出类似于以下内容：

notify_redis:primary address="https://redis.example.com:6369" format="namespace" key="minioevent" password="" queue_dir="" queue_limit="0"
notify_redis:secondary address="https://redis.example.com:6369" format="namespace" key="minioevent" password="" queue_dir="" queue_limit="0"

notify_redis 是顶级配置键，用于 minio-server-config-bucket-notification-redis。 address 键指定了给定 notify_redis 键的Redis服务端点。 notify_redis:<IDENTIFIER> 后缀描述了该Redis服务端点的唯一标识符。

请注意，您想要在下一步中更新的Redis服务端点的标识符。

2) 更新 Redis 端点

使用 :mc-cmd:`mc admin config set`命令来设置 Redis服务端点的新配置：

mc admin config set ALIAS/ notify_redis:IDENTIFIER \
   address="ENDPOINT" \
   key="<string>" \
   format="<string>" \
   password="<string>" \
   queue_dir="<string>" \
   queue_limit="<string>" \
   comment="<string>"

notify_redis address 配置设置是Redis服务端点所需的最低要求。所有其他配置设置都是 可选的。请参考 minio-server-config-bucket-notification-redis 以获取完整的Redis配置设置列表。

3) 重新启动MinIO部署。

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

mc admin service restart ALIAS

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

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

SQS ARNs: arn:minio:sqs::primary:redis

4) 验证更改

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

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

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

商业支持购买咨询

将事件发布至Redis

将 Redis 端点添加到 MinIO 部署

先决条件

MinIO mc 命令行工具

1) 将 Redis 端点添加到 MinIO

2) 重新启动MinIO部署。

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

4) 验证配置的事件

在MinIO部署中更新Redis端点

先决条件

MinIO mc 命令行工具

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

2) 更新 Redis 端点

3) 重新启动MinIO部署。

4) 验证更改

MinIO `mc` 命令行工具

MinIO `mc` 命令行工具