### Ansible Playbook 执行流程详解 #### 1. 解析 YAML 文件 Ansible 首先会解析传入的 `.yaml` 或 `.yml` 文件，将其转换为内部数据结构。此阶段主要验证语法是否正确以及文件格式是否符合 YAML 标准[^3]。 #### 2. 加载 Inventory 文件 Inventory 是主机清单文件，默认位于 `/etc/ansible/hosts` 或通过 `-i` 参数指定。在此阶段，Ansible 将读取并加载目标主机及其分组信息，用于后续的任务分配。 #### 3. 初始化 Context 和 Variables 在这一阶段，Ansible 开始初始化上下文环境，并处理所有的变量定义。这些变量可能来自以下几个方面： - **默认变量**：Playbook 中 `vars` 字段定义的内容。 - **外部变量文件**：通过 `include_vars` 模块引入的额外变量文件。 - **命令行参数**：使用 `-e` 参数传递给 playbook 的动态变量[^2]。 - **Facts 数据**：如果启用了事实收集 (`gather_facts: yes`)，则会在每台主机上运行 fact 脚本以获取系统相关信息。 #### 4. 应用 Host Filters (Pattern Matching) 根据 Playbook 中定义的目标模式（如 all、webservers 等），筛选出符合条件的实际主机列表。这一步决定了哪些设备会被纳入当前 play 的作用范围[^3]。 #### 5. 运行 Pre-Tasks (可选) 某些情况下可以在 main tasks 前设置 pre-tasks 来完成前置准备工作，比如安装必要的软件包或者配置初始状态[^3]。 #### 6. 循环 Tasks 列表 对于选定的每一台主机依次执行 task 清单中的各项操作。每个 Task 实际是对某个特定模块的一次调用，例如创建用户(user module)，管理服务(service module)等等[^1]。以下是具体步骤分解： - **模板渲染**: 如果存在 Jinja2 模板，则会对其中嵌套的大括号表达式 `{ { var } }` 替换实际值后再继续下一步动作[^2]。 - **远程连接建立**: 默认采用 SSH 协议登录至目标服务器；也可以切换其他传输方式(如 paramiko)[^3]。 - **模块执行**: 在远端节点上调用对应的功能组件实现预期效果。例如下面这段代码展示了如何利用 command 模块来测试网络连通性[^4]: ```yaml - name: Ping www.baidu.com command: ping -c 1 www.baidu.com register: result ignore_errors: true ``` - **结果记录与反馈**: 把每次交互后的返回码、标准输出以及其他元数据保存下来供以后分析或触发 handler 动作[^3]。 #### 7. 处理 Handlers (条件触发的动作集合) Handlers 类似于延迟调用机制，只有当关联资源发生变化时才会真正生效。典型应用场景就是重启服务实例之后保持一致性。 #### 8. 输出总结报告 最终汇总所有已完成工作的统计信息并向控制台打印出来，包括成功数量、失败次数及其他异常情况说明等。 --- ### 示例 Code Block 以下是一个简单的示例展示了一个完整的 Playbook 结构： ```yaml --- - hosts: webservers vars: http_port: 80 max_clients: 200 remote_user: root tasks: - name: Ensure Apache is installed and up-to-date. yum: pkg: httpd state: latest - name: Configure Apache settings via Template. template: src: /path/to/local/template.conf.j2 dest: /etc/httpd/conf.d/custom.conf - name: Start or Restart HTTPD Service as needed. service: name: httpd state: started enabled: yes handlers: - name: Reload Web Server Configuration After Changes Made To Itself Only Once Per Run Cycle Even Multiple Times Triggered By Different Resources Simultaneously! service: name: httpd state: reloaded ``` ---