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

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

AWS SDKs 和工具维护政策

概览

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

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

版本控制

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

SDK 主要版本生命周期

主要版本 SDKs 和工具版本的生命周期包括5个阶段,概述如下。

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

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

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

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

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

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

维护政策时间表

依赖生命周期

大多数 AWS SDKs 都有底层依赖关系,例如语言运行时、操作系统或第三方库和框架。这些依赖项通常与语言社区或拥有该特定组件的供应商有关。每个社区或供应商都会发布自己的产品 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 依赖项。但是,此策略可能会因具体的依赖项而有所不同。

注意

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

沟通方式

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

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

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

  • 发布了一篇 AWS 博客文章,概述了通往该活动的路径 end-of-support,并重申了竞选时间表。

  • 弃用警告已添加到 SDKs,概述了指向 SDK 文档的路径 end-of-support和链接。

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