你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

快速入门:使用 Azure 门户将 Azure Cache for Redis 事件路由到 Web 终结点

Azure 事件网格是针对云的事件处理服务。 在本快速入门中,你将使用 Azure 门户创建一个 Azure Cache for Redis 实例、订阅该实例的事件、触发事件,并查看结果。 通常,你会将事件发送到处理事件数据并执行操作的终结点。 但是,为了简化本快速入门,你需要将事件发送到要收集和显示消息的 Web 应用。

如果没有 Azure 帐户,请在开始前创建一个免费帐户

完成后即可看到事件数据已发送到 Web 应用。

Azure 事件网格查看器按 JSON 格式进行缩放。

创建 Azure Cache for Redis 缓存实例

  1. Azure 门户中,搜索并选择 Azure Redis 缓存

  2. Azure Redis 缓存 页上,选择“ 创建>Azure Redis 缓存”。

  3. “新建 Redis 缓存”页的“基本信息”选项卡上,配置以下设置:

    • 订阅:选择要使用的订阅。
    • 资源组:选择资源组,或选择 “新建 ”并输入新的资源组名称。 将所有应用资源放在同一资源组中即可轻松管理或删除它们。
    • 名称:输入区域中唯一的缓存名称。 名称必须:
      • 应为由 1 到 63 个字符组成的字符串。
      • 仅包含数字、字母和连字符。
      • 以数字或字母开头和结尾。
      • 不包含连续的连字符。
    • 区域:选择使用缓存的其他服务附近的 Azure 区域
    • 缓存 SKU:选择 SKU 来确定缓存的可用大小、性能和功能。
    • 缓存大小:选择缓存大小。 有关详细信息,请参阅 Azure Cache for Redis 概述

    显示“新建 Redis 缓存”页的“基本信息”选项卡的屏幕截图。

  4. 选择“ 网络 ”选项卡,或选择“ 下一步:网络”。

  5. 在“网络”选项卡上,选择用于缓存的连接方法。 建议使用专用终结点实现安全性。 如果选择 “专用终结点”,请选择“ 添加专用终结点 ”并创建专用终结点。

  6. 选择“ 高级 ”选项卡,或选择“ 下一步:高级”。

  7. “高级 ”窗格中,配置以下选项:

    • 选择 Microsoft Entra身份验证访问密钥身份验证。 默认情况下,Microsoft Entra Authentication 处于启用状态。
    • 选择是否 启用 非 TLS 端口。
    • 对于高级缓存,可以配置或禁用 可用性区域。 创建缓存后,无法禁用可用性区域。 对于标准缓存,会自动分配可用性区域。 可用性区域不适用于基本 SKU。
    • 对于高级缓存,请配置 副本计数群集分片计数系统分配的托管标识和数据 持久性的设置。

    下图显示了标准 SKU 的 “高级 ”选项卡。

    显示标准 SKU 缓存的高级窗格的屏幕截图。

    重要

    将 Microsoft Entra ID 与托管标识一起使用,以授权针对缓存的请求(如果可能)。 使用 Microsoft Entra ID 和托管标识的授权可提供更好的安全性,并且比共享访问密钥授权更容易使用。 若要详细了解如何将托管标识与缓存配合使用,请参阅使用 Microsoft Entra ID 进行缓存身份验证

  8. (可选)选择“ 标记 ”选项卡或选择“ 下一步:标记”,然后输入标记名称和值以对缓存资源进行分类。

  9. 选择 “查看 + 创建”,验证通过后,选择“ 创建”。

新的缓存部署需要几分钟时间。 可以在门户 Azure Redis 缓存页上监视部署进度。 当缓存 状态 显示 “正在运行”时,缓存可供使用。

创建消息终结点

在订阅缓存实例的事件之前,先来创建事件消息的终结点。 通常情况下,终结点基于事件数据执行操作。 为了简化此快速入门,需要部署一个预生成 Web 应用,它用于显示事件消息。 所部署的解决方案包括应用服务计划、应用服务 Web 应用和 GitHub 中的源代码。

  1. 选择 GitHub 自述文件中的“部署到 Azure”,将解决方案部署到你的订阅。

    “部署到 Azure”按钮。

  2. 在“自定义部署”页上执行以下步骤:

    1. 对于“资源组”,请选择你在创建缓存实例时创建的资源组。 这样就可以在完成本教程后,通过删除资源组来更轻松地进行清理。
    2. 对于“站点名称”,请输入 Web 应用的名称。
    3. 对于“托管计划名称”,请输入用于托管 Web 应用的应用服务计划的名称。
    4. 选中“我同意上述条款和条件”对应的复选框。
    5. 选择“购买”。
    设置 建议值 说明
    订阅 单击下拉箭头并选择你的订阅。 要在其中创建此 Web 应用的订阅。
    资源组 单击下拉箭头并选择一个资源组,或者选择“新建”并输入新的资源组名称。 将所有应用资源放入一个资源组可以轻松地统一管理或删除这些资源。
    站点名称 输入 Web 应用的名称。 此值不能为空。
    托管计划名称 输入用于托管 Web 应用的应用服务计划的名称。 此值不能为空。
  3. 在门户中选择“警报”(钟形图标),然后选择“转到资源组”。

    Azure 门户部署通知。

  4. 在“资源组”页上,在资源列表中,选择你创建的 Web 应用。 在此列表中,还可看到应用服务计划和缓存实例。

  5. 在 Web 应用的“应用服务”页上,选择相应的 URL 以导航到该网站。 URL 应采用以下格式:https://<your-site-name>.azurewebsites.net

  6. 确认你可以看到站点,但尚未有任何事件发布到站点。

    空的事件网格查看器站点。

