ansible-playbook介绍


1、playbook简介

    playbook是ansible用于配置、部署和管理被控节点的剧本，通过playbook的详细描述，执行其中的一系列tasks，可以让远程主机达到预期的状态，playbook就像Ansible控制器给被控节点列出的一系列to-do-list，而被控节点必须要完成。

     也可以这样理解，playbook字面意思，即剧本，现实中由演员按照剧本表演，在ansible中，这次是由计算机进行表演，由计算机安装，部署应用，提供对外服务，以及组织计算机处理各种各样的事情。


2、playbook使用场景

    执行一些简单的任务，使用ad-hoc命令可以方便的解决问题，但是有时一个设施太过于复制，需要大量的操作时，执行ad-hoc命令就不太合适，这时最好使用playbook，就像执行shell命令与写shell脚本一样，也可以理解为批处理任务，不过playbook有自己的语法格式，具体可以看下面介绍。

    使用playbook你可以方便的重用这些代码，可以移值到不同的机器上面，像函数一样，最大化的利用代码。在使用ansible的过程中，所处理的大部分操作都是需要编写playbook的。


3、YAML语法

    playbook由YMAL语言编写，YMAL参考了其他多种语言，包括：XML、C语言、python、perl以及电子邮件格式RFC2822，Clark Evans在2001年5月在首次发表了这种语言，另外Ingy dot Net与Oren Ben-Kiki也是这种语言的共同设计者。

    YAML介绍：yaml是一个可读性高的用来表达资料序列的格式。YAML Ain't Markup Language,即YAML不是XML。不过，在开发的这种语言时，YAML的意思其实是：“Yet Another Markup Language"(仍是一种标记语言）。其特性：    

   YAML的可读性好。
   YAML和脚本语言的交互性好
   YAML使用实现语言的数据类型
   YAML有一个一致的信息模型
   YAML易于实现
   YAML可以基于流来处理
   YAML表达能力强

更多的规范参见：http://www.yaml.org。

    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

YAML文件扩展名通常为.yaml,如example.yaml。


4、ansible-playbook语法

   playbook是又一个或多个"play"组成的列表。play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。从根本上来讲，所谓task无非是调用ansible的一个module。将多个play组织在一个playbook中，即可以让他们联同起来按事先编排的机制同唱一台大戏。下面是一个简单示例：

    

        - hosts: webnodes
	  vars:
	    http_port: 80
	    max_clients: 256
	  remote_user: root
	  tasks:
	  - name: ensure apache is at the latest version
	    yum: name=httpd state=latest
	  - name: ensure apache is running
	    service: name=httpd state=started
	  handlers:
	    - name: restart apache
	      service: name=httpd state=restarted


5、playbook基础组件

hosts：playbook中的每一个play的目的都是为了让某个或某些以某个指定用户的身份执行任务。
       hosts用于指定要执行指定任务的主机，其可以是一个或多个由冒号分隔主机组。

user:remote_user则用于指定远程主机上的执行任务的用户。

任务列表：play的主体部分是task list. task list中的各任务按次序逐个在hosts中指定的所有主机
          上执行，即在所有主机上完成第一个任务后再开始第二个。

action:任务执行过程

handlers:用于当前关注的资源发生变化时采取一定指定的操作


实例：

[root@mail ~]# cat web.yml
- hosts: webservers  ##主机组，在/etc/ansible/hosts中定义
  remote_user: root  ##远程执行任务的用户
  tasks:   ##任务
  - name: install httpd   ##任务描述
    command: yum -y install httpd  ##调用ansible的command模块安装httpd
  - name: provide httpd.conf   ##任务描述
    copy: src="/root/httpd.conf" dest="/etc/httpd/conf/httpd.conf"  ##调用ansible的copy模块，httpd安装完成后将事先准备好的httpd.conf文件复制到目标主机的/etc/httpd/conf/目录下
    tags: conf  ##给此任务打标记，可单独执行标记的任务，使用ansible-playbook -C 命令执行
    notify:  ##文件内容变更通知
    - server restart  ##通知到指定的任务
  - name: server start  ##任务描述
    service: name=httpd state=started enabled=true  ##调用ansible的service模块的属性定义安装完成httpd以后httpd服务的管理
  handlers:  ##定义接受关注的资源变化后执行的动作
  - name: server restart  ##任务描述
    service: name=httpd state=restarted  ##当关注的资源发生变化后调用service模块，采取相应的动作
 
