AMP

AMP 发布时间表

AMP 的新版本每周二会推送到所有 AMP 页面。一旦 AMP 中的更改合并到 amphtml 存储库的主分支中,通常需要 1-2 周的时间才能使该更改对所有用户生效。

AMPHTML 验证器有其自己的发布时间表

发布渠道

AMP 运行时和扩展通过各种不同的发布渠道提供。每个渠道都为开发者和 AMP HTML 项目本身服务。有关来自 ampproject/amphtml 存储库的代码如何以及何时进入发布版本的更详细分解,请参阅发布节奏部分

要确定 PR 是否已包含在以下任何发布渠道中,请查找 GitHub 标签 PR Use: In CanaryPR Use: In ProductionPR Use: In LTS(有关更多详细信息,请参阅关于确定你的更改是否在版本中的部分)。

每日构建版

每日构建版发布渠道(顾名思义)每个工作日的晚上都会更新。此过程是自动化的,并且不能保证任何给定的每日构建版本没有错误或其他问题。每天午夜(太平洋时间)之后,会选择当天最后一个“绿色”提交作为发布截止点。绿色构建表示所有自动化测试均已通过该构建。

每日构建版提供了一种快速检测和解决问题,并使其在到达流量更大的每周发布渠道之前得到解决的机制。它还有助于减少受新引入的问题影响的用户数量。

可以加入每日构建版渠道,以测试在过去几天合并的拉取请求。有关详细信息,请参阅 [developing.md] 中的加入部分

每周构建版

每周发布渠道被认为是主要的“常青”发布渠道。每周,前一周的 beta 版本都会被提升为 stable 发布渠道,而前一周的最后一个每日构建版版本会被提升为 experimentalbeta 发布渠道(请参阅详细时间表)。

在创建发布版本时,使用了两组构建配置:canary 配置和 production 配置。experimentalbeta 发布渠道是基于相同的提交构建的。但是,experimental 渠道使用 canary 配置,而 beta 渠道使用 production 配置。canary 配置启用在 production 中可能关闭的实验性组件和功能。可以通过实验页面加入 experimentalbeta 渠道。

stable 发布渠道使用 production 配置构建,并为大多数 AMP 流量提供服务。由于 beta 发布渠道也是使用 production 配置构建的,因此它代表了下周将成为 stable 的确切构建版本(可能会进行 cherry-pick 以修复最后一分钟的问题;请参阅贡献代码)。

Beta 和实验性渠道

Beta实验性渠道是 AMP 下一个稳定版本的预发布候选版本。每个星期二(除了有发布冻结期的周),上周的每日构建版会被提升为开发者可选加入的 betaexperimental 渠道。在 1 天的时间内,我们会验证这些渠道中是否没有引入功能或性能回归,然后在周三将此版本提升到一小部分流量。然后在下周二,将同一版本提升到 stable 渠道。

可以加入这些渠道。有关详细信息,请参阅 [developing.md] 中的加入部分

加入Beta 渠道的目的是

  • 测试和体验即将发布的 AMP 运行时版本
  • 在质量保证 (QA) 中使用,以确保你的网站与下一个版本的 AMP 兼容

实验性渠道的目的是

  • 测试和体验尚未向所有用户提供的新功能
  • 在质量保证 (QA) 中使用,以确保你的网站与 AMP 的即将推出的仍在开发中的功能兼容

实验性渠道可能不太稳定,并且可能包含尚未向所有用户提供的功能。

长期稳定版 (lts)

lts 发布渠道提供先前 stable 版本的构建,时间间隔为一个月。在每个月的第二个星期一,当前 stable 版本会提升为 lts。不建议所有 AMP 发布商使用此渠道。它提供给希望以较低频率在其网站上执行 QA 周期的发布商,他们可以通过将特定网页加入 lts 渠道来实现(请参阅lts 自述文件)。

如果该月的第二个星期一恰逢节假日,则将在发布冻结期结束后执行升级。