注册事件网格资源提供程序

除非你以前用过事件网格,否则你需要注册事件网格资源提供程序。 如果你以前用过事件网格,请转到下一部分。

在 Azure 门户中,执行以下步骤:

  1. 在左侧菜单中选择“订阅”。

  2. 从订阅列表中选择要用于事件网格的订阅。

  3. 在“订阅”页左侧菜单的“设置”下,选择“资源提供程序”。

  4. 搜索 Microsoft.EventGrid,并确认“状态”为“未注册”。

  5. 在提供程序列表中选择“Microsoft.EventGrid”。

  6. 在命令栏上选择“注册”。

    显示向 Azure 订阅注册 Microsoft.EventGrid 提供程序的图像。

  7. 刷新以确保 Microsoft.EventGrid 的状态更改为“已注册”。

    显示向 Azure 订阅成功注册 Microsoft.EventGrid 提供程序的图像。

订阅 Azure Cache for Redis 实例

在此步骤中,你将订阅主题,使事件网格知道你想要跟踪哪些事件,以及要将事件发送到哪里。

  1. 在门户中,导航到你之前创建的缓存实例。

  2. 在“Azure Cache for Redis”页面上,选择左侧菜单中的“事件” 。

  3. 选择“Webhook”。 你正在使用终结点的 Webhook 将事件发送到查看器应用。

    Azure 门户的“事件”页面。

  4. 在“创建事件订阅”页面中输入以下内容:

    设置 建议值 说明
    名称 为事件订阅输入一个名称。 值长度必须为 3 到 64 个字符。 只能包含字母、数字和短划线。
    事件类型 下拉并选择要推送到目标的事件类型。 对于本快速入门,我们将缩放缓存实例。 可用选项包括修补、缩放、导入和导出。
    终结点类型 选择“Webhook”。 用来接收事件的事件处理程序。
    终结点 选择“选择终结点”,输入你的 Web 应用的 URL 并将 添加到主页 URL(例如 api/updates),然后选择“确认选择”。 这是你之前创建的 Web 应用的 URL。
  5. 现在,在“创建事件订阅”页上,选择“创建”以创建事件订阅。

  6. 再次查看 Web 应用,并注意现已向该应用发送了订阅验证事件。 选择眼睛图标以展开事件数据。 事件网格发送验证事件,以便终结点可以验证它是否想要接收事件数据。 Web 应用包含用于验证订阅的代码。

    Azure 事件网格查看器。

向终结点发送事件

现在,让我们触发一个事件,看事件网格如何将消息分发到终结点。 我们将缩放 Azure Cache for Redis 实例。

  1. 在 Azure 门户中,导航到 Azure Cache for Redis 实例,并在左侧菜单中选择“缩放”。

  2. 从“缩放”页中选择所需的定价层,然后选择“选择”。

    可以扩展到不同定价层,但有以下限制:

    • 不能从较高的定价层缩放到较低的定价层。
      • 不能从高级缓存向下缩放到标准基本缓存。
      • 不能从标准缓存向下缩放到基本缓存。
    • 可从基本缓存缩放到标准缓存,但不能同时更改大小。 如果需要不同大小,则可以执行后续缩放操作以缩放为所需大小。
    • 不能从基本缓存直接缩放到高级缓存。 首先在一个缩放操作中从基本缩放到标准,然后在后续的缩放操作中从标准缩放到高级
    • 不能从较大的大小减小为 C0 (250 MB)

    当缓存缩放到新的定价层,会在左侧通过 Azure Cache for Redis 显示“缩放”状态。 缩放完成后,状态将从正在缩放更改为正在运行

  3. 现已触发事件,并且事件网格已将消息发送到订阅时配置的终结点。 消息采用 JSON 格式,它包含一个或多个事件的数组。 在以下示例中,JSON 消息包含一个事件的数组。 查看 Web 应用,你将会看到已收到一个“ScalingCompleted”事件。

    Azure 事件网格查看器按 JSON 格式进行缩放。

清理资源

如果打算继续处理此事件,请不要清除在本快速入门中创建的资源。 否则,请删除在这些资源。

选择资源组,然后选择“删除资源组”。

后续步骤

了解如何创建自定义主题和事件订阅后,请详细了解事件网格的功能: