Ansibile之playbook初识

　　一、playbook简介

　　ansiblie的任务配置文件被称为playbook，俗称“剧本”，每一个剧本（playbook）中都包含了一系列的任务，这每个任务在ansible中又被称为“戏剧”（play），一个剧本中包含多出戏剧。。

　　前文我们了解了ansible有两种执行方式ad-hoc和ansible-playbook，ad-hoc主要用于临时命令的执行，而playbook我们可以理解为ad-hoc的集合，有点类似shell脚本，ad-hoc就相当于shell脚本里的某条任务语句，playbook就相当于整个shell脚本。playbook是由一个或多个“play”组成的列表，play的主要功能在于将预定义的一组主机，装扮成事先通过ansible中的task定义好的角色。task实际是调用ansible的一个模块，将多个play组织在一个playbook中，即可以让他们联合起来，按事先编排的机制执行预定义的动作。

 如以上图示，用户可以把多条任务（ad-hoc任务）写到playbook中，用户用ansible-playbook命令调用执行编排好的playbook,ansible会读取playbook中的每一条play和task，并按照playbook中的顺序从上至下依次执行，ansible会调用每个task中定义的模块去依次执行相应的任务，并按照playbook中指定的主机去主机清单里匹配对应的主机，然后通过ssh认证，把编译好的相应的任务文件发送到对应的主机或网络设备上执行，最后返回执行的状态。

　　二、YAML简介

　　playbook采用yaml语言编写，yaml是一个可读性高的用来表达资料序列格式的语言，它参考了其他很多种语言，包括：XML、C语言、python、perl以及电子邮箱格式RFC2822等。Clark Evans在2001年首次发表了这种语言，另外Ingy döt Net与Oren Ben-Kiki也是这语言的共同设计者。YAML（ YAML Ain't Markup Language），即yaml不是标记语言。不过在开发这种语言时，yaml的意思其实是："Yet Another Markup Language"（仍是一种标记语言）

　　ymal特性

　　1）YAML的可读性好

　　2）YAML和脚本语言的交互性好

　　3）YAML使用实现语言的数据类型

　　4）YAML有一个一致的信息模板

　　5）YAML易于实现，可以基于流程处理，表达能力强，扩展性好

更多的内容及规范请参考官方文档http://www.yaml.org

　　三、playbook语法简介

　　1）需要以“---”（3个减号）开始，且需顶行首写。另外还有选择性的连续三个点号（...）用来表示文件的结尾。

　　2）次行开始正常写playbook的内容，建议次行写该playbook的功能，当然不写也是可以的。

　　3）使用“#”号注释代码。

　　4）缩进必须统一，不能空格tab混用。

　　5）缩进的级别必须是一致的，同样的缩进代表同样级别，程序判别配置的级别是通过缩进结合换行来实现的。

　　6）YAML文件内容和Linux系统大小写判断方式一直，区分大小写（大小写敏感），k/v的值均大小写敏感。

　　7）k/v的值可同行写也可换行写。同行使用“：”分隔，换行写需要以“-”分隔。

　　8）v可以是字符串，也可以另外一个列表，当然也可以是字典。

　　9）一个完整的代码块功能最少需要有name:xxx（对任务的描述）。

　　10）一个name只能包括一个task

　　11）yaml文件扩展名通常为yml或yaml

list:列表，其所有元素均使用“-”开头

示例：

---
# A list of tasty fruits

- apple
- orange
- strawberry
- mango
~          　

dictionary:字典，通常由多个key与value构成

示例：

---
#An employee record
name: example developer
job: developer
skill: elite　　

当然也可以将key:value放置于{}中进行表示，用“，”分隔多个key:value

示例：

---
#An employee record
{name: example developer,job: developer, skill: elite}
~                                                       　　

　　YAML的语法和其他高阶语言类似，并且可以简单表达清单、散列表、标量等数据结构。其结构（Structure）通过空格来展示，序列（Sequence）里的项用"-"来代表，Map里的键值对用":"分隔。

示例：

---
name: John Smith
age: 41
gender: Male
spouse:
  name: Jane Smith
  age: 37
  gender: Female
children:
  - name: Jimmy Smith
    age: 17
    gender: Male
  - name: Jenny Smith
    age: 13
    gender: Female
~                    

　　四、playbook核心元素

　　1）hosts  ：指定执行任务的远程主机列表（主机清单定义的主机组或单个主机，支持前面的说的主机模式匹配）

　　2）tasks  ：任务集

　　3）varniables  ：内置变量或自定义变量在playbook中调用

　　4）templates  ：模板，可替换模板文件中的变量并实现一些简单逻辑的文件

　　5）handlers  和  notity结合使用，由特定条件出发的操作，满足条件方才执行，否则不执行

