Ansible-Playbook 剧本编写

Ansible Playbook 是 YAML 格式的自动化脚本,核心作用是将多步运维任务(如安装软件、配置文件、启动服务)编排成可重复执行的 "自动化流程"。其结构遵循固定的层级逻辑,从基础到进阶可拆解为「YAML 基础规范 + Play 核心结构 + 进阶组件」三部分,以下结合实操示例详细说明:

一、先掌握:Playbook 的 YAML 基础(必守规则)

Playbook 基于 YAML 编写,YAML 的语法规则直接决定 Playbook 是否能正常执行,核心规则:

  1. 缩进:用 2 个空格缩进(禁止用 Tab),层级靠缩进区分(最核心!);
  2. 列表项 :用 - 开头表示一个列表元素(比如一个 Play、一个任务);
  3. 键值对 :用 key: value 格式(冒号后必须加空格);
  4. 字符串:简单字符串可不用引号,含特殊字符(如空格、*)需用单 / 双引号包裹;
  5. 注释 :用 # 开头,注释内容不会执行。

二、Playbook 的核心结构(从基础到进阶)

一个 Playbook 由 一个或多个 Play 组成,每个 Play 对应 "对一组主机执行一系列任务"。单个 Play 的核心结构如下(按优先级 / 常用度排序):

核心元素 作用 示例
hosts 必选!指定要操作的主机 / 组(对应 Inventory 里的分组 / IP) hosts: webservers / all
remote_user 远程执行任务的用户(通常是 root) remote_user: root
become/become_user 提权(普通用户 sudo 到 root) become: yes + become_user: root
vars 自定义变量(可在任务中引用) vars: {nginx_port: 80}
tasks 必选!要执行的任务列表(每个任务对应一个 Ansible 模块) 见下方示例
handlers 处理器(触发式任务,仅被 notify 调用时执行,如重启服务) 见下方示例
roles 调用预定义的 Role(模块化复用) roles: [nginx, mysql]
pre_tasks/post_tasks 任务执行前 / 后的前置 / 后置任务(如执行前备份配置) 见进阶示例
tags 标签(指定只执行部分任务,方便调试) tags: ["deploy",
  1. 缩进必须 "层级分明":

    • Play 层级(gather_facts/hosts/tasks):相对于- name: first play1缩进 2 个空格;
    • Tasks 下的任务名称(- name:):相对于tasks:缩进 2 个空格(总计 4 个);
    • 任务的模块(ping:/command:/service:):相对于- name:缩进 2 个空格(总计 6 个);
    • 模块的参数(src:/name:/state:):相对于模块(copy:/service:)缩进 2 个空格(总计 8 个);✅ 核心:子元素必须比父元素多缩进 2 个空格,且全程用空格(禁止 Tab)。

示例

按 Ansible 缩进规则(2 个空格递进)拆解,核心层级缩进如下:

层级 内容示例 实际缩进量 规范要求
Play 根层级 - name: first play1 0 空格 根层级无缩进
Play 级参数 gather_facts: false 2 空格 比根层级 + 2
Tasks 列表项 - name: test connection 4 空格 比 tasks:+2
模块层级(核心) ping: / command: 6 空格 比任务项 + 2
Handlers 列表项 - name: restart httpd 4 空格 比 handlers:+2
Handler 模块层级 service: name=httpd... 6 空格 比 handler 项 + 2

验证命令

ansible-playbook test1.yaml --syntax-check

输出

相关推荐
HideF7 天前
Linux ansible
ansible
垚垚学技术_聚焦云原生20 天前
Ansible Vault 安全实践:敏感密码、密钥加密存储方案
安全·elasticsearch·ansible
广目软件22 天前
HA分布式架构采集节点变更操作手册20261029
运维·服务器·ansible·zabbix·prometheus
Moshow郑锴23 天前
Ansible 批量部署 Node.js 服务:ZIP 直解与共享目录分发两种方案对比
node.js·ansible
垚垚学技术_聚焦云原生23 天前
Ansible Playbook 进阶:when 条件、loop 循环、handlers 触发器落地
linux·ansible·自动化运维·devops
Moshow郑锴23 天前
GCP MIG 重建后 Ansible 初始化实战:PowerShell + NSSM 挂载 Windows 服务
windows·ansible
承渊政道25 天前
新增一台服务器时还要重新装Nginx?Ansible只改hosts目标列表,同一份Playbook继续执行
运维·nginx·ansible·内网穿透·cpolar
Helix2501 个月前
Ansible混合环境自动化:Windows与Linux统一配置管理实战
windows·自动化·ansible·playbook·配置管理·winrm·混合环境
垚垚学技术_聚焦云原生1 个月前
Ansible 变量体系详解:主机变量、组变量、全局变量优先级实战
ansible·自动化运维·devops·变量优先级
I'mChloe1 个月前
不再逐台装Docker:我用Ansible Playbook批量统一服务器环境
服务器·docker·ansible