为集合贡献

如果你想向现有集合添加功能，修改你正在使用的集合以修复错误，或更改集合中模块的行为，请克隆该集合的 Git 存储库并在分支上进行更改。你可以将对集合的更改与 Ansible 的本地签出（source hacking/env-setup）结合起来。你应该首先检查集合存储库，看看它是否有特定的贡献指南。这些指南通常列在存储库中的 README.md 或 CONTRIBUTING.md 文件中。有关更一般的指南，请参阅 创建你的第一个集合拉取请求，有关测试指南，请参阅 测试 Ansible 和集合。

为集合贡献：community.general

这些说明适用于托管在 ansible_collections GitHub 组织 中的集合。对于其他集合，尤其是那些不在 GitHub 上托管的集合，请检查集合的 README.md 以了解有关为其贡献的信息。

本示例使用 community.general 集合。要为同一个 GitHub 组织中的其他集合贡献，请将文件夹名称 community 和 general 替换为其他集合的命名空间和集合名称。

先决条件

  • 将 ~/dev/ansible/collections/ 包含在 COLLECTIONS_PATHS 中

  • 如果该路径提到了多个目录，请确保搜索路径中没有其他更早的目录包含 community.general 的副本。

创建拉取请求

  • 创建目录 ~/dev/ansible/collections/ansible_collections/community

mkdir -p ~/dev/ansible/collections/ansible_collections/community

cd ~/dev/ansible/collections/ansible_collections/community
git clone git@github.com:ansible-collections/community.general.git general

  • 如果你从分支克隆，请将原始存储库添加为远程 upstream

cd ~/dev/ansible/collections/ansible_collections/community/general
git remote add upstream git@github.com:ansible-collections/community.general.git

  • 创建一个分支并在分支上提交你的更改。

  • 请记住为你的更改添加测试，请参阅 测试集合。

  • 将你的更改推送到集合的分支并创建一个拉取请求。

你可以使用这个 community.general 的签出在剧本和角色中测试你的更改，无论你本地安装了哪个版本的 Ansible，包括 ansible/ansible 的 devel 分支的本地签出。

另请参阅

使用 Ansible 集合

了解如何安装和使用集合。

为 Ansible 维护的集合贡献

为选定集合贡献的指南

邮件列表

开发邮件列表

实时聊天

如何加入 Ansible 聊天频道