　　6）tags标签  ：给指定的任务贴上标签，我们在执行playbook的时候可以根据标签选择性的挑选部分代码执行，如 ansible-playbook -t tagsname useradd.yml  ,这条命令的意思就是在useradd.yml中挑选标签名为tagsname的任务执行

 　　五、playbook基础组件

　　1）hosts:

　　　　playbook中的每一个play的目的都是为了让特定主机以某个指定的用户身份执行任务。hosts用于指定要执行任务的主机，须事先定义在主机清单中。hosts指定主机的形式同样支持像主机清单中定义的那样，支持通配，支持主机模式匹配与或非，支持IP地址，当然也支持混合匹配与或非。

示例：在websers组，但不再dbsers组，可以这样定义hosts

---
- hosts: websers:!dbsers

　　2)remote_user：可用于host和task中，也可以通过指定其通过sudo的方式在远程执行任务，其可用于play全局或某个任务；此外，甚至可以在sudo时使用用sudo_user指定sudo时切换的用户，如下所示

---
- hosts: websers:!dbsers
  remote_user: root

  tasks:
    - name: test connection
      ping:
      remote_user: qiuhom
      sudo: yes
      sudo_user: qiuping

　　说明：默认sudo 为root，上例指定了sudo_user 为qiuping，上述任务同sudo -u qiuping ping xxxx（代表某主机）命令一样的意思，当然在使用sudo 时 我们还需要在目标主机上对qiuhom授权，要让qiuhom这个用户具有代表qiuping的权限去执行ping命令。

　　3）task列表和action：play的主体部分是task list，task list 中的各任务按次序逐个在hosts中指定的所有主机上执行，即在所有主机上完成第一个任务后，再开始第二个任务；task的目的是使用指定的参数执行模块，而在模块参数中可以使用变量，模块执行时是幂等的，这意味着多次执行时是安全的，其结果均一致；每个task都应该有其name，用于playbook的执行结果输出，建议其内容能清晰地描述任务步骤，如未提供name，则action的结果将用于输出。

　　tasks：任务列表,它有两种格式如下

　　　　（1）action: module arguments

　　　　（2）module： arguments        ##建议使用

 　　注意：shell模块和command模块后面跟的是命令，而非key=value

如果某项任务的状态在运行后为changed时，可通过“notify”通知给相应的handlers;当然任务可以通过“tags”打标签，可以在ansible-playbook命令上使用-t指定进行指定其标签名调用。

示例：

[qiuhom@test ~]$cat test.yml 
---
- hosts: websers:!dbsers
  remote_user: root

  tasks:
    - name: test connection
      ping:
      remote_user: qiuhom
      sudo: yes
      sudo_user: qiuping 
      tags: test
    - name: test command
      shell: /bin/ls /home/qiuhom/
[qiuhom@test ~]$ansible-playbook -t test test.yml 

　　说明：用-t 指定标签名，表示只运行所指定标签所在的任务，当然同名的标签可以在多条任务中，一个任务也可以有多个标签。

如果命令或脚本的退出码不为零，可用使用如下方式忽略或跳过继续执行以下代码

---
- hosts: websers:!dbsers
  remote_user: root

  tasks:
    - name: run this command and ignore the result
      shell: /usr/sbin/ip addr show eth0 || /bin/true
    - name: run this command and ignore the result
      shell: /usr/sbin/ip addr show eth0
      ignore_errors: True

　　说明：两种方式都可以跳过出错的命令而不打断playbook，继续执行以下的代码，前者使用的短路或的特性，后者使用ignore_errors参数来控制

　　六、playbook运行的方式

ansible-playbook <filename.yml> ... [options]

常用选项：

　　-C , --check  : 只检查可能会发生的改变，但不真正执行操作，相当于空跑一遍playbook，测试下是否和自己预想的结果一样，但它不会真正的去远端主机上执行。常用于测试写的playbook语法是否有误。

　　--list-hosts  :列出playbook指定运行任务所匹配的主机

　　--list-tags    :列出playbook中所有标签名称列表

　　--list-tasks  :列出playbook中所有任务名称及标签名称

　　--limit 主机列表   ：只针对指定主机列表中的主机执行当前playbook（指定主机列表必须是在playbook里定义的主机列表范围内）

　　-v,-vv,-vvv       :  显示执行playbook的过程，-v,显示较简单，-vv显示较详细，-vvv显示整个过程（非常详细）

[root@test ~]#cat test.yml 
---
- hosts: websers
  remote_user: root

  tasks:
    - name: run this command 
      shell: hostname
      tags: hostname
      ignore_errors: True
    - name: show ip addr
      shell: /sbin/ip addr show
      tags: showip
[root@test ~]#ansible-playbook test.yml --list-hosts

