基础设施即代码 / 系统课时
使用 Loop 批量处理数据
使用 Loop 批量处理数据
当多个任务只有输入数据不同,逐条复制任务会让 Playbook 难以维护。Ansible 的 loop 可以把列表或结构化数据依次绑定到循环项,在一个任务中完成批量处理,并通过 loop_control 改善可读性。
学习目标
- 使用
loop遍历简单列表和结构化数据 - 正确通过
item读取当前循环项及其字段 - 使用
loop_control为循环输出提供清晰标签
Loop 如何执行任务
loop 接收一个列表。Ansible 会针对列表中的每个元素执行一次当前任务,并在每次迭代时把元素保存到默认变量 item 中。因此,循环并不是一次把全部值传给模块,而是让同一个任务按数据项重复执行。
简单列表可以直接使用 item:
- name: Print service names
ansible.builtin.debug:
msg: "service={{ item }}"
loop:
- nginx
- redis
- postgresql这段任务会执行三次,item 依次为三个服务名称。适合参数只有一个值的批量操作,例如创建目录、安装软件包或检查端口。
用结构化数据消除重复任务
实际自动化通常需要同时携带多个字段。此时可以让循环列表中的每一项都是字典,再通过 item.<字段名> 读取数据。下面的 Playbook 可以直接在本机运行,不修改系统状态:
---
- 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 }}"运行命令:
ansible-playbook -i localhost, -c local loop-demo.yml预期输出中的主机名、时间统计等动态内容可能不同,但两次循环应分别得到:
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 为当前循环指定更有语义的名称。
- 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。如果不同数据项需要执行完全不同的模块和控制流程,则不应为了使用循环而把大量条件塞进同一个任务;这种情况拆成独立任务通常更清晰。
循环的核心是把“重复的任务定义”转换为“单个任务加一组数据”。只要循环项结构设计清楚,后续新增对象通常只需添加数据,而不必复制整段任务。