##执行过程如下：
[root@mail ~]# ansible-playbook web.yml

PLAY [webservers] ************************************************************* 

GATHERING FACTS *************************************************************** 
ok: [node2]
ok: [node1]

TASK: [install httpd] ********************************************************* 
changed: [node2]
changed: [node1]

TASK: [provide httpd.conf] **************************************************** 
changed: [node2]
changed: [node1]

TASK: [server start] ********************************************************** 
changed: [node2]
changed: [node1]

NOTIFIED: [server restart] **************************************************** 
changed: [node2]
changed: [node1]

PLAY RECAP ******************************************************************** 
node1                      : ok=5    changed=4    unreachable=0    failed=0   
node2                      : ok=5    changed=4    unreachable=0    failed=0


6、ansible的roles介绍

    ansible的roles用于层次性、结构化的组织playbook。roles能够根据层次型结构自动装载变量文件、tasks及handlers等。要使用roles只需要playbook中使用include指令即可。

1）、创建roles的步骤
   （1）、创建以roles命名的目录；
   （2）、在roles目录中分别创建以各角色名称命名的目录，如webservers等；
   （3）、在每个角色命名的目录中分别创建files、handlers、meta、tasks、templates、和vars
          目录；用不到的目录可以创建为空目录，也可以不创建。
   （4）、在playbook文件中，调用各角色；
2）、roles内各目录可用的文件
    tasks目录：至少应该包括一个名为main.yml的文件，其定义了此角色的任务列表；此文件可以使
               用include包含其它的位于此目录中的task文件。
    files目录：存放由copy或script等模块调用的文件；
    templates目录：template模块会自动在此目录中寻找jinja2模版文件；
    handlers目录：此目录中应当包含一个main.yml文件，用于定义此角色用到的各handler;在handl
                  er中使用include包含的其它的handler文件也应该位于此目录中；
    vars目录：应当包含一个main.yml文件，用于定义此角色用到的变量；
    meta目录：应当包含一个main.yml文件，用于定义此角色的特殊设定及其依赖关系；
    default目录：为当前角色设定默认变量时使用此目录；应当包含一个main.yml文件；
3）、举例说明
root@mail playbook]# tree  roles/
    roles/ \\ansible所有的信息都放到此目录下面对应的目录中
    └── nginx  \\角色名称
        ├── default  \\为当前角色设定默认变量时使用此目录，应当包含一个main.yml文件；
        ├── files  \\存放有copy或script等模块调用的文件
        ├── handlers \\此目录总应当包含一个main.yml文件，用于定义各角色用到的各handler
        ├── meta \\应当包含一个main.yml，用于定义角色的特殊设定及其依赖关系；1.3及以后
                      版本支持
        ├── tasks \\至少包含一个名为main.yml的文件，定义了此角色的任务列表，可使用incl
                       ude指令
        ├── templates \\template模块会自动在此目录中寻找Jinja2模板文件
        └── vars  \\应当包含一个main.yml文件，用于定义此角色用到的变量

ansible的roles配置nginx

1、准备目录
# mkdir -pv playbook/roles/nginx/{default,files,handlers,meta,tasks,templates,vars}
2、准备nginx的配置文件
# cd roles/nginx/templates
# ansible all -m setup |grep ansible_processor_cores
        "ansible_processor_cores": 1,  \\获取ansible的要调用的相关函数
        "ansible_processor_cores": 1,  \\获取ansible的要调用的相关函数
