Ansible中loop与register模块搭配使用的标准方法及输出获取

当在Ansible任务中同时使用loop和register时，register捕获的结果并非单条任务输出，而是一个包含所有循环迭代记录的列表，这是最核心的规则。以下是具体用法和示例：

核心逻辑 #

带loop的任务执行后，register变量会包含一个results字段，该字段是一个列表，列表中的每个元素对应一次loop迭代的完整任务结果（包含stdout、stdout_lines、stderr、rc、changed等常规任务输出字段）。

正确代码示例 #

- name: 循环执行命令并捕获输出
  hosts: all
  gather_facts: false

  tasks:
    - name: 循环执行shell命令
      ansible.builtin.shell: "echo 当前值: {{ item }}"
      environment:
        ENV_SETTING: "demo_env"
      register: output
      loop:
        - "值1"
        - "值2"
        - "值3"

    - name: 逐个打印循环输出
      ansible.builtin.debug:
        msg: "第{{ idx + 1 }}次执行结果: {{ res.stdout_lines }}"
      loop: "{{ output.results }}"
      loop_control:
        index_var: idx
        label: "{{ res.item }}"  # 可选，让循环输出更清晰

关键用法说明 #

• 访问单条迭代结果：通过output.results遍历所有循环记录，每个元素res对应一次执行，可直接调用res.stdout_lines、res.rc等字段
• 区分迭代索引：使用loop_control的index_var定义索引变量，方便标记是第几次循环
• 筛选结果：可结合过滤器筛选特定迭代，比如只保留执行成功的记录：

  - name: 只打印成功的执行结果
    ansible.builtin.debug:
      msg: "{{ res.stdout }}"
    loop: "{{ output.results | selectattr('rc', 'eq', 0) }}"
  

• 处理失败迭代：如果需要允许部分迭代失败不终止任务，可添加ignore_errors: yes到原任务，之后通过res.failed字段判断哪些迭代失败：

  - name: 循环执行允许失败
    ansible.builtin.shell: "some_command {{ item }}"
    register: output
    loop: "{{ items_list }}"
    ignore_errors: yes
  
  - name: 打印失败的迭代
    ansible.builtin.debug:
      msg: "执行失败的项: {{ res.item }}"
    loop: "{{ output.results | selectattr('failed', 'eq', true) }}"
  

常见误区 #

不要直接尝试访问output.stdout_lines这类字段——带loop时，这些单条任务的字段不会直接出现在顶层的register变量中，必须从results列表的元素里获取，否则会触发变量未定义的错误。

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