Ansible 2 -- 5 playbook 语法

playbook

使用 Ansible 时，绝大部分时间将花费在编写playbook上。playbook 英文直译是剧本的意思，是一个Ansible术语，它指的是用于配置管理的脚本。

playbook 是 YAML格式的，yaml格式可以很方便的被转换为json供开发语言使用

顺便推荐一个在线的 YAML转json服务

playbook是一个非常简单的配置管理和多主机部署系统，不同于任何已经存在的模式，可作为一个适合部署复杂应用程序的基础。playbook可以定制配置，可以按指定的操作步骤有序执行，支持同步及异步方式。

playbook是Ansible实现批量自动化最重要的手段。在其中可以使用变量、引用、循环等功能，功能比较强大。

一个playbook就是一组play组成的列表

每个play必须包含host和task，play就可以想象为连接到主机(host)上执行任务(task)的事物

host就是inventory中定义的主机

tasks下定义一系列的task任务列表，依次执行，如果执行某任务失败了，后续的任务不会执行

image.png

示例

playbook.yml

---  # yaml文件可以以 --- 开头
  - name: the first demo  # 使用 '-' 减号作为列表项，会被解析为json数组，注意在playbook中name属性不是必须的，表示描述，表示圈定一个范围，范围内的项都属于该列表。
    hosts: cloud  # cloud 是定义的主机，每一个playbook中必须包含"hosts"和"tasks"项
    tasks:
      - name: execute date cmd  # 描述这个task
        command: /bin/date # 本质是加载并执行ansible对应的模块

转换为JSON

[ { 
   name: 'the first demo',
    hosts: 'cloud',
    tasks: [ 
       { 
          name: 'execute date cmd', 
          command: '/bin/date' 
       } 
   ] 
} ]

执行前先检查 ansible-playbook playbook.yml --check

有用的flag

--check 对支持check的大部分核心模块，输出真正执行会进行哪些更改
--diff 报告更改，比如操作文件，会告诉用户之前之后发生了哪些变化，由于会产生大量输出，最好在单一主机使用

另外例子

 ---
- hosts: localhost # 列表1
  remote_user: root
  tasks:
    - name: test1 # 子列表，下面是shell模块，是一个动作，所以定义为列表，只不过加了个name
      shell: echo /tmp/a.txt
      register: hi_var
    - debug: var=hi_var.stdout # 调用模块，这是动作，所以也是列表 # 同样是动作，包含文件
    - include: /tmp/nginx.yml
    - include: /tmp/mysql.yml
- copy:   # 调用模块，定义为列表。但模块参数是虚拟性内容，应定义为字典而非列表 
        src: /etc/resolv.conf  # 模块参数1
        dest: /tmp   # 模块参数2
- hosts: 192.168.100.65  # 列表2
  remote_user: root
  vars:
    nginx_port: 80  # 定义变量，是虚拟性的内容，应定义为字典而非列表
    mysql_port: 3306
  vars_files:
    - nginx_port.yml  # 无法写成key/value格式，且是实体文件，因此定义为列表
  tasks:
    - name: test2
      shell: echo /tmp/a.txt
      register: hi_var  # register是和最近一个动作绑定的
    - debug: var=hi_var.stdout

通过 ansible-playbook -h 获取所有参数列表
首先ansible-playbook -C playbook.yml检查语法。这里我故意写错了，在 -name同级添加了 hosts，这是不允许的，所以报错了。Ansible 的错误提示还是很方便的。

image.png

修改后：

image.png

playbook中的配置项

playbook 除了hosts和tasks还有其他配置项：

name play的描述，Ansible执行时会打印出来
remote_user 指定在远程主机上执行任务的用户
vars
vars_files

配置
playbook 例子，包含了1个play，3个tasks，1个handlers

image.png

notify和handler

ansible中几乎所有的模块都具有幂等性，这意味着被控主机的状态是否发生改变是能被捕捉的，即每个任务的 changed=true或changed=false。ansible在捕捉到changed=true时，可以触发notify组件(如果定义了该组件)。
notify是一个组件，并非一个模块，它可以直接定义action，其主要目的是调用handler。例如:

tasks:
     - name: copy template file to remote host
       template: src=/etc/ansible/nginx.conf.j2 dest=/etc/nginx/nginx.conf
       notify:
         - restart nginx
         - test web page
       copy: src=nginx/index.html.j2 dest=/usr/share/nginx/html/index.html
       notify:
         - restart nginx
 handlers:
     - name: restart nginx
       service: name=nginx state=restarted
     - name: test web page
       shell: curl -I http://192.168.100.10/index.html | grep 200 || /bin/false

这表示当执行template模块的任务时，如果捕捉到changed=true，那么就会触发notify，如果分发的index.html改变了，那么也重启nginx(当然这是没必要的)。notify下定义了两个待调用的handler。handler主要用于重启服务或者触发系统重启，除此之外很少使用handler。

handler的定义和tasks的定义完全一样，唯一需要限定的是handler中task的name必须和notify中定义的名称相同。

注意，notify是在执行完一个play中所有task后被触发的，在一个play中也只会被触发一次。

意味着如果一个play中有多个task出现了changed=true，它也只会触发一次。例如上面的示例中，向nginx复制配置文件和复制
index.html时如果都发生了改变，都会触发重启nginx操作。但是只会在执行完play后重启一次，以避免多余的重启。