开发者指南
注意
让开源更具包容性
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。 我们从这四个术语开始:master、slave、blacklist 和 whitelist。 如果您发现我们遗漏的术语,我们要求您打开一个问题或拉取请求。 有关更多详细信息,请参阅我们 CTO Chris Wright 的消息。
欢迎使用 Ansible 开发者指南!
谁应该使用本指南?
如果您想通过在本地使用自定义模块或插件、创建模块或插件、向现有模块添加功能或扩展测试覆盖率来扩展 Ansible,本指南适合您。 我们为开发人员提供了有关如何测试和记录模块的详细信息,以及将您的模块或插件接受到 Ansible 主存储库中的先决条件。
找到最能描述您想做的事情的任务
我正在寻找一种解决用例的方法
我想弄清楚开发模块是否是我的用例的正确方法。
我想了解一个成功的集合创建者路径是什么样的。
我想开发一个集合。
我想为社区维护的集合做出贡献。
我想将角色迁移到集合。
我已阅读以上信息,并且我确信自己想开发一个模块
在开始编码之前,我需要了解什么?
我想开始编写模块。
- 我想编写一种特定类型的模块
oVirt/RHV 模块。
我想编写一系列相关的模块,将 Ansible 与新产品(例如,数据库、云提供商、网络平台等)集成。
我想改进我的代码
我想调试我的模块代码。
我想添加测试。
我想记录我的模块。
我想为网络平台记录我的模块集。
我想遵循关于简洁、可用的模块代码的约定和提示。
我想处理其他开发项目
我想为 Ansible 项目做出贡献
我想贡献我的模块或插件。
我想了解 DCO 协议,以便为 Ansible Core 和 Ansible 文档存储库做出贡献。
如果您想阅读整个指南,下面是按顺序列出的页面列表。