4、yaml语法应用
ansible的playbook编写是yaml语言编写,掌握yaml语法是编写playbook的必要条件,格式要求和Python相似,具体教程参考如下
yaml语言教程 附上一个yaml文件转js格式文件链接
在线免费yaml内容转json格式
4.1、 ansible中的yaml语法应用
ansible中yaml语法和上述教程大同小异,以下是个人简化和总结:
基本语法规则如下
以 "---" 开头
大小写敏感
使用缩进表示层级关系
缩进时不允许使用Tab键,只允许使用空格
缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
'#' 号表示注释,从这个字符一直到行尾,都会被解析器忽略;可以在一行的中间使用,注释 # 之后的内容。关于注释,需要注意是不是任意位置都能使用,当分行写时,不能放在分行的所在行
YAML 支持的数据结构有三种:
对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
数组:一组按次序排列的值,又称为序列(sequence) / 列表(list),以 "- " 开头,有空格间隔
纯量(scalars):单个的、不可再分的值(ansible中很少用到)
4.2、对象简介
ansible中yaml对象和计算机的中是"key-value"数据结构相似,只是表达的方式不同,在ansible中,对可以采用两种表达方式。切记 : (冒号)之后一定要加空格,否则报错
# 多行式
host: localhost
remote_user: root
# 行内式,也称为单行式,两边是大括号包围
{ host: localhost, remote_user: root }
注意
- 在一行表示中,字典的值,可以嵌套其他字典,但是需要用引号包围起来代表一个整体值,返回的是整体而且不是直接嵌套字典,下面引号部分会给实际案例解释。
- 冒号加空格加内容即": haha"这个格式代表的是字典的表达式,这个是yaml语法规定的;冒号加内容即":haha",代表的是普通的表达式,没有特殊意义,所以定义对象需要注意,但是这种普通表达式,有一些情况会用到,例如下文中引号的例子中
4.3、数组简介
在ansible中数组也称为列表,以 "- " 开头,有空格间隔,同样有两种表达方式。
# 多行式
- shell
- copy
# 单行式,内联式,两边用中括号包围
[shell, copy]
4.4、分行写
playbook中的分行写支持三种格式,分别是:
在"key"之后使用 "|", 表示保留换行
在"key"之后使用 ">" ,表示折叠换行
采用多行缩进格式,建议从缩进的第二行用 四个 空格表示缩进。需要注意注释的位置
# 以下例子表示三种不同的分行写格式,注意看区别
---
- hosts: lzcx
tasks:
- shell: echo 'Hello world' >> /tmp/test.txt
creates=/tmp/haha.txt # 分行写注意缩进,同时这行的注释不能放到上一行,否则报错
- shell: | # 冒号之后要有空格
echo '张三' >> /tmp/test.txt
echo '李四' >> /tmp/test.txt
args:
creates: /tmp/haha.txt
- shell: > # 大于号之后要有空格
echo '王五' >> /tmp/test.txt
creates: /tmp/haha.txt
运行效果图
4.5、向模块传递参数
模块的参数⼀般来说是key=value格式的,有3种传递的⽅式:
直接写在模块后,此时要求使⽤"key=value"格式。这是让ansible内部去解析字符串。因为可分⾏写,所以有多种写法
写成字典型,即"key: value"。此时要求多层缩进。这是让yaml去解析字典。shell和command模块不能使用这种格式
使⽤内置属性args,然后多层缩进定义参数列表。这是让ansible明确指定⽤yaml来解析
# 参数的多种格式
---
- hosts: lzcx
tasks:
- shell: echo '1' > /tmp/test.txt creates=/tmp/haha.txt # 单行格式
- shell: echo '2' >> /tmp/test.txt
creates=/tmp/haha.txt # 多行格式,注意缩进,,同时这行的注释不能放到上一行,否则报错
- shell: echo '3' >> /tmp/test.txt
args:
creates: /tmp/haha.txt # 使用内置args参数
- shell: >
echo '4' >> /tmp/test.txt
creates=/tmp/haha.txt # 大于号多行缩进模式
- shell: |
echo '5.1' >> /tmp/test.txt
echo '5.2' >> /tmp/test.txt
args:
creates: /tmp/haha.txt
- yum:
name: dos2unix
state: installed
4.6、playbook中的引号使用
引号的作用,可以将一个字典中的value值表达式当作整体返回,这个表达式里面可以嵌套字典,playbook中定义的都是些列表和字典。绝⼤多数时候,都不需要使⽤引号,但有两个特殊情况需要考虑使⽤引号
出现⼤括号"{}"
值(value)出现冒号加空格时": ",即嵌套字典时,需要将嵌套的部分用引号当作整体返回
# 附上一个综合例子,注意每个模板内容的区别
---
- hosts: localhost
tasks:
- shell: echo {{inventory_hostname}}:haha
- shell: "echo {{inventory_hostname}}:haha"
- shell: 'echo {{inventory_hostname}}:haha'
- shell: 'echo "{{inventory_hostname}}: haha"'
- shell: echo "{{inventory_hostname}}:haha"
register: hello
- debug: 'msg="{{hello.stdout}}: heihei"'
- shell: echo {{inventory_hostname}}:haha
register: hello1
- debug: msg={{hello1.stdout}}:heihei
解释
- 前面三个shell模块,字典的value都是普通的表达式,有引号和无引号,结果是一样的,需要注意的是":"冒号之后没有空格,而是直接跟上内容,这种表达式不是字典,实际上可以把这个冒号当作普通的字符串看待
- 第四个shell模块中,因为value值嵌套了字典,而且还使用了大括号引用变量,这种表达式需要将整个表达
式括起来,因此需要用单引号将整个表达式括起来,用整体当作一个值赋值给模块。理解这两点剩下的模块也是一样的意思 - 从打印的结果看,": "和":"的区别是,当字典的值嵌套了字典时,即使用": "时,打印也会按照这个格式打印,也就是冒号的下一个字符串是空格,而":"这个普通的格式则是跟上内容
4.7、playbook和play的关系
⼀个playbook中可以包含多个play。每个play都⾄少包含有tasks和hosts这两项,还可以包含其他⾮必须项,如vars,vars_f iles,remote_user等。tasks中可以通过模块调⽤定义⼀系列的action。只不过,绝⼤多数时候,⼀个playbook都只定义⼀个play,这样做的好处是便于维护。
playbook文件中基本结构为:
playbook: [play1, play2, play3]
play: [hosts, gather_facts, connection, become, remote_user, tasks, vars...]
tasks: [变量vars、循环with_xxx、判断when、命名name、module1, module2,...]
需要注意的是,当play使用了role时,看上去没有tasks和hosts选项,实际上role里面包含了,所以有没有tasks和hosts没关系,但没有使用role时,一定要有
4.8、yaml编写总结
- 缩进:关于缩进,空格的多少无关,注重的是层级一致性,个人习惯缩进4或2个空格区分
- 对象的冒号:列表编写,"-"加内容编写完之后,换行时会自动对齐到"-"列,这是错误的,需要手动对齐"- "后的内容所在列,例如:tasks后添加冒号":"时,会自动对齐"-",实际上所有的冒号添加之后换行时,编辑器默认对齐上一行的第一个字符串位置,需要自行手动对齐
- 注释:关于注释,经测试,不能出现在对象的值value上,否则报错。例如不能放tasks的冒号之后之后
---
- hosts: lzcx
tasks:
- shell: echo haha # 注释不能出现在task的冒号之后