YAML简介
YAML是一个可读性高的用来表达资料序列的格式。
YAML参考了其他多种语言,包括:XML、C语言、Python、Perl以及电子邮件格式RFC2822等。
Clark Evans在2001年在***发表了这种语言,另外Ingy döt Net与Oren Ben-Kiki也是这语言的共同设计者。
YAML Ain't Markup Language,即YAML不是XML。不过,在开发的这种语言时,YAML的意思其实是:"Yet Another Markup Language"(仍是一种标记语言)。
其特性包括:
- YAML的可读性好
- YAML和脚本语言的交互性好
- YAML使用实现语言的数据类型
- YAML有一个一致的信息模型
- YAML易于实现
- YAML可以基于流来处理
- YAML表达能力强,扩展性好
YAML语法
YAML的语法和其他高阶语言类似,并且可以简单表达清单、散列表、标量等数据结构。
其结构(Structure)通过空格来展示,序列(Sequence)里的项用"-"来代;Map里的键值对用":"分隔。
YAML文件扩展名通常为.yaml或者.yml。
下面是一个示例。
2 个重要的结构组成部分:list和directory
list 列表的所有元素均使用“-”打头,例如:
dictionary字典通过key与valuef进行标识,例如:
也可以将key:value放置于{}中进行表示,例如:
多个映射关系组成一个字典,一个列表可以包含多个字典。
YAML中的变量
变量命名
变量名仅能由字母、数字和下划线组成,且只能以字母开头。
facts
facts是由正在通信的远程目标主机发回的信息,这些信息被保存在ansible变量中。
要获取指定的远程主机所支持的所有facts,可使用如下命令进行:
- # ansible hostname -m setup
这个命令可以获得被监控端主机的各种信息,将这些信息得到后保存到变量中。
自定义变量在 yaml 中可以使用vars关键字来定义变量:
变量的引用
特殊的变量,迭代
当有需要重复性执行的任务时,可以使用迭代机制。
其使用格式为将需要迭代的内容定义为item变量引用,并通过with_items语句来指明迭代的元素列表即可。
示例:
例如:在被控端添加 2 个用户 方式
1:一般做法
方式1:使用变量方式
方式2:使用迭代方式
事实上,with_items中可以使用元素还可为hashes,例如:
Inentory文件的格式
inventory文件遵循INI文件风格,中括号中的字符为组名。
可以将同一个主机同时归并到多个不同的组中;此外,当如若目标主机使用了非默认的SSH端口,还可以在主机名称之后使用冒号加端口号来标明。
如果主机名称遵循相似的命名模式,还可以使用列表的方式标识各主机,例如:
主机变量
可以在inventory中定义主机时为其添加主机变量以便于在playbook中使用。例如:
组变量组变量是指赋予给指定组内所有主机上的在playbook中可用的变量。例如:
组嵌套 inventory中,组还可以包含其它的组,并且也可以向组中的主机指定变量。不过,这些变量只能在ansible-playbook中使用,而ansible不支持。例如:
inventory参数 ansible基于ssh连接inventory中指定的远程主机时,还可以通过参数指定其交互方式;
常用的参数如下所示:
ansible的循环机制还有更多的高级功能,你可以进行一下尝试。
playbooks
playbook是由一个或多个“play”组成的列表。
play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。
从根本上来讲,所谓task无非是调用ansible的一个module。
将多个play组织在一个playbook中,即可以让它们联同起来按事先编排的机制同唱一台大戏。
playbook基础组件
1、Hosts和Users
playbook中的每一个play的目的都是为了让某个或某些主机以某个指定的用户身份执行任务。
hosts用于指定要执行指定任务的主机,其可以是一个或多个由冒号分隔主机组。
remote_user则用于指定远程主机上的执行任务的用户。 不过,remote_user也可用于各task中。也可以通过指定其通过sudo的方式在远程主机上执行任务,其可用于play全局或某任务。此外,甚至可以在sudo时使用sudo_user指定sudo时切换的用户。
2、任务列表和action
play的主体部分是task list。
task list中的各任务按次序逐个在hosts中指定的所有主机上执行,即在所有主机上完成***个任务后再开始第二个。
在运行自下而下某playbook时,如果中途发生错误,所有已执行任务都将回滚,因此,在更正playbook后重新执行一次即可。
task的目的是使用指定的参数执行模块,而在模块参数中可以使用变量。
模块执行是幂等的,这意味着多次执行是安全的,因为其结果均一致。
每个task都应该有其name,用于playbook的执行结果输出,建议其内容尽可能清晰地描述任务执行步骤。如果未提供name,则action的结果将用于输出。
定义task的可以使用“action: module options”或“module: options”的格式,推荐使用后者以实现向后兼容。如果action一行的内容过多,也中使用在行首使用几个空白字符进行换行。
在众多模块中,只有command和shell模块仅需要给定一个列表而无需使用“key=value”格式,例如:
如果命令或脚本的退出码不为零,可以使用如下方式替代:
或者使用ignore_errors来忽略错误信息:
3、handlers
用于当关注的资源发生变化时采取一定的操作。
“notify”这个action可用于在每个play的***被触发,这样可以避免多次有改变发生时每次都执行指定的操作,取而代之,仅在所有的变化发生完成后一次性地执行指定操作。
在notify中列出的操作称为handler,也即notify中调用handler中定义的操作。
handler是task列表,这些task与前述的task并没有本质上的不同。
tags
tags用于让用户选择运行或路过playbook中的部分代码。ansible具有幂等性,因此会自动跳过没有变化的部分,即便如此,有些代码为测试其确实没有发生变化的时间依然会非常地长。
此时,如果确信其没有变化,就可以通过tags跳过此些代码片断。
示例:基于playbooks实现web服务的部署
1、提供好Inventory文件
2、编辑 palybooks 剧本
3、准备好配置文件 将web的配置放到指定目录 src=/root/httpd.conf4、开始部署
结果示例:
查看端口:
此时如果配置文件发生变化:
至此基本使用配置完成。