自承载网关的支持策略

可用性

重要

此功能在 API 管理的“高级”和“开发人员”层中可用。

使用开发人员层和高级层中的 Azure API 管理服务,可以将 API 管理网关部署为在本地基础结构、其他云和支持容器的 Azure 基础结构选项中运行的容器。 本文详细说明 API 管理自承载网关的技术支持策略和限制。

重要

对 Azure API 管理自承载网关版本 0 和版本 1 容器映像的支持及其相应配置 API v1 将于 2023 年 10 月 1 日结束。 使用迁移指南,将自承载网关 v2.0.0 或更高版本与配置 API v2 结合使用。 在弃用文档中了解详细信息

托管网关与自承载网关的差异

部署 API 管理服务实例时,你始终会获得属于该服务的托管 API 网关。 此网关在 Azure 管理的基础结构中运行,其软件也由 Azure 管理和更新。

在支持的服务层级中,自承载网关是一个可选的部署选项。

虽然托管网关和自承载网关具有许多共同特征,但两者也存在一些差异

职责

下表显示了在管理和支持自承载网关方面 Azure 承担的责任、客户承的担责任以及双方共同的责任。

Azure 共担责任 客户
▪️ 配置终结点(管理平面)- 自承载网关依赖于提供配置、API、主机名和策略信息的配置终结点。 此配置终结点是每个 API 管理服务的管理平面的一部分。

▪️ 网关容器映像维护和更新 - 自承载网关容器映像中的 bug 修复、修补程序、性能改进和新功能。
保护自承载网关与配置终结点的通信 - 可以通过两种机制来保护自承载网关与配置终结点之间的通信:使用每过 30 天自动过期并且需要为正在运行的容器更新的访问令牌;或使用 Microsoft Entra ID 进行身份验证,这样就不需要刷新令牌。

▪ 使网关保持最新状态 - 客户监督定期将网关更新到最新版本和最新功能的工作。 Microsoft 将提供包含新功能、bug 修复和修补程序的更新映像。
▪ 网关托管 - 部署和操作网关基础结构:包含容器运行时的虚拟机和/或 Kubernetes 群集。

▪ 网络配置 - 需要通过此类任务来维护管理平面连接和 API 访问权限。

▪ 网关 SLA - 容量管理、缩放和运行时间。

▪ 为支持工作提供诊断数据 - 收集诊断数据并将其与支持工程师共享。

▪ 第三方 OSS(开源软件)软件组件 - 客户负责将自承载网关与其他软件(例如 Prometheus、Grafana、服务网格、容器运行时、Kubernetes 分发和代理)相结合。

自承载网关容器映像的支持覆盖范围

我们根据主要版本、次要版本和修补程序约定,为自承载网关容器映像制定了以下标记策略:{major}.{minor}.{patch}。 可以查找可用标记的完整列表。 作为最佳做法,我们建议客户运行最新稳定版的容器映像。 随着容器映像的持续发布,我们将为以下版本提供官方支持:

支持的版本

  • 最后一个主要版本和最后三个次要版本

    例如,如果最新版本是 2.2.0,则我们将为所有次要版本(2.2.x、2.1.x 和 2.0.x)提供支持。 对于所有以前的版本,我们会要求你更新到受支持的版本。

  • 修复项

    如果我们在受支持的版本中发现 bug、CVE 或性能问题 – 例如,在容器映像 2.0.0 中发现 bug – 则会在最新次要版本(例如 2.2.x)中以修补程序的形式推出修复。

不支持的版本

  • 带有 beta 标记的容器映像。

  • 任何带有 preview 后缀的版本。

自承载网关支持方案

Azure 提供以下示例的技术支持

  • 受支持层的配置终结点和管理平面运行时间与配置。

  • 自承载网关容器映像 bug、性能问题和改进。

  • 将尽快修复自承载网关容器映像安全修补程序 (CVE)。

  • 支持的第三方开源项目,例如:Open Telemetry 和 DAPR(分布式应用程序运行时)。

Azure 不提供以下示例的技术支持

  • 有关如何在 Kubernetes 中使用自承载网关的问题。 例如,对于如何创建自定义入口控制器、服务网格、如何使用应用程序工作负载,或者如何应用第三方的或开源的软件包或工具,Microsoft 支持部门不提供建议。

  • 与自承载网关结合使用的第三方开源项目(特定的受支持项目除外),例如:Open Telemetry 和 DAPR(分布式应用程序运行时)。

  • 第三方闭源软件,包括安全扫描工具和网络设备或软件。

  • 排查网络自定义、CNI、服务网格、网络策略、防火墙和复杂网络线路的问题。 Microsoft 只会检查自承载网关与配置终结点之间的通信是否正常。

Bug 和问题

如有支持计划并需要技术帮助,请创建支持请求

  1. 对于“问题类型”,选择“技术” 。

  2. 对于“订阅”,请选择自己的订阅。

  3. 为“服务”选择“我的服务”,然后选择“API 管理服务”。

  4. 对于“资源”,请选择要为其创建支持请求的 Azure 资源。

  5. 对于“问题类型”,请选择“自承载网关”。

也可以从我们的社区获取帮助。 可以在 GitHub 上提交问题,并使用“azure-api-management”标记问题。

后续步骤