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

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

如果没有 Azure 订阅,可在开始前创建一个试用帐户

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

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

创建 Azure Cache for Redis 缓存实例

  1. 若要创建缓存,请登录到 Azure 门户并选择“创建资源” 。

    左侧导航窗格中突出显示了“创建资源”。

  2. 在“入门”页上的搜索框中键入“Azure Cache for Redis”。 然后选择创建

    Azure 市场的屏幕截图,其中的搜索框中包含“Azure Cache for Redis”,并用红色框突出显示了“创建”。

  3. 在“新建 Redis 缓存”页上配置缓存的设置。

    设置 选择值 说明
    订阅 单击下拉箭头并选择你的订阅。 要在其下创建此新的 Azure Cache for Redis 实例的订阅。
    资源组 单击下拉箭头并选择一个资源组,或者选择新建并输入新的资源组名称。 要在其中创建缓存和其他资源的资源组的名称。 将所有应用资源放入一个资源组可以轻松地统一管理或删除这些资源。
    DNS 名称 输入唯一名称。 缓存名称必须是包含 1 到 63 个字符的字符串,只能包含数字、字母或连字符。 该名称必须以数字或字母开头和结尾,且不能包含连续的连字符。 缓存实例的主机名<DNS name>.redis.cache.chinacloudapi.cn
    位置 单击下拉箭头并选择一个位置。 选择使用缓存的其他服务附近的区域
    缓存 SKU 打开下拉列表并选择一个 SKU 此 SKU 决定可用于缓存的大小、性能和功能参数。 有关详细信息,请参阅用于 Redis 的 Azure 缓存概述
    缓存大小 打开下拉列表并选择缓存的大小 有关详细信息,请参阅用于 Redis 的 Azure 缓存概述
  4. 选择网络选项卡,或选择网络按钮(位于页面底部) 。

  5. 网络选项卡中,选择你的连接方法。

  6. 选择“下一步: 高级”选项卡,或选择页面底部的“下一步: 高级”按钮,以查看“高级”选项卡。

    显示工作窗格中的“高级”选项卡和可供选择选项的屏幕截图。

    • 对于“基本”或“标准”缓存,请切换非 TLS 端口的选项。 还可以选择是否要启用“Microsoft Entra 身份验证”。
    • 对于“高级”缓存,请配置非 TLS 端口、群集、托管标识和数据持久性的设置。 还可以选择是否要启用“Microsoft Entra 身份验证”。
  7. 选择下一步: 标记选项卡,或选择页面底部的下一步: 标记按钮 。

  8. 或者,在标记选项卡中,如果希望对资源分类,请输入名称或值。

  9. 选择查看 + 创建。 随后你会转到“查看 + 创建”选项卡,Azure 将在此处验证配置。

  10. 显示绿色的“已通过验证”消息后,选择创建

创建缓存需要一段时间。 可以在 Azure Cache for 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>.chinacloudsites.cn

  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 并将 api/updates 添加到主页 URL(例如 https://cache.chinacloudsites.cn/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 格式进行缩放。

清理资源

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

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

后续步骤

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