本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon SDK 和工具维护策略
概述
本文档概述了 Amazon 软件开发工具包(SDK)和工具(包括移动和物联网 SDK)的维护政策及其基础依赖关系。Amazon 定期向 Amazon SDK 和工具提供更新,其中可能包含对新增或更新的 Amazon API、新功能、增强功能、错误修复、安全补丁或文档更新的支持。更新还可以解决依赖关系、语言运行时系统和操作系统的变化。AmazonSDK 版本发布给包管理器(例如 Maven NuGet、、PyPI),并作为源代码提供。 GitHub
我们建议用户继续 up-to-date 使用 SDK 版本,以了解最新功能、安全更新和底层依赖关系。不建议继续使用不受支持的 SDK 版本,但是否继续使用由用户自行决定。
版本控制
Amazon SDK 发布版本采用 X.Y.Z 的形式,其中 X 代表主要版本。增加 SDK 的主版本表明该 SDK 进行了重大而实质性的更改,以支持该语言中的新习语和模式。当公共接口(例如类、方法、类型等)、行为或语义发生变化时,就会引入主要版本。应用程序需要更新才能使用最新的 SDK 版本。请务必根据 Amazon 提供的升级指南谨慎更新主要版本。
SDK 主要版本生命周期
主要 SDK 和 Tools 版本的生命周期由 5 个阶段组成,概述如下。
-
开发者预览版(第 0 阶段)- 在此阶段,不支持 SDK,不应在生产环境中使用,并且仅用于抢先体验和反馈目的。未来版本可能会引入重大变更。一旦 Amazon 确定某个版本为稳定产品,它就可以将其标记为候选版本。除非出现重大错误,否则候选版本已准备好发布,并且将获得全力 Amazon 支持。
-
正式发布 (GA)(第 1 阶段)- 在此阶段,完全支持 SDK。 Amazon 将提供常规的 SDK 版本,其中包括对新服务的支持、现有服务的 API 更新以及错误和安全修复。对于工具,Amazon 将提供包含新功能更新和错误修复的常规版本。 Amazon 将支持 GA 版本的 SDK 至少 24 个月。
-
维护公告(第 2 阶段)- Amazon 将在 SDK 进入维护模式前至少 6 个月发布公告。在此期间,SDK 将继续得到全面支持。通常,维护模式是在下一个主要版本过渡到 GA 的同时宣布的。
-
维护(第 3 阶段)- 在维护模式期间,Amazon 将 SDK 版本限制为仅解决关键错误修复和安全问题。SDK 不会收到新服务或现有服务的 API 更新,也不会更新以支持新区域。除非另有说明,否则维护模式的默认持续时间为 12 个月。
-
支持终止(第 4 阶段)- 当 SDK 达到支持终止时,它将不再接收更新或版本。之前发布的版本将继续通过公共包管理器提供,并且代码将保持不变 GitHub。 GitHub 存储库可能已存档。用户可以自行决定 end-of-support 是否使用已到达的 SDK。我们建议用户升级到新的主要版本。
以下是 SDK 主要版本生命周期的直观说明。请注意,下面显示的时间表仅供参考,不具约束力。
依赖生命周期
大多数 Amazon SDK 都有基础依赖关系,例如语言运行时系统、操作系统或第三方库和框架。这些依赖关系通常与语言社区或拥有该特定组件的供应商有关。每个社区或供应商都会发布自己的产品 end-of-support 时间表。
以下术语用于对基础第三方依赖关系进行分类:
-
操作系统 (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 依赖关系。但是,此策略可能会因具体的依赖关系而有所不同。
注意
Amazon 保留在不增加主要 SDK 版本的情况下停止支持基础依赖关系的权利
沟通方式
维护公告将通过多种方式传达:
-
我们会向受影响的账户发送一封电子邮件公告,宣布我们计划终止对特定 SDK 版本的支持。该电子邮件将概述通往的路径 end-of-support,指定活动时间表,并提供升级指导。
-
AmazonSDK 文档(例如 API 参考文档、用户指南、SDK 产品营销页面和 GitHub 自述文件)已更新,以指明活动时间表并提供有关升级受影响应用程序的指导。
-
发布了一篇Amazon博客文章,概述了通往该活动的路径 end-of-support,并重申了竞选时间表。
-
弃用警告已添加到 SDK 中,概述了 SDK 文档的路径 end-of-support 和链接。
要查看软件开发工具包和Amazon工具的可用主要版本列表以及它们在维护生命周期中所处的位置,请参阅Amazon SDK 和工具版本支持矩阵。