【自动化运维神器Ansible】YAML语法详解：Ansible Playbook的基石

• YAML文档以---开头，可选的以...结束：

---
# 这是一个YAML文档
document: content
...

• 基本键值对结构：

key: value

• 嵌套结构：

parent:
  child1: value1
  child2: value2

• 使用短横线-表示列表项：

fruits:
  - Apple
  - Orange
  - Banana

• YAML支持复杂的嵌套结构：

servers:
  - name: web01
    ip: 192.168.1.10
    ports:
      - 80
      - 443
  - name: db01
    ip: 192.168.1.20
    ports:
      - 3306

• 折叠风格（>）：将多行合并为单行，保留换行符为空格

description: >
  This is a long
  description that
  will be folded

• 字面风格（|）：保留所有换行符

script: |
  #!/bin/bash
  echo "Hello"
  echo "World"

• 在Ansible中，使用{{ }}嵌入变量：

message: "Hello {{ username }}"

• 使用&定义锚点，*引用锚点：

defaults: &defaults
  port: 80
  timeout: 30

server1:
  <<: *defaults
  host: server1.example.com

server2:
  <<: *defaults
  host: server2.example.com

---
- name: Play名称
  hosts: target_hosts
  vars:
    variable1: value1
  tasks:
    - name: 任务描述
      module:
        parameter1: value1
        parameter2: value2

• 条件判断：

tasks:
  - name: 仅Ubuntu安装
    apt:
      name: nginx
    when: ansible_os_family == "Debian"

• 循环：

tasks:
  - name: 添加多个用户
    user:
      name: "{{ item }}"
      state: present
    loop:
      - user1
      - user2
      - user3

network_config:
  interfaces:
    - name: eth0
      ip: 192.168.10.10
      netmask: 255.255.255.0
    - name: eth1
      ip: 10.0.0.10
      netmask: 255.0.0.0

• YAML与Jinja2模板引擎结合：

template: "{{ lookup('file', '/templates/' + os_type + '.j2') }}"

users: "{{ query('inventory_hostnames', 'web*') | map('extract', hostvars, 'user') | list }}"

• 缩进：使用2个空格（Ansible官方推荐）
• 字符串引号：仅在必要时使用引号
• 行长度：建议不超过80个字符
• 注释：使用#，与内容保持相同缩进

• 不好的写法：

- name: 安装包
  apt: name={{item}} state=present
  with_items: [pkg1,pkg2,pkg3]

• 好的写法：

- name: 安装包
  apt:
    name: "{{ item }}"
    state: present
  loop:
    - pkg1
    - pkg2
    - pkg3

• 语法验证：

ansible-playbook --syntax-check playbook.yml

• 问题：

tasks:
- name: 错误示例
    debug:  # 缩进不一致
      msg: "Hello"

• 解决：统一使用2个空格缩进

• 问题：

enabled: yes # 可能被解析为字符串

• 解决：

enabled: true # 显式布尔值

• 问题：

message: This is a string: with colon

• 解决：

message: "This is a string: with colon" # 使用引号

---
# production.yml
- name: 生产环境配置
  hosts: prod
  vars:
    db_host: db.prod.example.com
    cache_size: 2048
  tasks:
    - name: 部署配置
      template:
        src: templates/config.j2
        dest: /etc/app/config.ini

---
- name: 数据库备份与轮转
  hosts: dbservers
  tasks:
    - name: 检查磁盘空间
      command: df -h
      register: disk_space
    
    - name: 执行备份
      command: mysqldump -u root db > /backups/db-{{ ansible_date_time.date }}.sql
      when: "'/backups' in disk_space.stdout"
    
    - name: 清理旧备份
      find:
        paths: /backups
        patterns: "db-*.sql"
        age: "7d"
      register: old_backups
      
    - name: 删除旧备份
      file:
        path: "{{ item.path }}"
        state: absent
      loop: "{{ old_backups.files }}"

• roles/webserver/tasks/main.yml:

---
- name: 安装Nginx
  apt:
    name: nginx
    state: present
  
- name: 配置Nginx
  template:
    src: nginx.conf.j2
    dest: /etc/nginx/nginx.conf
  notify: 重启Nginx