AWS SDK 和工具维护政策 - AWS SDK 和工具

AWS SDK 和工具维护政策

概览

本文档概述了 AWS 软件开发工具包(SDK)和工具(包括移动和物联网 SDK)的维护政策及其底层依赖项。AWS 定期向 AWS SDK 和工具提供更新,其中可能包含对新增或更新的 AWS API、新功能、增强功能、错误修复、安全补丁或文档更新的支持。更新还可以解决依赖关系、语言运行时系统和操作系统的变化。AWSSDK 版本发布给程序包管理器(例如 Maven、NuGet、PyPI),并作为源代码在 GitHub 上提供。

我们建议用户及时了解 SDK 版本,以了解其最新功能、安全更新和底层依赖项。不建议继续使用不受支持的 SDK 版本,但是否继续使用由用户自行决定。

版本控制

AWS SDK 发布版本采用 X.Y.Z 的形式,其中 X 代表主要版本。增加 SDK 的主版本表明该 SDK 进行了重大而实质性的更改,以支持该语言中的新习语和模式。当公共接口(例如类、方法、类型等)、行为或语义发生变化时,就会引入主要版本。应用程序需要更新才能使用最新的 SDK 版本。请务必根据 AWS 提供的升级指南谨慎更新主要版本。

SDK 主要版本的生命周期

主要 SDK 和工具版本的生命周期由 5 个阶段组成,概述如下。

  • 开发者预览版(第 0 阶段)- 在此阶段,不支持 SDK,不应在生产环境中使用,并且仅用于抢先体验和反馈目的。未来版本可能会引入重大变更。一旦 AWS 确定某个版本为稳定产品,它就可以将其标记为候选版本。除非出现重大错误,否则候选版本已准备好发布,并且将获得全力 AWS 支持。

  • 正式发布 (GA)(第 1 阶段)- 在此阶段,完全支持 SDK。AWS 将提供常规的 SDK 版本,其中包括对新服务的支持、现有服务的 API 更新以及错误和安全修复。对于工具,AWS 将提供包含新功能更新和错误修复的常规版本。AWS 将支持 GA 版本的 SDK 至少 24 个月

  • 维护公告(第 2 阶段)- AWS 将在 SDK 进入维护模式前至少 6 个月发布公告。在此期间,SDK 将继续得到全面支持。通常,维护模式是在下一个主要版本过渡到 GA 的同时宣布的。

  • 维护(第 3 阶段)- 在维护模式期间,AWS 将 SDK 版本限制为仅解决关键错误修复和安全问题。SDK 不会收到新服务或现有服务的 API 更新,也不会更新以支持新区域。除非另有说明,否则维护模式的默认持续时间为 12 个月

  • 支持终止(第 4 阶段)- 当 SDK 达到支持终止时,它将不再接收更新或版本。之前发布的版本将继续通过公共程序包管理器提供,并且代码将保留在 GitHub 上。GitHub 存储库可能已存档。用户可自行决定是否使用已终止支持的 SDK。我们建议用户升级到新的主要版本。

下图直观地说明了 SDK 主要版本的生命周期。请注意,下面显示的时间表仅供参考,不具约束力。

维护政策时间表

依赖项生命周期

大多数 AWS SDK 都有底层依赖项,例如语言运行时系统、操作系统或第三方库和框架。这些依赖项通常与语言社区或拥有该特定组件的供应商有关。每个社区或供应商都会发布自己的产品终止支持时间表。

以下术语用于对底层第三方依赖项进行分类:

  • 操作系统 (OS):示例包括 Amazon Linux AMI、Amazon Linux 2、Windows 2008、Windows 2012、Windows 2016 等。

  • 语言运行时系统:示例包括 Java 7、Java 8、Java 11、.NET Core、.NET Standard、.NET PCL 等。

  • 第三方库/框架:示例包括 OpenSSL、.NET Framework 4.5、Java EE 等。

我们的政策是在社区或供应商终止对 SDK 依赖项的支持后至少 6 个月内继续支持 SDK 依赖项。但是,此策略可能会因具体的依赖项而有所不同。

注意

AWS 保留在不增加主要 SDK 版本的情况下停止支持底层依赖项的权利

沟通方式

维护公告将通过多种方式传达:

  • 我们会向受影响的账户发送一封电子邮件公告,宣布我们计划终止对特定 SDK 版本的支持。该电子邮件将概述终止支持的路径,指定活动时间表,并提供升级指导。

  • AWS SDK 文档(例如 API 参考文档、用户指南、SDK 产品营销页面和 GitHub 自述文件)已更新,以指明活动时间表并提供有关升级受影响应用程序的指导。

  • 发布了一篇 AWS 博客文章,概述了终止支持的路径,并重申了活动时间表。

  • 在 SDK 中添加了弃用警告,概述了终止支持的路径并链接到 SDK 文档。

要查看 AWS SDK 和工具的可用主要版本列表以及它们在其维护生命周期中所处的位置,请参阅 AWS SDK 和工具的版本生命周期