使用 lts 发布渠道的发布商不应使用新引入的功能。由于周期较长,lts 版本可能会比 ampproject/amphtmlHEAD 版本落后七周之多。请参阅关于确定你的更改是否在版本中的部分,以验证更改是否已准备好使用你选择的发布周期。

确定你的更改是否在版本中

使用 Type: Release GitHub 问题来跟踪当前和过去版本的状态;从初始切割到通过 experimental/beta 渠道进行测试,再到最终通过 stablelts 渠道进行发布。关于发布的公告会在 AMP Slack #release 渠道上发布(注册 Slack)。

你可以使用以下方法之一确定给定版本中有哪些更改

发布节奏

我们有意对发布节奏保持谨慎。

在确定应以多高的频率向所有人推送新版本的 AMP 时,我们必须权衡许多因素,包括

  • 使用 AMP 构建的数百万个网站/数十亿个页面的稳定性
  • 当我们推送新版本时可能发生的缓存清除
  • 快速推出新功能的愿望

在考虑所有这些因素后,我们采用了 1-2 周的推送周期。到目前为止,我们发现这是一个合理的折衷方案,但我们将继续评估所有这些因素,并且将来可能会进行更改。

详细时间表

我们尽量坚持此时间表,但复杂情况可能会导致延迟。你可以在Type: Release GitHub 问题AMP Slack #release 渠道注册 Slack)中跟踪有关任何发布的最新状态。

  • 每个工作日的晚上:会自动切割并向AMP 每日构建版渠道发布一个新的 每日构建版版本。
  • 周二 @ 太平洋时间上午 11 点:从最近已知的良好每日构建版渠道版本创建新的 experimentalbeta 版本,并将其提供给选择加入AMP 实验性渠道AMP Beta 渠道的用户。
  • 周三:我们会检查 Experimental 渠道Beta 渠道用户的错误报告,如果一切正常,我们会将 beta 推送到 1% 的 AMP 页面
  • 周四至周一:我们会继续监控 Experimental 渠道Beta 渠道用户以及使用 experimental/beta 版本构建的 1% 页面的错误率和错误报告
  • 下周二:beta 版本完全提升为 stable 版本(即,所有 AMP 页面现在都将使用此版本)

发布冻结期

有时,我们会跳过 AMP 向生产环境的发布,这被称为发布冻结。

如果宣布第 N 周进行为期一周的发布冻结

  • 那么前一周的稳定版发布将额外保留一周,即在第 N 周不会像通常那样将新版本升级为稳定版
  • 但是,新的 beta 版和实验性版本将在冻结周(第 N 周)创建。
  • 正常计划将在第 N+1 周恢复,即第 N 周的实验性/beta 版将在第 N+1 周升级为稳定版。此外,新的实验性/beta 版将在第 N+1 周创建,并在第 N+2 周升级为稳定版
  • 如果在第 N-1 周升级的稳定版最初计划在第 N 周升级为 lts 版,那么它现在将在第 N+1 周的星期一升级为 lts 版。
  • nightly 版本仍会生成和升级,因为它们是完全自动化的。

发布冻结可能发生在以下情况:

  • 当没有足够的人员可以将 AMP 版本推送到稳定版并进行监控时。目前,大多数执行 AMP 发布的人员都位于美国,因此这通常是美国主要节假日(如独立日(7 月 4 日)、感恩节(11 月的第四个星期四)、圣诞节(12 月 25 日)和新年除夕/元旦(12 月 31 日/1 月 1 日))所在的周。
  • 紧急情况,例如由技术指导委员会 (TSC) 或执行发布的人员确定的安全或隐私问题。
  • 由 TSC 确定的,代码库的稳定性被认为特别重要的其他情况。

在所有情况下(紧急情况除外),发布冻结将至少提前一个月宣布。

请注意,除非另行宣布,否则发布冻结并不意味着代码冻结。在发布冻结期间,仍然可以编写、审查和合并代码。