Ansible循环调用角色时如何将返回结果汇总追加到统一列表

最直接的追加收集逻辑 #

实现核心是两个关键步骤：提前初始化全局空列表避免变量未定义错误，通过循环随动的任务钩子，在每轮角色执行完成后把当次产出的清单值拼接进全局列表。
改造后的playbook示例：

---
- name: List images in ACRs
  any_errors_fatal: true
  hosts:
    - localhost
  gather_facts: false

  vars:
    acrs: ["registry1", "registry2"]

  tasks:
    - name: 初始化全局镜像仓库收集列表
      set_fact:
        all_acr_repos: []

    - name: 逐注册表拉取仓库清单
      include_role:
        name: list_docker_image_repos
      vars:
        registry_name: "{{ item }}"
      loop: "{{ acrs }}"
      # 随角色执行逐次触发的追加逻辑
      apply:
        - name: 追加以当次注册表的仓库清单
          # 替换current_registry_repos为角色实际set_fact产出的列表变量名
          set_fact:
            # 如需嵌套结构（每个ACR作为独立子列表）：
            # all_acr_repos: "{{ all_acr_repos + [ {'registry': registry_name, 'repos': current_registry_repos} ] }}"
            # 如需扁平结构（所有仓库字典合并为一个总列表）：
            all_acr_repos: "{{ all_acr_repos + current_registry_repos }}"

实现时的注意点：

• 提前和角色开发侧对齐角色内部set_fact产出的列表变量名，避免因为变量名不匹配导致收集结果为空
• 这种逐次追加的写法完全兼容所有Ansible版本，低版本没有apply关键字时，只需要把角色调用、追加任务放到一个循环块内，执行效果完全一致
• 不推荐使用set_fact的append: yes参数实现列表累加，该参数原生设计是针对字典的键值合并，用在列表场景容易出现非预期的合并结果，直接用列表拼接的写法逻辑更直观、兼容性更好

场景适配的更优实现 #

循环include_role逐次手动追加的方式存在明显短板：循环过程中角色产生的set_fact容易受变量作用域、任务缓存的影响，出现多轮迭代时变量值被覆盖、收集结果和实际执行值不一致的问题，排查成本很高。
更稳定的实现思路是绕过逐次累加的状态依赖，直接通过任务注册机制一次性收集所有迭代的结果：

1. 调整角色内部的实现：把原来在角色内通过set_fact暴露结果的逻辑，改为将拉取到的清单作为任务返回值传递出来，不再强制修改全局变量
2. 给循环调用的角色任务加register，直接把每轮迭代的执行结果结构化存储：

- name: 批量拉取所有ACR的镜像仓库清单
  include_role:
    name: list_docker_image_repos
  vars:
    registry_name: "{{ item }}"
  loop: "{{ acrs }}"
  register: all_fetch_tasks_result

3. 后续需要统一结构时，直接从注册的结果集合中抽取目标值，不需要逐次循环修改全局变量：

- name: 整理为统一的镜像仓库清单结构
  set_fact:
    # 从每轮迭代的结果中抽取角色产出的仓库列表，按需调整结构
    all_acr_repos: >-
      {{
        all_fetch_tasks_result.results
        | map(attribute='ansible_facts.current_registry_repos')
        | list
      }}

这种方式的优势：

• 没有循环过程中的状态污染问题，所有中间结果都存在结构化的注册变量中，不会因为作用域、缓存问题出现值错乱
• 调试成本更低，排查问题时可以直接打印注册的任务结果，不需要逐次追踪每轮循环的变量修改
• 兼容所有Ansible版本，不受语法特性的版本限制

内容的提问来源于stack exchange，提问作者D. Seah