Role 目录结构解析
tasks、handlers、templates、defaults、vars
Role 目录结构解析 是 CoddyKit 上的免费 Ansible Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Ansible Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Ansible Academy 课程共包含 4 节课。
角色是一棵文件夹树
角色其实就是一个包含固定子文件夹的目录。Ansible 通过名称识别每个文件夹，并自动加载其中的内容。
roles/
nginx/
tasks/
handlers/
templates/tasks/main.yml 是入口
tasks/main.yml文件包含角色的主要任务列表。应用角色时，Ansible 首先执行这个文件。
tasks/main.yml:
- name: Install nginx
ansible.builtin.package:
name: nginxhandlers/ 保存重启逻辑
handlers文件夹定义重启服务之类的操作。任务会通知这些处理程序，因此只有发生更改时才会重启。
templates/ 用于存放 Jinja2 文件
将您的.j2模板文件放入 templates/。模板模块会按名称在其中查找文件，无需提供完整路径。
templates/
nginx.conf.j2files/ 用于存放静态文件
files文件夹用于存放需要原样复制的普通文件。copy 模块会像查找模板一样自动定位这些文件。
defaults/ 设置低优先级变量
defaults/main.yml文件包含优先级最低的变量，因此用户可以轻松地从角色外部覆盖它们。
defaults/main.yml:
nginx_port: 80vars/ 设置高优先级变量
vars/main.yml文件包含优先级更高的变量。对于角色所依赖且很少需要更改的值，请使用此文件。
meta/main.yml 描述角色
meta/main.yml文件列出角色的作者、许可证、支持的平台以及角色依赖项。
main.yml 是约定的文件名
在 tasks、handlers、vars 和 defaults 文件夹中，Ansible 会自动加载名为main.yml的文件。这种命名约定将整个结构串联起来。
只需保留实际使用的内容
角色不必包含每个文件夹。如果没有模板，只需跳过 templates 目录即可。Ansible 会忽略缺失的可选文件夹。
tests/ 和 README 让角色更完善
成熟的角色会添加README和 tests 文件夹，让其他人在使用您的自动化内容之前能够理解并验证它。
快速检查
请回忆角色的主要任务列表存放在哪里。
回顾
角色是一棵文件夹树，tasks、handlers、templates、files、defaults、vars 和 meta 各自都有固定位置，而所有内容都以 main.yml 为核心。📁
常见问题解答
「Role 目录结构解析」课时是免费的吗？
是的 — 「Role 目录结构解析」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Ansible Academy 课程的其余内容，请升级到 CoddyKit PRO。 Ansible Academy 课程共包含 4 节课。
「Role 目录结构解析」这节课中我会学到什么？
tasks、handlers、templates、defaults、vars 你通过在浏览器中直接运行的动手代码来练习 Ansible Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Ansible Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Ansible Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「Role 目录结构解析」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Ansible Academy 课中编写并运行代码吗？
能。每节 Ansible Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。