标签:模式匹配 yum example unknown mod art fifo 组成 apache
一、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中所有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中说指定的主机范围内。
七、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却不会有这样的苦恼。
标签:模式匹配 yum example unknown mod art fifo 组成 apache
原文地址:https://www.cnblogs.com/qiuhom-1874/p/11871741.html