Ansible Playbook使用案例

2026/8/16 5:32:57

Ansible Loop 循环

Ansible 的loop循环功能允许您对一组数据项重复执行同一任务，从而简化批量操作。本节将通过创建用户账户的实例，演示loop的基本用法及其进阶应用。

1. 1 基础循环：创建用户

以下 Playbook 使用loop在目标主机组db上创建两个用户（user1和user2）：

--- - hosts: db tasks: - name: Add the users ansible.builtin.user: name: "{{ item }}" state: present loop: - user1 - user2

1.2 进阶循环：创建用户并设置密码

若需为每个用户设置密码，可将循环项改为字典列表，通过item.user和item.pass分别引用用户名和密码：

--- - hosts: db tasks: - name: Add the users with password ansible.builtin.user: name: "{{ item.user }}" password: "{{ item.pass | password_hash('sha512') }}" state: present loop: - {user: user1, pass: pass1} - {user: user2, pass: pass2}

1.3 验证用户创建结果

执行完成后，可通过以下命令验证用户是否成功创建并查看密码哈希：

[root@host1 ~]# cat /etc/shadow

同时检查/home目录下是否已生成对应的用户家目录：

[root@host1 ~]# cd /home/ [root@host1 home]# ls kyy user1 user2 [root@host1 home]# ll total 0 drwx------ 4 kyy kyy 111 Aug 14 15:21 kyy drwx------ 2 user1 user1 62 Aug 15 17:44 user1 drwx------ 2 user2 user2 62 Aug 15 17:44 user2

1.4 跨主机组测试

将目标主机组改为web并设置gather_facts: no以跳过事实收集，可快速验证循环在不同环境下的执行效果：

--- - hosts: web gather_facts: no tasks: - name: Add the users with password ansible.builtin.user: name: "{{ item.user }}" password: "{{ item.pass | password_hash('sha512') }}" state: present loop: - {user: user1, pass: pass1} - {user: user2, pass: pass2}

1.5 登录验证

最后，通过 SSH 登录新创建的用户账户，确认账户可正常使用：

继续验证一下 [root@server2 ~]# cd /home/ [root@server2 home]# ls kyy user1 user2 [root@server2 home]# cd user1/ [root@server2 user1]# ll total 0 [root@server2 user1]# ssh user1@localhost The authenticity of host 'localhost (::1)' can't be established. ED25519 key fingerprint is SHA256:0Hrk3R+1SBGwunSQd57OJRVNVRibsQASR8UfHIS121c. This key is not known by any other names Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added 'localhost' (ED25519) to the list of known hosts. user1@localhost's password: [user1@server2 ~]$ pwd /home/user1 [user1@server2 ~]$ ll -d /home/user1 drwx------. 2 user1 user1 62 Aug 15 18:07 /home/user1

rescue

在 Ansible 中，rescue 是错误处理机制的关键组成部分，通常与block和always结合使用，构成一个完整的异常处理结构。当block中的任务执行失败时，Ansible 会跳过该block内剩余的任务，转而执行rescue部分，用于捕获错误、记录日志或执行恢复操作。无论block和rescue的执行结果如何，always部分都会被执行，常用于清理资源或发送通知。

3.1 基本语法与结构

一个典型的block、rescue与always组合结构如下所示：

block（主任务块）：包含两个主要任务：1) 使用yum模块安装指定软件包；2) 使用service模块启动该软件包对应的服务。这两个任务是期望正常执行的核心逻辑。
rescue（错误恢复块）：如果block中的任何一个任务失败，Ansible 会跳过block中剩余的任务，转而执行rescue块。这里它做了两件事：1) 使用debug模块记录失败信息；2) 尝试安装一个备用的软件包（fallback-{{ package_name }}）作为降级方案。
always（始终执行块）：无论block成功还是失败，也无论rescue是否执行，always块中的任务都会执行。这里它负责清理临时文件（/tmp/{{ package_name }}.tmp），确保不会留下垃圾数据。

- name: Handle package installation with error recovery block: - name: Install the package ansible.builtin.yum: name: "{{ package_name }}" state: present - name: Start the service ansible.builtin.service: name: "{{ package_name }}" state: started rescue: - name: Log the failure ansible.builtin.debug: msg: "Failed to install or start {{ package_name }}" - name: Install a fallback package ansible.builtin.yum: name: "fallback-{{ package_name }}" state: present always: - name: Always clean up temporary files ansible.builtin.file: path: "/tmp/{{ package_name }}.tmp" state: absent

总而言之，rescue 机制为 Ansible Playbook 提供了强大的容错能力，使得自动化脚本在面对不可预见的错误时能够优雅应对，从而提升整体运维的可靠性与健壮性。

facts组件

在 Ansible 中，facts（事实）是自动化任务执行的关键信息来源。它们是由 Ansible 在连接到目标主机后自动收集的系统信息，包括主机名、IP 地址、操作系统版本、磁盘空间、内存使用情况等。这些信息以变量的形式存储，可以在 Playbook 中直接引用，从而实现动态、自适应的配置管理。
默认情况下，Ansible 会在每个 Play 开始时自动收集 facts。若需提升执行速度，可通过gather_facts: no关闭此功能。
对于需要精细控制或自定义信息的场景，还可以使用setup模块手动收集，或通过fact_caching缓存 facts 以加速后续 Playbook 运行。
总而言之，facts 是 Ansible 实现智能、上下文感知自动化的基石，熟练掌握其收集、引用与缓存机制，能极大提升 Playbook 的灵活性与可维护性。

例如：批量修改主机hosts文件

--- - hosts: db tasks: - name: update hosts ansible.builtin.lineinfile: path: /etc/hosts line: "{{ ansible_eth0.ipv4.address }} {{ ansible_hostname }}"

魔法变量 hostvars 与 groups

在 Ansible 中，hostvars和groups是两个强大的“魔法变量”，它们提供了在 Playbook 执行期间动态访问主机信息和主机组结构的能力。本节将通过一个配置/etc/hosts文件的实例，演示如何结合使用这两个变量。

5.1 准备主机清单

首先，在 Ansible 的主机清单文件（hosts）中定义一个主机组[webservers]，并添加若干成员：

[kyy@server1 ansible]$ vim hosts # 添加以下组 [webservers] server1 server2 host1

2. 创建模板任务 Playbook

编写一个 Playbook（group.yml），使用template模块将 Jinja2 模板渲染到目标主机的/etc/hosts文件：

--- - hosts: webservers tasks: - name: test ansible.builtin.template: src: test.j2 dest: /etc/hosts

5.3 编写 Jinja2 模板

创建模板文件test.j2。该模板将循环遍历webservers组中的所有主机，并使用hostvars获取每台主机的 IP 地址和主机名：

127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 ::1 localhost localhost.localdomain localhost6 localhost6.localdomain6 {# 循环遍历 webservers 组中的每台主机 #} {% for host in groups['webservers'] %} {{ hostvars[host].ansible_eth0.ipv4.address }} {{ hostvars[host].ansible_hostname }} {% endfor %}

关键变量解析：
groups['webservers']：返回属于webservers组的所有主机名列表。
hostvars[host]：一个字典，包含了指定主机（host）的所有 facts 变量。这里我们获取其以太网接口 IP 地址（ansible_eth0.ipv4.address）和主机名（ansible_hostname）。