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

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

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

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

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

  • 更新组 - 在生产推出期间接收 API 管理服务更新的一组实例,可能需要数天到数周才能完成。

    从以下项中进行选择:

    • 早期 - 提前接收推出中的更新,以便测试和提前访问新功能。 不建议对生产部署使用此选项。
    • 默认值 - 在常规发布推出过程中接收更新。 对于大多数服务(包括生产部署),建议使用此选项。
    • 延迟 - 通常在初始推出后的几周接收更新,比以前的组晚。 建议仅对任务关键型部署使用此选项。
    • AI 网关抢先体验(GenAI 发布通道)- 在其他更新组之前,抢先体验最新的 AI 网关功能和更新。 接收“推迟”推出组包含的其他服务更新

    注释

    Azure 使用 安全部署实践(SDP)框架部署所有更新。 推出早期发布的更新可能不太稳定,稍后会由更稳定的版本取代。 所有实例最终都会更新为最稳定的发行版本。

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

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

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

配置服务更新设置

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

了解实例何时接收更新

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

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

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

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

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

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

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

小窍门

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

Canary 部署策略

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

  • 将实例添加到早期更新组 - 使用早期更新组中的 API 管理实例在生产推出初期验证更新。 此实例相当于您的 Canary 部署。

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

    注释

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

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

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

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