我来帮你搞定这个Ansible的问题～先从你遇到的报错说起，再给你推荐更高效的统一管理方案。

1. 报错原因分析 #

你碰到的ERROR! included task files must contain a list of tasks错误，主要有两个核心原因：

• 你误用了tasks关键字来导入预任务，Ansible有专门的pre_tasks字段来定义主任务/角色执行前的操作；
• 你的pre_tasks.yml文件格式可能不符合要求——它必须是任务列表格式（每个任务以-开头），不能是单个任务的零散配置。

2. 正确导入pre_tasks的写法 #

方法一：用pre_tasks关键字规范导入 #

这是最标准的写法，直接把预任务的导入逻辑放在pre_tasks块下，和主任务、角色区分开：

---
- hosts: central
  pre_tasks:
    - import_tasks: pre_tasks.yml  # 直接导入预任务列表
  roles:
    - do_something
  become: no

同时要确保pre_tasks.yml是正确的任务列表格式，比如：

# pre_tasks.yml 示例格式
- name: 检查磁盘空间
  command: df -h /

- name: 打印预任务完成提示
  debug:
    msg: "预检查完成，即将执行主任务"

方法二：如果非要在普通tasks里导入（不推荐） #

如果你有特殊需求要把预任务放在普通tasks里，只要保证import_tasks直接作为tasks的一项，且pre_tasks.yml是合法的任务列表即可：

---
- hosts: central
  tasks:
    - import_tasks: pre_tasks.yml  # 直接导入，不要额外嵌套
    # 其他普通业务任务
  roles:
    - do_something
  become: no

3. 更好的多Playbook统一管理预/后任务方案 #

如果要给多个Playbook批量应用相同的pre_tasks/post_tasks，推荐以下几种高效方式：

方式一：创建基础Playbook模板 #

写一个包含通用预/后任务的基础Playbook（比如base_playbook.yml），其他业务Playbook通过import_playbook导入它，同时传入自己的主机和角色配置：

# base_playbook.yml
---
- hosts: "{{ target_hosts }}"
  pre_tasks:
    - import_tasks: pre_tasks.yml
  post_tasks:
    - import_tasks: post_tasks.yml
  become: no

业务Playbook可以这样复用：

# business_playbook.yml
---
- import_playbook: base_playbook.yml
  vars:
    target_hosts: central  # 指定当前Playbook的目标主机
  roles:
    - do_something

方式二：通过ansible.cfg全局配置 #

在ansible.cfg里设置全局默认的预/后任务，所有Playbook会自动执行这些操作，无需逐个编写：

[defaults]
# 全局预任务文件路径
default_pre_tasks = ./pre_tasks.yml
# 全局后任务文件路径
default_post_tasks = ./post_tasks.yml

如果某个Playbook不需要执行全局预/后任务，可以在Playbook里显式覆盖：

---
- hosts: central
  pre_tasks: []  # 禁用全局预任务
  post_tasks: [] # 禁用全局后任务
  roles:
    - do_something

方式三：使用角色依赖 #

创建一个包含通用预/后任务的基础角色，让所有业务角色依赖它。比如创建roles/base/tasks/main.yml：

# roles/base/tasks/main.yml
- import_tasks: ../pre_tasks.yml
- import_tasks: ../post_tasks.yml

然后在业务角色的meta/main.yml中添加依赖：

# roles/do_something/meta/main.yml
dependencies:
  - role: base

这样执行do_something角色时，会自动先执行基础角色的预/后任务。

内容的提问来源于stack exchange，提问作者huhushow