Ansibile之playbook初识

时间 2019-11-17

标签 ansibile playbook 繁體版

原文原文链接

　　1、playbook简介html

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

　　前文咱们了解了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中，便可以让他们联合起来，按事先编排的机制执行预约义的动做。web

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

　　2、YAML简介apache

　　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特性bash

　　1）YAML的可读性好网络

　　2）YAML和脚本语言的交互性好数据结构

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

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

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

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

　　3、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
~

　　4、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的任务执行

　　5、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参数来控制

　　6、playbook运行的方式

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

经常使用选项：

　　-C , --check : 只检查可能会发生的改变，但不真正执行操做，至关于空跑一边playbook，测试下是否和本身预想的结果同样，但它不会真正的去远端主机执行。经常使用语测试写的playbook语法是否有误。

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

　　--list-tags :列出playbook中全部tag名称

　　--list-tasks :列出playbook中全部任务名称

　　--limit 主机列表：只针对指定主机列表中的主机执行当前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 \n    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00\n    inet 127.0.0.1/8 scope host lo\n    inet6 ::1/128 scope host \n       valid_lft forever preferred_lft forever\n2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000\n    link/ether 00:0c:29:e8:f6:7b brd ff:ff:ff:ff:ff:ff\n    inet 192.168.0.218/24 brd 192.168.0.255 scope global eth0\n    inet6 fe80::20c:29ff:fee8:f67b/64 scope link \n       valid_lft forever preferred_lft forever\n3: pan0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN \n    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中说指定的主机范围内。

　　7、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却不会有这样的苦恼。