Ansible 核心文档

ansible.builtin.include_tasks 模块 – 动态包含任务列表

注意

此模块是 ansible-core 的一部分，并包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，您也可以使用简短的模块名称 include_tasks。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.include_tasks 以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

概要 

包含一个包含要执行的任务列表的文件，该文件将在当前剧本中执行。

参数 

参数	注释
apply 字符串在 Ansible 2.7 中添加	接受任务关键字的哈希值（例如 `tags`、`become`），这些关键字将应用于包含中的任务。
file 字符串在 Ansible 2.7 中添加	指定包含要添加到当前剧本中的任务列表的文件的名称。
自由格式字符串	直接指定导入的文件的名称，没有任何其他选项 `- include_tasks: file.yml`。等同于为 `file` 参数指定参数。与 ansible.builtin.import_tasks 不同，大多数关键字（包括循环、with_items 和条件语句）都适用于此语句。不支持 do-until 循环。

属性 

属性	支持	描述
action	支持：无虽然此操作在控制器上本地执行，但它不受操作插件控制	表示这有一个相应的操作插件，因此某些选项部分可以在控制器上执行
async	支持：无	支持与 `async` 关键字一起使用
become	支持：无	可与 become 关键字一起使用
bypass_host_loop	支持：无	强制执行不按主机执行的“全局”任务，这将绕过按主机模板化和串行、节流和其他循环考虑因素条件语句将按使用 `run_once` 时的方式工作，使用的变量将来自第一个可用的主机此操作在非锁步策略之外将无法正常工作
bypass_task_loop	支持：无	这些任务会忽略 `loop` 和 `with_` 关键字
check_mode	支持：无	可以在 check_mode 下运行，并返回已更改状态预测而不会修改目标，如果不受支持，则将跳过该操作。
connection	支持：无	使用目标的配置连接信息在目标上执行代码
core	支持：完全支持	这是一项“核心引擎”功能，与大多数任务操作的实现方式不同，因此无法通过插件系统以任何方式覆盖它。
delegation	支持：无由于没有连接或事实，因此没有委托包含的意义	可与 delegate_to 和相关关键字一起使用
diff_mode	支持：无	将在差异模式下返回有关内容已更改（或可能需要更改（在 check_mode 中））的详细信息
ignore_conditional	支持：无	该操作不受条件执行的约束，因此将忽略 `when:` 关键字
platform	平台：全部	可以对其进行操作的目标操作系统/系列
tags	支持：完全支持此操作会解释标签，但不会自动继承包含任务的标签，请参见 `apply`	允许使用“标签”关键字来控制此操作的选择以执行
until	支持：完全支持	表示此操作是否服从 until/retry/poll 关键字

另请参见 

另请参见

ansible.builtin.import_playbook: 导入剧本。
ansible.builtin.import_role: 将角色导入剧本中。
ansible.builtin.import_tasks: 导入任务列表。
ansible.builtin.include_role: 加载并执行角色。
重复使用 Ansible 工件: 有关包含和导入剧本、角色和任务的更多信息。

示例 

- hosts: all
  tasks:
    - ansible.builtin.debug:
        msg: task1

    - name: Include task list in play
      ansible.builtin.include_tasks:
        file: stuff.yaml

    - ansible.builtin.debug:
        msg: task10

- hosts: all
  tasks:
    - ansible.builtin.debug:
        msg: task1

    - name: Include task list in play only if the condition is true
      ansible.builtin.include_tasks: "{{ hostvar }}.yaml"
      when: hostvar is defined

- name: Apply tags to tasks within included file
  ansible.builtin.include_tasks:
    file: install.yml
    apply:
      tags:
        - install
  tags:
    - always

- name: Apply tags to tasks within included file when using free-form
  ansible.builtin.include_tasks: install.yml
  args:
    apply:
      tags:
        - install
  tags:
    - always

作者

Ansible 核心团队 (@ansible)

集合链接