Amazon SDK 和工具维护策略 - Amazon 软件开发工具包和工具
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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 和工具版本支持矩阵