在 Ansible 中，`with_items` 关键词的使用指南

摘要：Ansible中的with_items关键词用于循环执行任务，支持基础操作如批量安装软件包和创建目录，也支持高级功能如动态列表生成和嵌套循环。实战场景包括批量删除文件和创建用户，常见问题涉及变量解析和性能优化。Ansible 2.5+推荐使用loop替代with_items，并提供了调试技巧如查看循环详情和暂停迭代。合理使用这些功能可以简化Playbook逻辑，高效管理重复性任务。

在 Ansible 中，with_items是用于循环执行任务的关键词，允许你通过一个列表迭代执行相同的操作。以下是详细的使用指南、实战示例及常见问题解答：

一、基础用法

1. 安装多个软件包

-name:Install multiple packagesapt:name:"{{ item }}"state:presentwith_items:-vim-git-curl

2. 处理多个文件

-name:Create multiple directoriesfile:path:"/tmp/{{ item }}"state:directorywith_items:-logs-backups-config

二、高级用法

1. 动态生成列表

从变量或外部数据源动态生成循环项：

-name:Process dynamic itemsshell:"echo {{ item }}"loop:"{{ my_dynamic_list }}"loop_control:label:"Processing {{ item }}"

2. 嵌套循环

-name:Nested loop examplewith_items:-[1,2,3]-[a,b,c]register:result-debug:var:result.results

3. 结合loop_control增强可读性

-name:Task with custom loop labelscommand:"echo {{ item }}"loop:["apple","banana"]loop_control:label:"Fruit: {{ item }}"

三、实战场景

1. 批量删除文件

-name:Delete old log filesfile:path:"/var/log/{{ item }}"state:absentwith_items:-app.log.20230101-app.log.20230102-error.log.202301*

2. 批量创建用户

-name:Create multiple usersuser:name:"{{ item.name }}"state:presentgroups:"{{ item.groups }}"with_items:-{name:alice,groups:developers}-{name:bob,groups:admins}

四、常见问题与解决方案

1. 变量未正确解析

• 错误：undefined variable: item
• 解决：确保变量在任务作用域内定义，或在vars部分声明。

2. 循环结果未保存

• 问题：默认循环结果存储在results列表中。
• 示例：

-name:Check task resultsdebug:var:ansible_facts

3. 性能问题（大列表）

• 优化：使用async_status模块异步执行任务：

-name:Async task with loopasync_status:jid:"{{ item }}"register:async_resultuntil:async_result.finishedretries:5loop:"{{ async_jobs }}"

五、替代方案：loop关键字

Ansible 2.5+ 推荐使用loop替代with_items：

-name:Modern loop syntaxcopy:src:"{{ item }}"dest:"/tmp/"loop:-file1.txt-file2.txt

六、调试技巧

1. 查看循环详细信息

-name:Debug loop itemsdebug:msg:"Current item: {{ item }}"loop:"{{ my_list }}"

2. 使用pause调试

-name:Pause after each iterationpause:seconds:2loop:"{{ my_list }}"

通过合理使用with_items或loop，你可以高效管理重复性任务，简化 Playbook 逻辑！ 🔄