# vim nginx.conf
worker_processes {{ ansible_processor_cores }}; \\调用获取到的函数
3、准备Nginx的default.conf文件及rpm包
# ll nginx/files/
-rw-r--r-- 1 root root   2685 Jan 18 15:51 default.conf
-rw-r--r-- 1 root root 319456 Jan 18 15:52 nginx-1.4.7-1.el6.ngx.x86_64.rpm
4、在tasks目录中配置任务列表
# cd nginx/tasks/
# vim main.yml
 - name: copy nginx.rpm
    copy: src=nginx-1.4.7-1.el6.ngx.x86_64.rpm  dest=/tmp/nginx-1.4.7-1.el6.ngx.x86_64.rpm
  - name: install nginx
    shell: yum -y  install /tmp/nginx-1.4.7-1.el6.ngx.x86_64.rpm
  - name: provides nginx.conf
    template: src=nginx.conf  dest=/etc/nginx/nginx.conf
    tags: nginxconf
    
    notify:
    - server restart
  - name: provides default.conf
    copy: src=default.conf dest=/etc/nginx/conf.d/default.conf 
    tags: nginxconf
  - name: server start
    service: name=nginx enabled=true state=started
5、在handlers目录中配置定义handler信息
# cd nginx/handlers/
# vim main.yml
- name: server restart
  service: name=nginx  state=restarted
6、在roles同一级目录中创建site.yml文件
- hosts: webservers
  remote_user: root
  roles:
  - nginx
7、应用配置
# ansible-playbook site.yml 

PLAY [webservers] ************************************************************* 

GATHERING FACTS *************************************************************** 
ok: [node2]
ok: [node1]

TASK: [nginx | copy nginx.rpm] ************************************************ 
ok: [node1]
ok: [node2]

TASK: [nginx | install nginx] ************************************************* 
changed: [node1]
changed: [node2]

TASK: [nginx | provides nginx.conf] ******************************************* 
changed: [node2]
changed: [node1]

TASK: [nginx | provides default.conf] ***************************************** 
changed: [node2]
changed: [node1]

TASK: [nginx | server start] ************************************************** 
changed: [node2]
changed: [node1]

NOTIFIED: [nginx | server restart] ******************************************** 
changed: [node1]
changed: [node2]

PLAY RECAP ******************************************************************** 
node1                      : ok=7    changed=5    unreachable=0    failed=0   
node2                      : ok=7    changed=5    unreachable=0    failed=0   
8、查看webservers主机上是否已经启动nginx
# ansible webservers -m shell -a 'netstat -tnlp'
node2 | success | rc=0 >>
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address               Foreign Address             State       PID/Program name   
tcp        0      0 0.0.0.0:80                  0.0.0.0:*                   LISTEN      5497/nginx          
tcp        0      0 0.0.0.0:22                  0.0.0.0:*                   LISTEN      1174/sshd           
tcp        0      0 :::22                       :::*                        LISTEN      1174/sshd           

node1 | success | rc=0 >>
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address               Foreign Address             State       PID/Program name   
tcp        0      0 0.0.0.0:80                  0.0.0.0:*                   LISTEN      5513/nginx          
tcp        0      0 0.0.0.0:22                  0.0.0.0:*                   LISTEN      1174/sshd           
tcp        0      0 :::22                       :::*                        LISTEN      1174/sshd     
9、查看playbook目录总体结构：
# tree playbook/
playbook/
├── roles
│   └── nginx
│       ├── default
│       ├── files
│       │   ├── default.conf
│       │   └── nginx-1.4.7-1.el6.ngx.x86_64.rpm
│       ├── handlers
│       │   └── main.yml
│       ├── meta
│       ├── tasks
│       │   └── main.yml
│       ├── templates
│       │   └── nginx.conf
│       └── vars
└── site.yml

到此，ansible-playbook已总计完毕，仅个人总结学习。如有疑问，请查官方文档。也可交流，主要个人技术暂时还不强悍。。。大神吾喷。。。