1  概述

Playbook组织格式是YAML格式，编排的是任务（task）,用来记录重复执行的命令  

YAML：YAML（/ˈjæməl/，尾音类似camel骆驼）是一个可读性高，用来表达数据序列的格式。YAML参考了其他多种语言，包括：C语言、Python、Perl，并从XML、电子邮件的数据格式（RFC 2822）中获得灵感。Clark Evans在2001年首次发表了这种语言，另外Ingy döt Net与Oren Ben-Kiki也是这语言的共同设计者。目前已经有数种编程语言或脚本语言支持（或者说解析）这种语言。

YAML是"YAML Ain't a Markup Language"（YAML不是一种标记语言）的递归缩写。在开发的这种语言时，YAML 的意思其实是："Yet Another Markup Language"（仍是一种标记语言），但为了强调这种语言以数据做为中心，而不是以标记语言为重点，而用反向缩略语重命名。  

YAML的语法和其他高级语言类似，并且可以简单表达清单、散列表，标量等数据形态。它使用空白符号缩进和大量依赖外观的特色，特别适合用来表达或编辑数据结构、各种配置文件、倾印除错内容、文件大纲（例如：许多电子邮件标题格式和YAML非常接近）。

基本数据结构：

    标量、数组、关联数组

表量：直接值

数组：用花括号组成的键值对

2  playbook的基础组件

1)Hosts：运行指定任务的目标主机；

2)remoute_user: 在远程主机上执行任务的用户；

    sudo_user：

3)tasks：任务列表

    模块，模块参数；

    格式：

        (1) action: module arguments

        (2) module: arguments

        注意：shell和command模块后面直接跟命令，而非key=value类的参数列表；

        (1) 某任务的状态在运行后为changed时，可通过“notify”通知给相应的handlers；

         (2) 任务可以通过"tags“打标签，而后可在ansible-playbook命令上使用-t指定进行调用；

4)handlers：

     任务，在特定条件下触发；

     接收到其它任务的通知时被触发；

         notify: HANDLER TASK NAME

5)variables：

    (1) facts：可直接调用；

        注意：可使用setup模块直接获取目标主机的facters；

例子

收集172.18.50.72内置变量,通过setup模块实现收集主机的变量

ansible 172.18.50.72 -m setup

    (2) 用户自定义变量：

     两种设定的方式

         (a) ansible-playbook命令的命令行中的，-e可以重复使用

-e VARS, --extra-vars=VARS

         

         (b) 在playbook中定义变量的方法：

             vars:

             - var1: value1

             - var2: value2

变量引用：{{ variable }}，变量两侧有空格

(3) 通过roles传递变量；

    (4) Host Inventory

         (a) 用户自定义变量

(i) 向不同的主机传递不同的变量；

IP/HOSTNAME  varaiable=value var2=value2

(ii) 向组中的主机传递相同的变量；

[groupname:vars]

variable=value

(b) invertory参数

用于定义ansible远程连接目标主机时使用的参数，而非传递给playbook的变量；

ansible_ssh_host

ansible_ssh_port

ansible_ssh_user

ansible_ssh_pass

3  运行playbook的方式

(1) 测试

ansible-playbook  --check

只检测可能会发生的改变，但不真正执行操作；

ansible-playbook  --list-hosts

例子

ansible-playbook --list-hosts installpkg.yml 

列出运行任务的主机；

ansible-playbook  --syntax-check

检查语法，没有输出表示没有语法错误

ansible-playbook  --syntax-check installpkg.yml

(2) 运行

ansible-playbook  脚本

例子：

ansible-playbook  installpkg.yml

4  例子


例一：编写一个yaml文档，用来安装redis和ngnix服务，并启动相关服务

注意，语法里有横线用来引导，区分不同的功能的语句，如下面语句有多个hosts,因此在hosts前加横杆，tasks有多个，用横杆区分每个tasks，而且缩进是有要求的，同一层级，一般缩进一样。注意横杆和冒号后有空格。

vim installpkg.yaml
- hosts: websrvs
  remote_user: root
  tasks:
  - name: install nginx package
    yum: name=nginx state=latest
  - name: start nginx service
    service: name=nginx enabled=true state=started
- hosts: dbsrvs
  remote_user: root
  tasks:
  - name: install redis package
    yum: name=redis state=latest
  - name: install conf file
    copy: src=/root/redis.conf dest=/etc/redis.conf owner=redis group=root mode=644
  - name: start redis service
    service: name=redis state=started

准备redis的配置模板

更改redis配置模板监听端口为0.0.0.0 和 端口为6380

vim  redis.conf
vim /root/redis.conf
bind 0.0.0.0
port 6380

查看playbook里的主机

ansible-playbook --list-hosts installpkg.yml

查看playbook里的tasks

ansible-playbook --list-tasks installpkg.yml

测试执行脚本，添加选项-C,并没有实际执行

ansible-playbook -C installpkg.yml

以上脚本，测试正常的话，就去掉-C选项，实际执行

