Ansible import_playbook报错及跨主机角色执行问题求助

看起来你在构建一个交互式的恢复Playbook，通过用户输入选择不同的恢复流程，但遇到了import_playbook的使用方式错误。让我帮你梳理问题并给出解决方案：

项目目录结构 #

├── inventories
│   ├── ansible_host
│   └── group_vars
│       ├── all
│       └── vars
├── plays
│   ├── 01_recovery.yml
├── restore_all.yml
└── roles
    ├── 01_recovery_lostMaster
    │   ├── defaults
    │   │   └── main.yml
    │   ├── files
    │   ├── handlers
    │   │   └── main.yml
    │   ├── meta
    │   │   └── main.yml
    │   ├── README.md
    │   ├── tasks
    │   │   └── main.yml
    │   ├── templates
    │   ├── tests
    │   │   ├── inventory
    │   │   └── test.yml
    │   └── vars
    │       └── main.yml
    └── remove_failed_master
        ├── defaults
        │   └── main.yml
        ├── files
        ├── handlers
        │   └── main.yml
        ├── meta
        │   └── main.yml
        ├── README.md
        ├── tasks
        │   └── main.yml
        ├── templates
        ├── tests
        │   ├── inventory
        │   └── test.yml
        └── vars
            └── main.yml

现有Playbook配置 #

父Playbook: restore_all.yml #

- name: Demo of restore plan
  hosts: localhost
  gather_facts: False
  vars_prompt:
    - name: "Action"
      prompt: |
        - Choose Action ?
        - 1] Action 1
        - 2] Action 2
        - Please select anyone action
      private: no
  tasks:
    - name: Action 1 Details
      when: Action == "1"
      import_playbook: plays/01_recovery.yml
    - name: Action 2 Details
      when: Action == "2"
      import_playbook: plays/02_recovery.yml

子Playbook: 01_recovery.yml #

---
- name: Restore role
  hosts: localhost
  roles:
    - { role: restore/roles/01_recovery_lostMaster, tags: ['01_recovery_lostMaster'] }
- name: remove failed master
  hosts: master-01
  become: true
  roles:
    - { role: restore/roles/remove_failed_master, tags: ['remove_failed_master'] }

遇到的错误 #

错误1：import_playbook作为task使用 #

[root@api localhost]# ansible-playbook restore_all.yml -e "host=localhost"
[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'
ERROR! this task 'import_playbook' has extra params, which is only allowed in the following modules: shell, win_shell, include_vars, add_host, raw, include_role, meta, set_fact, include, import_tasks, script, import_role, include_tasks, group_by, command, win_command
错误位置似乎在'/home/ec2-user/restore/restore_all.yml'第20行第7列，但也可能因语法问题出现在其他位置。
问题行似乎是：
- name: Action 1 Details
^ here

错误2：改用import_tasks后的冲突 #

[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'
ERROR! conflicting action statements: hosts, roles

问题根源 #

1. import_playbook是Play级别指令，不能放在tasks块内：它的作用是导入整个Playbook（包含多个Play），而tasks块只能放任务级别的指令（比如shell、copy等模块，或者import_tasks/import_role这类任务级导入）。
2. import_tasks不能包含Play级别的配置：tasks是属于某个Play的，里面不能重新定义hosts、roles这类属于Play的参数，这就是你第二个错误的原因。

解决方案 #

我们需要调整父Playbook的结构，把变量收集和Playbook导入拆分为顶级元素，让import_playbook在正确的位置使用：

修改后的restore_all.yml #

# 第一步：收集用户选择的Action变量，这是一个独立的Play
- name: Get user action selection
  hosts: localhost
  gather_facts: false
  vars_prompt:
    - name: "Action"
      prompt: |
        - Choose Action ?
        - 1] Action 1
        - 2] Action 2
        - Please select anyone action
      private: no

# 第二步：根据Action条件导入对应的子Playbook（顶级指令，不在tasks内）
- import_playbook: plays/01_recovery.yml
  when: Action == "1"

- import_playbook: plays/02_recovery.yml
  when: Action == "2"

额外优化：修正子Playbook的角色路径 #

Ansible默认会在项目根目录的roles文件夹下查找角色，所以你可以简化01_recovery.yml中的角色引用：

---
- name: Restore role
  hosts: localhost
  roles:
    - { role: 01_recovery_lostMaster, tags: ['01_recovery_lostMaster'] }
- name: remove failed master
  hosts: master-01
  become: true
  roles:
    - { role: remove_failed_master, tags: ['remove_failed_master'] }

为什么这样修改？ #

1. 第一个Play专门用来收集用户输入的Action变量，Ansible在同一次Playbook运行中会共享这个变量给后续的Play/导入的Playbook。
2. import_playbook作为Playbook的顶级元素，直接调用子Playbook，每个导入都带有when条件，实现根据用户选择执行对应流程。
3. 简化角色路径后，Ansible会自动在roles目录下查找对应的角色，配置更简洁规范。

现在你可以重新运行ansible-playbook restore_all.yml，按照提示选择Action，就能正常执行对应的恢复流程了。

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