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