发布管理器指南

发布管理器的目的是确保顺利发布。为了实现该目标,他们需要在以下各方之间进行协调

  • Ansible GitHub 存储库 上具有提交权限的开发人员

  • 没有提交权限的贡献者

  • 社区

  • Ansible 文档团队

预发布版本:是什么以及为什么

预发布版本的目的是吸引测试人员。它们为那些不喜欢从源代码控制运行的人提供了一种获取代码早期版本进行测试并向我们提供反馈的方法。为了确保我们获得有关发布的良好反馈,我们需要确保发布中的所有重大更改都放入预发布版本中。测试人员必须有时间在最终发布之前测试这些更改。理想情况下,我们希望预发布版本之间有足够的时间,以便人们安装和测试一个版本一段时间。然后,他们可以花更多时间使用新代码,而不是安装最新版本。

测试人员的合适时间可能约为两周。但是,为了使我们三到四个月的开发周期有效,我们将其压缩到一周;任何少于一周的时间都有可能导致人们花更多的时间安装代码而不是运行代码。但是,如果时间紧迫(发布日期不能拖延),最好发布新更改,而不是为了让人们有时间进行测试而推迟这些更改。人们无法测试未发布的内容,因此我们必须将这些 tarball 发布出去,即使人们觉得他们必须更频繁地安装。

Beta 版本

在 Beta 版本中,我们知道仍然存在错误。我们将继续接受这些错误的修复。尽管我们审查这些修复,但有时它们可能会具有侵入性或可能破坏代码的其他区域。

在 Beta 期间,我们将不再接受功能提交。

候选发布版本

在候选发布版本中,我们已经修复了所有已知的阻碍程序。任何剩余的错误修复都是我们愿意从发布中排除的错误修复。此时,我们需要用户测试来确定是否存在任何其他潜伏的阻碍程序。

阻碍程序通常是指那些会给用户带来重大问题的程序。回归更有可能被认为是阻碍程序,因为它们会破坏当前用户对 Ansible 的使用。

发布管理器将挑选新发布阻碍程序的修复。发布管理器还将选择是否接受代码隔离区域的错误修复,或将其推迟到下一个次要版本。就其本身而言,非阻碍程序不会触发新的发布;如果阻碍程序需要进行新的发布,它们只会进入下一个主要版本。

最后一个 RC 应尽可能接近最终版本。以下内容可能会更改

  • 版本号会自动更改,并且随着从版本中删除预发布标签而有所不同。

  • 如果确实需要,测试和 docs/docsite/ 可能会有所不同,因为它们不会破坏运行时。但是,发布管理器仍然可能会拒绝它们,因为它们有可能在发布过程中导致可见的损坏。

注意

我们要特别强调,代码(在 bin/lib/ansible/setup.py 中)必须相同,除非有特殊情况。如果有特殊情况,发布管理器负责通知想要测试代码的组。

Ansible 发布流程

发布过程保存在 单独的文档 中,以便可以在发布期间轻松更新。如果您需要访问权限来编辑此文档,请要求当前发布管理器之一添加您。