Ansible Playbook使用案例

📅 2026/8/16 5:10:54
Ansible Playbook使用案例
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 - user21.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.1.3 验证用户创建结果执行完成后可通过以下命令验证用户是否成功创建并查看密码哈希[roothost1 ~]# cat /etc/shadow同时检查/home目录下是否已生成对应的用户家目录[roothost1 ~]# cd /home/ [roothost1 home]# ls kyy user1 user2 [roothost1 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 user21.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 登录新创建的用户账户确认账户可正常使用继续验证一下 [rootserver2 ~]# cd /home/ [rootserver2 home]# ls kyy user1 user2 [rootserver2 home]# cd user1/ [rootserver2 user1]# ll total 0 [rootserver2 user1]# ssh user1localhost The authenticity of host localhost (::1) cant be established. ED25519 key fingerprint is SHA256:0Hrk3R1SBGwunSQd57OJRVNVRibsQASR8UfHIS121c. 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. user1localhosts password: [user1server2 ~]$ pwd /home/user1 [user1server2 ~]$ ll -d /home/user1 drwx------. 2 user1 user1 62 Aug 15 18:07 /home/user1tags在 Ansible 中tags标签是一个强大的功能它允许您为 playbook 中的任务task或整个 play 打上标记从而在执行时可以选择性地运行特定部分而不是运行整个 playbook。这在大型、复杂的自动化场景中尤其有用可以显著提高执行效率和灵活性。tags 的核心概念与用途主要用途包括选择性执行只运行带有特定标签的任务跳过其他任务。环境适配为开发、测试、生产环境定义不同的标签按需执行。功能模块化将 playbook 按功能如“安装”、“配置”、“启动”划分标签便于维护和调试。跳过已知问题临时跳过某些可能失败或不需要的任务。[kyyserver1 ansible]$ vim test.yml [kyyserver1 ansible]$ ansible-playbook test.yml --list-tags playbook: test.yml play #1 (lamp): lamp TAGS: [] TASK TAGS: [t1, t2, t3] play #2 (localhost): localhost TAGS: [] TASK TAGS: []--- - hosts: web #vars: # - http_port: 80 tasks: - name: Install the Apache ansible.builtin.yum: name: httpd state: present tags: t1 - name: Start service httpd, if not started ansible.builtin.service: name: httpd state: started enabled: yes tags: t2 name: create index.html ansible.builtin.copy: content: {{ ansible_hostname }}\n dest: /var/www/html/index.html tags: t3总而言之tags 是 Ansible 实现精细化、高效化自动化管理的核心工具之一熟练掌握其用法能显著提升运维工作的灵活性与可靠性。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]并添加若干成员[kyyserver1 ansible]$ vim hosts # 添加以下组 [webservers] server1 server2 host12. 创建模板任务 Playbook编写一个 Playbookgroup.yml使用template模块将 Jinja2 模板渲染到目标主机的/etc/hosts文件--- - hosts: webservers tasks: - name: test ansible.builtin.template: src: test.j2 dest: /etc/hosts5.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。5.4 执行与验证执行上述 Playbook 后目标主机上的/etc/hosts文件将被更新自动添加所有webservers组成员的 IP 与主机名映射。总结通过组合使用groups获取组内主机列表和hostvars获取特定主机的详细信息可以实现基于主机组结构的动态、批量配置这是编写灵活、可扩展的 Ansible Playbook 的核心技巧之一。