Ansible中import_playbook不支持循环，如何基于CSV批量运行主剧本

核心原因说明 #

import_playbook属于Ansible的静态导入指令，会在Playbook解析预处理阶段就完成导入操作，此时变量、循环逻辑都还未加载执行，因此天生不支持loop参数。

可行解决方案 #

方案1：外层脚本循环调用（改造成本最低，无需修改现有主剧本）

不需要调整已经编写完成的main.yml主剧本，直接通过Shell/Python脚本读取CSV文件，逐行提取自定义变量后，通过ansible-playbook的-e参数传入变量执行即可，天然支持串行执行。
示例Shell脚本（假设CSV文件为apps.csv，表头为app_name,env,deploy_version）：

#!/bin/bash
# 跳过CSV表头逐行读取参数
tail -n +2 apps.csv | while IFS=, read -r app_name env deploy_version
do
  ansible-playbook main.yml \
    -e "app_name=${app_name}" \
    -e "deploy_env=${env}" \
    -e "version=${deploy_version}"
  # 可根据返回值判断是否中止后续部署
  if [ $? -ne 0 ]; then
    echo "应用 ${app_name} 部署失败，中止批量任务"
    exit 1
  fi
done

方案2：重构为任务/角色，Ansible内循环执行

如果希望所有逻辑都收敛到Ansible体系内，不需要依赖外部脚本，可以将现有主剧本中的各Play逻辑封装为统一的可复用角色/任务文件，结合CSV读取模块在任务级别循环执行：

1. 将原有main.yml中不同主机的部署逻辑封装为总角色，比如命名为complex_app_deploy，内部通过delegate_to或主机组匹配指定执行节点
2. 编写入口Playbook读取CSV并循环执行部署：

- name: 批量部署多套应用
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 读取应用配置CSV
      community.general.read_csv:
        path: ./apps.csv
      register: app_config_list

    - name: 串行执行单套应用部署
      include_role:
        name: complex_app_deploy
      loop: "{{ app_config_list.list }}"
      loop_control:
        loop_var: current_app
        throttle: 1 # 强制单并发，保证严格串行
      vars:
        # 将CSV行参数传递给部署角色
        app_name: "{{ current_app.app_name }}"
        deploy_env: "{{ current_app.env }}"
        app_version: "{{ current_app.deploy_version }}"

方案3：使用ansible-runner可编程调用

如果需要更复杂的流程控制（比如部署后自动校验、失败重试、多环境依赖判断），可以使用ansible-runner Python库，在Python代码中读取CSV后循环触发Playbook执行，还可以获取每次执行的日志、返回码做自定义处理。

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