回退和 Ansible 包含

每个集合社区可以为管理拉取请求、错误报告、文档问题和功能请求以及添加和替换维护者设置自己的规则和工作流程。维护者根据以下内容审查和合并拉取请求：

可以有两种维护者：集合维护者 和 模块维护者。

集合维护者

集合范围的维护者是具有集合中 write 或更高访问级别的贡献者。他们拥有提交权限，并且可以合并拉取请求，以及其他权限。

当集合维护者认为对文件的贡献足够重要（例如，修复复杂的错误、添加功能、提供定期审查等）时，他们可以邀请作者成为模块维护者。

模块维护者

模块范围的维护者存在于具有 集合机器人 的集合中，例如，community.general 和 community.network。

成为模块维护者是成为集合维护者之前的阶段。模块维护者是在 .github/BOTMETA.yml 中列出的贡献者。范围可以是任何文件（例如，模块或插件）、目录或存储库。因为在大多数情况下范围是模块或模块组，所以我们称这些贡献者为模块维护者。当创建与他们维护的文件相关的 issue/pull request 时，集合机器人会通知模块维护者。

模块维护者通过 集合机器人 间接拥有提交权限。当两个模块维护者在更改他们维护的模块的拉取请求上使用关键字 shipit、LGTM 或 +1 进行评论时，集合机器人会自动合并拉取请求。

有关集合机器人及其界面的更多信息，请参阅 集合机器人概述。

发布集合

集合维护者负责发布集合的新版本。通常，发布集合包括以下步骤：

  1. 计划和公告。

  2. 生成更改日志。

  3. 创建发布 Git 标签并推送。

  4. 通过 Zuul 仪表板 在 Ansible Galaxy 上自动发布发布 tarball。

  5. 最终公告。

  6. 可选地，提交请求以将新集合包含到 Ansible 包中。

有关详细信息，请参阅 发布集合。

回退

集合维护者根据集合的 语义版本控制 和发布策略将合并的拉取请求回退到稳定分支。

手动回退过程类似于 ansible-core 回退指南。

为方便起见，可以使用 GitHub 机器人（例如，使用 Patchback 应用）和标签自动执行回退，就像在 community.general 和 community.network 中所做的那样。

将集合包含在 Ansible 中

如果集合未包含在 Ansible 中（未随 Ansible 包一起提供），维护者可以通过在 ansible-collections/ansible-inclusion 存储库 下创建讨论来提交集合以供包含。有关更多信息，请参阅 存储库的自述文件 以及 Ansible 社区包集合要求。

辞去集合维护者职位

时代在变，您继续担任集合维护者的能力也可能发生变化。我们要求您不要默默地辞去职位。

如果您觉得自己没有时间再维护您的集合，您应该：

  • 告知其他维护者。

  • 如果集合位于 ansible-collections 组织下，还应告知相关的 实时聊天、IRC 或矩阵上的 community 聊天频道，或通过电子邮件 [email protected]。

  • 查看集合中的活跃贡献者，在其中寻找新的维护者。与其他维护者或社区团队讨论潜在的候选人。

  • 如果您未能找到替代者，请在集合中创建一个固定 issue，宣布该集合需要新的维护者。

  • 通过 Bullhorn 时事通讯 发布相同的公告。

  • 请留下来讨论其他维护者或社区团队找到的潜在候选人。

请记住，这是一个社区，因此您可以在将来的任何时间回来。