使用 ansible-galaxy init 创建 Role 框架
生成标准的 Role 骨架
使用 ansible-galaxy init 创建 Role 框架 是 CoddyKit 上的免费 Ansible Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Ansible Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Ansible Academy 课程共包含 4 节课。
不要手动创建
您可以手动创建每个角色文件夹，但 Ansible 提供了一个命令，可以一步生成完整的结构。
ansible-galaxy init
ansible-galaxy init命令会生成一个完整、可以直接填充内容的角色骨架，其中包含所有标准目录。
ansible-galaxy init nginx清晰地命名角色
您传入的参数会成为角色的文件夹名称。请选择具有描述性的名称，例如 webserver 或 postgres，让角色的用途一目了然。
会创建哪些内容
该命令会创建 tasks、handlers、templates、files、vars、defaults、meta 和 tests 文件夹，并在每个文件夹中放置一个可供编辑的初始main.yml。
nginx/
tasks/main.yml
handlers/main.yml
defaults/main.yml
meta/main.yml在 roles/ 中运行
请从项目的roles目录运行该命令，这样新角色就会生成在剧本预期的位置。
cd roles
ansible-galaxy init webserver初始文件只是空的占位文件
每个生成的main.yml几乎都是空的，只有一个注释标题。真正的任务和变量需要由您自行填写。
meta 会预先填充内容
meta/main.yml占位文件包含作者、许可证和平台的占位信息。分享角色之前，请先更新这些内容。
其中包含 README
生成的骨架还会放入一个README.md模板，提醒您记录角色的功能以及它接受的变量。
使用自定义路径
传入--init-path可以将角色创建到当前文件夹以外的位置。当角色存放在专用目录中时，这个选项非常方便。
ansible-galaxy init nginx --init-path roles/保持团队统一
由于所有人都使用相同的命令生成骨架，项目中的每个角色都会拥有完全一致且可预期的结构。
然后开始编写任务
角色骨架准备好后，下一步就是编辑tasks/main.yml，定义角色实际要安装或配置的内容。
快速检查
请回忆用于生成新角色骨架的命令。
回顾
运行ansible-galaxy init即可立即生成完整的角色骨架，然后将实际的任务和变量填入占位文件。🛠️
常见问题解答
「使用 ansible-galaxy init 创建 Role 框架」课时是免费的吗？
是的 — 「使用 ansible-galaxy init 创建 Role 框架」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Ansible Academy 课程的其余内容，请升级到 CoddyKit PRO。 Ansible Academy 课程共包含 4 节课。
「使用 ansible-galaxy init 创建 Role 框架」这节课中我会学到什么？
生成标准的 Role 骨架 你通过在浏览器中直接运行的动手代码来练习 Ansible Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Ansible Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Ansible Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「使用 ansible-galaxy init 创建 Role 框架」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Ansible Academy 课中编写并运行代码吗？
能。每节 Ansible Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 为什么需要 Role：从单体到模块
- Role 目录结构解析
- 使用 ansible-galaxy init 创建 Role 框架
- 应用 Role 并传递 Role 变量