何时构建自定义模块
识别现有模块留下的空缺
何时构建自定义模块 是 CoddyKit 上的免费 DevOps Bootcamp 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 DevOps Bootcamp 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。
内置模块不够用时
Ansible 自带数千个模块，但有时没有一个能满足您的需求。这正是自定义模块发挥作用的时候。
构建前先搜索
请始终先检查 Galaxy 和文档。社区集合通常已经封装了那个不常见的 API，因此您无需编写任何代码。
shell 模块暴露问题
如果您的剧本充斥着 command 和 shell 调用，并且还要解析输出，这就是一个信号。模块可以用简洁的参数隐藏这些混乱细节。
ansible.builtin.command: myapp create --name webshell 无法提供的幂等性
原始 shell 任务每次运行都会报告 changed。真正的模块会先检查当前状态，从而提供 shell 永远无法提供的幂等性。
封装自定义 API
您可能运行着尚未有对应模块的内部工具或 REST API。自定义模块可以将该集成转换为一个整洁、可复用的任务。
模块在目标主机上运行
请记住，模块会在受管节点上执行，而不是在控制机器上执行。因此，远程主机上必须存在它所需的 Python 和库。
过滤器与插件有区别
并非每个需求缺口都需要模块。在模板中转换数据属于过滤器插件的工作，而模块会在主机上执行实际操作。
模块应放在哪里
将单个文件放入 playbook 旁边的 library 文件夹中，Ansible 就会自动找到它。开始时无需打包。
myproject/
library/
my_module.py
playbook.ymlPython 是默认选择
大多数模块都使用 Python 编写，因为 Ansible 为它提供了辅助库。其他语言也可以使用，但无法获得这项支持。
让模块专注于一件事
与内置模块一样，您的模块也应当出色地完成一项工作。请避免将五个无关的操作塞进一个庞大的文件中。
模块契约
每个模块都遵循一个契约：接收 JSON 参数，执行工作，然后返回 JSON 结果。掌握这一点后，您就可以构建任何模块。
快速检查
请思考一下，什么情况才真正值得您编写自己的模块。
回顾
只有在完成搜索后、确实需要 shell 和内置模块无法提供的幂等且可复用的功能时，才构建自定义模块。请让它专注于一项工作。🛠️
常见问题解答
「何时构建自定义模块」课时是免费的吗？
是的 — 「何时构建自定义模块」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 DevOps Bootcamp 课程的其余内容，请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。
「何时构建自定义模块」这节课中我会学到什么？
识别现有模块留下的空缺 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 DevOps Bootcamp 需要有经验吗？
无需任何先前经验。CoddyKit 上的 DevOps Bootcamp 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「何时构建自定义模块」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 DevOps Bootcamp 课中编写并运行代码吗？
能。每节 DevOps Bootcamp 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。