ansible-playbook  installpkg.yml

例二：handler的使用

条件式触发：handler,满足条件的时候触发条件

handlers:处理器，配置文件被修改的时候才执行，条件定义在notify

以下命令，表示当配置文件被更改的时候，notify就会触发handler,实现重启的操作.注意格式的书写。

vim  /root/ansible/handler.yml
- hosts: websrvs
  remote_user: root
  tasks:
  - name: install nginx package
    yum: name=nginx state=latest
  - name: start nginx service
    service: name=nginx enabled=true state=started
- hosts: dbsrvs
  remote_user: root
  tasks:
  - name: install redis package
    yum: name=redis state=latest
  - name: install conf file
    copy: src=/root/redis.conf dest=/etc/redis.conf owner=redis group=root mode=644
    tags: instconf
    notify: restart redis service
  - name: start redis service
    service: name=redis state=started
  handlers: 
  - name: restart redis service
    service: name=redis state=restarted

例三：tag的使用

更改websrvs的配置内容，设置tag为instnginx

vim  /root/ansible/installpkg.yml
- hosts: websrvs
  remote_user: root
  tasks:
  - name: install nginx package
    yum: name=nginx state=latest
    tags: instnginx
  - name: start nginx service
    service: name=nginx enabled=true state=started
- hosts: dbsrvs
  remote_user: root
  tasks:
  - name: install redis package
    yum: name=redis state=latest
  - name: install conf file
    copy: src=/root/redis.conf dest=/etc/redis.conf owner=redis group=root mode=644
    tags: instconf
    notify: restart redis service
  - name: start redis service
    service: name=redis state=started
  handlers: 
  - name: restart redis service
    service: name=redis state=restarted

查看任务，会显示对应的标签

ansible-playbook --list-tasks installpkg.yml

指定标签，可以重新跑指定的标签命令,如他部分的命令不执行，如这里指定tag为instnginx，则只安装nginx包，但是不启动服务，其他部分的命令不会执行

ansible-playbook -t instnginx installpkg.yml

同时跑多个标签，多个任务可以指定同一标签，比较灵活 。如以下配置中，把安装不同的服务包的tag都设置为instpkg，同时设置了 复制dbsrvs组的配置文件，设备复制文件的tag为instconf,同时执行多个tag间用逗号隔开

vim  /root/ansible/installpkg.yml
- hosts: websrvs
  remote_user: root
  tasks:
  - name: install nginx package
    yum: name=nginx state=latest
    tags: instpkg
  - name: start nginx service
    service: name=nginx enabled=true state=started
- hosts: dbsrvs
  remote_user: root
  tasks:
  - name: install redis package
    yum: name=redis state=latest
    tags: instpkg
  - name: install conf file
    copy: src=/root/redis.conf dest=/etc/redis.conf owner=redis group=root mode=644
    tags: instconf
    notify: restart redis service
  - name: start redis service
    service: name=redis state=started
  handlers: 
  - name: restart redis service
    service: name=redis state=restarted

执行如下

ansible-playbook -t instpkg,instconf installpkg.yaml

结果是websrvs组只安装nginx，但是没有启动nginx服务，同时dbsrvs安装了redis包而且复制了配置文件到对应的主机，而且在install conf file任务中配置了notify任务，所以dbsrvs组的redis服务会被启动

例四：变量的使用

通过变量pkgname安装相关的包

vim installvar.yml 
- hosts: websrvs
  remote_user: root
  vars:
  - pkgname: tree
  tasks:
  - name: install package
    yum: name={{ pkgname }} state=latest

运行脚本，不指定变量默认是安装tree

ansible-playbook  installvar.yml

指定变量，playbook命令行里定义的变量优先级比脚本里高，  这里会安装memcached,而不是脚本里的tree

ansible-playbook -e "pkgname=memcached"  installvar.yaml

直接在host里定义变量，但是这个变量级别很低，比脚本里的变量还低

vim /etc/ansible/hosts 
[websrvs]
172.18.50.72 pkgname=redis
172.18.50.75 pkgname=memcached
vim /root/ansible/installvar.yml 
- hosts: websrvs
  remote_user: root
  vars:
  - pkgname: tree
  tasks:
  - name: install package
    yum: name={{ pkgname }} state=latest

执行命令

ansible-playbook  installvar.yaml

则websrvs安装的服务包是tree,而不是/etc/ansible/hosts里赋值的变量

去掉脚本里的变量

vim /root/ansible/installvar.yaml 
- hosts: websrvs
  remote_user: root
  tasks:
  - name: install package
    yum: name={{ pkgname }} state=latest

重新执行

ansible-playbook  installvar.yml

则72主机安装服务包redis,75主机安装memcached

例五：在配置文件里传递参数

vim /etc/ansible/hosts
[websrvs]
172.18.50.72 pkgname=redis ansible_ssh_user=root ansible_ssh_pass=Pass123456
172.18.50.75 pkgname=memcached