基础设施即代码 / 系统课时

使用 Loop 批量处理数据

使用 Loop 批量处理数据

当多个任务只有输入数据不同,逐条复制任务会让 Playbook 难以维护。Ansible 的 loop 可以把列表或结构化数据依次绑定到循环项,在一个任务中完成批量处理,并通过 loop_control 改善可读性。

学习目标

  • 使用 loop 遍历简单列表和结构化数据
  • 正确通过 item 读取当前循环项及其字段
  • 使用 loop_control 为循环输出提供清晰标签

Loop 如何执行任务

loop 接收一个列表。Ansible 会针对列表中的每个元素执行一次当前任务,并在每次迭代时把元素保存到默认变量 item 中。因此,循环并不是一次把全部值传给模块,而是让同一个任务按数据项重复执行。

简单列表可以直接使用 item:

yaml
- name: Print service names
  ansible.builtin.debug:
    msg: "service={{ item }}"
  loop:
    - nginx
    - redis
    - postgresql

这段任务会执行三次,item 依次为三个服务名称。适合参数只有一个值的批量操作,例如创建目录、安装软件包或检查端口。

用结构化数据消除重复任务

实际自动化通常需要同时携带多个字段。此时可以让循环列表中的每一项都是字典,再通过 item.<字段名> 读取数据。下面的 Playbook 可以直接在本机运行,不修改系统状态:

yaml
---
- name: Demonstrate structured loops
  hosts: localhost
  gather_facts: false
  vars:
    applications:
      - name: api
        port: 8080
        state: enabled
      - name: worker
        port: 9090
        state: disabled
  tasks:
    - name: Print application configuration
      ansible.builtin.debug:
        msg: "name={{ item.name }} port={{ item.port }} state={{ item.state }}"
      loop: "{{ applications }}"
      loop_control:
        label: "{{ item.name }}"

运行命令:

bash
ansible-playbook -i localhost, -c local loop-demo.yml

预期输出中的主机名、时间统计等动态内容可能不同,但两次循环应分别得到:

text
ok: [localhost] => (item=api) => {
    "msg": "name=api port=8080 state=enabled"
}
ok: [localhost] => (item=worker) => {
    "msg": "name=worker port=9090 state=disabled"
}

loop_control.label 只改变日志中显示的循环标签,不会修改 item 的实际内容。结构较大的字典尤其适合使用它,否则 Ansible 默认会把整个循环项打印到任务输出中。

避免循环变量冲突

默认变量名 item 简洁,但在包含角色、任务文件或嵌套循环的场景中,外层和内层都使用 item 容易发生覆盖。可以通过 loop_control.loop_var 为当前循环指定更有语义的名称。

yaml
- name: Print application names
  ansible.builtin.debug:
    msg: "application={{ app.name }}"
  loop: "{{ applications }}"
  loop_control:
    loop_var: app

这属于片段示例,依赖前一个 Playbook 中定义的 applications 变量。生效后,当前循环项通过 app 访问,而不是 item;验证时应看到 application=api 和 application=worker。

什么时候适合使用 Loop

当任务动作完全相同、只有参数数据变化时,优先把差异提取为列表或字典并交给 loop。如果不同数据项需要执行完全不同的模块和控制流程,则不应为了使用循环而把大量条件塞进同一个任务;这种情况拆成独立任务通常更清晰。

循环的核心是把“重复的任务定义”转换为“单个任务加一组数据”。只要循环项结构设计清楚,后续新增对象通常只需添加数据,而不必复制整段任务。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Loop 批量处理数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通