0Pricing
Ansible Academy · 课时

运行时的 include_role 与 import_role

在 Play 执行过程中动态调用 Role

运行时的 include_role 与 import_role 是 CoddyKit 上的免费 Ansible Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Ansible Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Ansible Academy 课程共包含 4 节课。

超越 roles 列表

顶层的 roles 列表会在任何任务运行前应用角色。有时您需要在剧本执行过程中、任务所在的确切位置调用角色。

将角色作为任务调用

include_role 和 import_role 都可以让您在 tasks 部分中调用角色，与其他步骤一起按顺序执行。

tasks:
  - import_role:
      name: nginx

import_role 是静态的

import_role 会在剧本解析时处理，即运行开始前。它的任务会较早地内联，因此无法依赖运行时数据。

include_role 是动态的

include_role 会在运行期间、执行到该任务的那一刻处理。它可以根据事实和已注册的结果作出反应。

tasks:
  - include_role:
      name: backup
    when: do_backup

循环运行角色

由于 include_role 是动态运行的，您可以将它放入循环中，并在每次循环中使用不同的变量应用同一个角色。

- include_role:
    name: deploy_app
  loop: "{{ app_list }}"

import_role 不能循环

由于 import_role 在解析时解析，因此不支持 loop。只要需要重复运行角色，就请使用 include_role。

when 的行为差异

在 import_role 上使用 when 时，条件会复制到内部的每个任务上。在 include_role 上使用 when 时，它会控制整个角色这一单元。

两种方式都能传递变量

两种形式都接受 vars 来参数化角色，就像 roles 列表一样。这些值会直接传入被包含的角色。

- include_role:
    name: web
  vars:
    http_port: 8080

标签与静态和动态方式

使用 import_role 时，被导入任务上的标签会显示在 --list-tags 中。使用 include_role 时，您必须将标签应用到 include 本身。

选择合适的工具

对于可预测、始终运行的结构，请使用 import_role。当角色必须有条件地运行或处于循环中时，请使用 include_role。

同一模式，两个层级

Ansible 对任务文件也提供相同的静态与动态划分：import_tasks 和 include_tasks 与这些角色关键字完全对应。

快速检查

回想一下，哪个关键字可以在循环中应用角色。

回顾

使用 import_role 实现静态的解析时结构，使用 include_role 实现带有循环和条件的动态运行时调用。🔁

常见问题解答

「运行时的 include_role 与 import_role」课时是免费的吗？

是的 — 「运行时的 include_role 与 import_role」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Ansible Academy 课程的其余内容，请升级到 CoddyKit PRO。 Ansible Academy 课程共包含 4 节课。

「运行时的 include_role 与 import_role」这节课中我会学到什么？

在 Play 执行过程中动态调用 Role 你通过在浏览器中直接运行的动手代码来练习 Ansible Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Ansible Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Ansible Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。

「运行时的 include_role 与 import_role」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Ansible Academy 课中编写并运行代码吗？

能。每节 Ansible Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. meta/main.yml 中的 Role 依赖
  2. defaults 与 vars：覆盖顺序
  3. 运行时的 include_role 与 import_role
  4. allow_duplicates 与 Role 幂等性
← 返回 Ansible Academy