playbook: test.yml

  play #1 (websers): websers    TAGS: []
    pattern: [u'websers']
    hosts (2):
      192.168.0.128
      192.168.0.218
[root@test ~]#ansible-playbook test.yml --list-tags

playbook: test.yml

  play #1 (websers): websers    TAGS: []
      TASK TAGS: [hostname, showip]
[root@test ~]#ansible-playbook test.yml --list-tasks

playbook: test.yml

  play #1 (websers): websers    TAGS: []
    tasks:
      run this command  TAGS: [hostname]
      show ip addr      TAGS: [showip]
[root@test ~]#ansible-playbook test.yml --limit 192.168.0.218

PLAY [websers] ********************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************
ok: [192.168.0.218]

TASK [run this command] ***********************************************************************************************
changed: [192.168.0.218]

TASK [show ip addr] ***************************************************************************************************
changed: [192.168.0.218]

PLAY RECAP ************************************************************************************************************
192.168.0.218              : ok=3    changed=2    unreachable=0    failed=0   

[root@test ~]#ansible-playbook test.yml --limit 192.168.0.218 -v
Using /etc/ansible/ansible.cfg as config file

PLAY [websers] ********************************************************************************************************

TASK [Gathering Facts] ************************************************************************************************
ok: [192.168.0.218]

TASK [run this command] ***********************************************************************************************
changed: [192.168.0.218] => {"changed": true, "cmd": "hostname", "delta": "0:00:00.002139", "end": "2019-11-16 23:11:02.996962", "rc": 0, "start": "2019-11-16 23:11:02.994823", "stderr": "", "stderr_lines": [], "stdout": "localhost.localdomain", "stdout_lines": ["localhost.localdomain"]}

TASK [show ip addr] ***************************************************************************************************
changed: [192.168.0.218] => {"changed": true, "cmd": "/sbin/ip addr show", "delta": "0:00:00.002604", "end": "2019-11-16 23:11:03.733004", "rc": 0, "start": "2019-11-16 23:11:03.730400", "stderr": "", "stderr_lines": [], "stdout": "1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN 
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
    inet6 ::1/128 scope host 
       valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
    link/ether 00:0c:29:e8:f6:7b brd ff:ff:ff:ff:ff:ff
    inet 192.168.0.218/24 brd 192.168.0.255 scope global eth0
    inet6 fe80::20c:29ff:fee8:f67b/64 scope link 
       valid_lft forever preferred_lft forever
3: pan0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN 
    link/ether d2:7a:38:cf:27:60 brd ff:ff:ff:ff:ff:ff", "stdout_lines": ["1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN ", "    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00", "    inet 127.0.0.1/8 scope host lo", "    inet6 ::1/128 scope host ", "       valid_lft forever preferred_lft forever", "2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000", "    link/ether 00:0c:29:e8:f6:7b brd ff:ff:ff:ff:ff:ff", "    inet 192.168.0.218/24 brd 192.168.0.255 scope global eth0", "    inet6 fe80::20c:29ff:fee8:f67b/64 scope link ", "       valid_lft forever preferred_lft forever", "3: pan0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN ", "    link/ether d2:7a:38:cf:27:60 brd ff:ff:ff:ff:ff:ff"]}

PLAY RECAP ************************************************************************************************************
192.168.0.218              : ok=3    changed=2    unreachable=0    failed=0   

[root@test ~]#

　　说明：--limit 所指定的主机必须是在playbook中所指定的主机范围内。

 　　七、playbook vs shell scripts

　　1)shell脚本如下：

#!/bin/bash
# 安装Apache
yum install --quiet -y httpd
# 复制配置文件
cp /tmp/httpd.conf /etc/httpd/conf/httpd.conf
cp/tmp/vhosts.conf /etc/httpd/conf.d/
# 启动Apache，并设置开机启动
service httpd start
chkconfig httpd on

　　2）playbook

---
- hosts: websers
  remote_user: root

  tasks:
    - name: create apache group
      group: name=apache gid=80 system=yes
    - name: create apache user
      user: name=apache uid=80 group=apache system=yes shell=/sbin/nologin home=/var/www/html 
    - name: install httpd
      yum: name=httpd
    - name: copy config file
      copy: src=/tmp/httpd.conf dest=/etc/httpd/conf/
    - name: copy config 2 file
      copy: src=/tmp/vhosts.conf dest=/etc/httpd/conf.d/
    - name: start httpd service
      service: name=httpd state=started enabled=yes     

　　说明：两者都是实现同样的目的，很明显playbook的优势要比脚本的优势多，playbook 可以针对很多台主机进行任务执行，而脚本只可以在某一台主机上执行；脚本重复执行没有幂等性，很有可能带来很多错误，而playbook却不会有这样的苦恼。