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

为 API 管理实例配置服务更新设置

适用于:基本 | 标准 | 高级

本文介绍如何在 API 管理实例中配置 服务更新 设置(预览)。 Azure 使用分阶段推出方法定期自动将服务更新应用到 API 管理实例。 这些更新包括新功能、安全性增强和可靠性改进。

无法准确控制 Azure 更新每个 API 管理实例的时间,但在选择服务层级中,可以为实例选择 更新组 ,以便它在更新推出期间早于或晚接收更新。 还可以在希望实例接收更新的一天中配置 维护时段

更新组

更新组(也称为 发布通道)是在生产推出期间接收 API 管理服务更新的一组实例,可能需要数天到几周才能完成。

更新组 Description
AI 网关抢先版(GenAI 发布频道) 提前获取最新的 AI 网关功能和更新,比其他更新组更早体验。

将最稳定的主线服务更新与最新的 AI 特定功能相结合。 接收其他服务更新作为 后期 更新组的一部分,从而加快 AI 相关功能的部署速度。
在推出初期接收更新,以便测试和提前访问新功能。 不建议对生产部署使用此选项。
默认 作为常规发布的一部分接收更新。 对于大多数服务(包括生产部署),建议使用此选项。
延迟 接收更新的时间比之前的组晚,通常是在首次推出几周后。 建议仅对任务关键型部署使用此选项。

注释

  • Azure 使用 安全部署做法 (SDP) 框架部署所有更新。 在发布早期发布的更新可能不太稳定,以后会被稳定版本所取代。 所有实例最终都会更新为最稳定的发行版本。
  • 所有更新组都可以在预览版中包含功能。 Azure 门户和文档中明确介绍了预览功能。
  • 功能在此序列中通过更新组传播: AI 网关早期 (仅 AI 功能)→ 早期默认延迟

例如,你可能想要将测试实例添加到 早期 更新组。 此实例在生产实例之前接收更新,这些更新放入 默认后期 更新组中。 在更新到达生产实例之前,可以监视测试实例是否存在任何问题。 了解如何通过 API 管理进行 Canary 部署

维护时段

维护时段是希望实例接收更新的每日 8 小时时段。 默认情况下,维护时段为实例时区的下午 10 点到 6 点。

在更新期间,服务中断很少见,但你可能希望通过选择低服务使用时间来降低风险。 例如,对于生产实例,在工作日晚上和周末早晨设置维护时段。

配置服务更新设置

  1. 登录到 Azure 门户 并转到 API 管理实例。
  2. 在左侧菜单中,选择 “部署 + 基础结构>服务更新设置”。
  3. “更新”组下,查看当前设置,然后选择“ 编辑” 以更改它。
  4. “维护”窗口中,查看当前设置,然后选择 “编辑” 以更改它们。 每天,您可以选择默认窗口、其他标准窗口或按日设置的自定义窗口。

了解实例何时收到更新

下面介绍如何了解预期或正在进行的服务更新。

  • API Management 更新在 API Management GitHub 存储库中公布。 订阅此存储库以接收通知,以了解更新推送何时开始。

  • 使用 Azure 活动日志 监视 API 管理实例中发生的服务更新。 当更新开始时,会发出“计划性维护”事件。

    门户中的活动日志中的计划性维护事件。

    若要自动接收通知,请对活动日志设置警报

  • 默认情况下,更新按照以下阶段逐步覆盖区域:首先是 Azure EUAP 区域,然后是美国中西部地区,最后是其他区域在后续几个阶段中更新。 在后续部署阶段中更新的区域顺序因服务而异。 每两个生产推出阶段预期至少相隔 24 小时。

  • 在一个区域,高级层级中的 API Management 实例比其他服务层级中的实例晚几个小时接收更新。

小窍门

如果 API Management 实例部署到多个位置(区域),则更新时间由实例的主要位置确定。

Canary 部署策略

可以使用分配给特定更新组的 API 管理实例(如果该选项可用)或部署在特定的 Azure 区域中,作为早于生产实例接收更新的 Canary 部署。

  • 将实例添加到早期更新组 - 使用早期更新组中的 API 管理实例在生产推出初期验证更新。 此实例实际上就是你的 Canary 部署。

  • 在 Canary 区域中部署 - 如果有权访问 Azure EUAP 区域,请在将更新发布到生产管道后立即使用该实例来验证更新。 了解 Azure 区域访问请求过程

    注释

    由于 EUAP 区域中的容量限制,你可能无法根据需要缩放 API Management 实例。

  • 在试点区域中部署 - 使用美国中西部区域中的某个实例来模拟生产环境,或在生产环境中使用该实例来处理非关键 API 流量。 虽然此区域在 EUAP 区域之后接收更新,但其中的部署更有可能识别到特定于服务配置的回归。

  • 在区域中部署重复实例 - 如果你的生产工作负荷是特定区域中的高级层级实例,请考虑在较早接收更新的较低层级中部署采用类似配置的实例。 例如,在开发人员层中配置预生产实例以验证更新。

  • 了解如何监视 API Management 实例。
  • 了解用于观察 API Management 实例的其他选项。