Ansible系列基础篇 1.6、Yaml语法
一、基本语法规则
- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键，只允许使用空格。
- 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
- yaml文件以”—“作为文档的开始，”…“作为文档的结束
- # 表示注释
二、YAML支持的数据结构
- 对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
- 数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）
- 纯量（scalars）：单个的、不可再分的值
三、数据结构示例
1、对象
对象的一组键值对，使用冒号结构表示。
job: Developer
2、列表
常规表示法：
--- fruits: - Apple - Orange - Mango
行内表示法：
--- fruits: ['Apple', 'Orange', 'Mango']
转换为python格式：
{'fruits': ['Apple', 'Orange', 'Mango']}
3、字典
常规表示法：
--- martin: name: Martin D'vloper job: Developer skill: Elite
行内表示法：
---
martin: {name: Martin D'vloper, job: Developer, skill: Elite}
转换为python格式：
{'martin': {'job': 'Developer', 'name': "Martin D'vloper", 'skill': 'Elite'}}
4、复杂结构
---
- martin:
name: Martin D'vloper
job: Developer
skills:
- python
- perl
- pascal
- tabitha:
name: Tabitha Bitumen
job: Developer
skills:
- lisp
- fortran
- erlang
转换为python格式：
[{'martin': {'job': 'Developer','name': "Martin D'vloper",'skills': ['python', 'perl', 'pascal']}},
{'tabitha': {'job': 'Developer', 'name': 'Tabitha Bitumen','skills': ['lisp', 'fortran', 'erlang']}}]
四、纯量
1、数值
number: 12 float:12.30
转换为python格式：
{'float': 12.300000000000001, 'number': 12}
2、布尔
表示true的值 true, True, TRUE, yes, Yes, YES, on, On, ON, y, Y
表示false的值 false, False, FALSE, no, No, NO, off, Off, OFF, n, N
e: !!str 123 f: !!str true
转换为python格式：
{'e': '123', 'f': 'true'}
3、字符串
字符串默认不使用引号表示。
str: 这是一行字符串
转换为python格式：
{'str': '这是一行字符串'}
如果字符串之中包含空格或特殊字符，需要放在引号之中。
str: '内容： 字符串'
转换为python格式：
{'str': '内容： 字符串'}
单引号和双引号都可以使用，双引号不会对特殊字符转义。
s1: '内容\n字符串' s2: "内容\n字符串"
转换为python格式：
{'s1': '内容\\n字符串','s2': '内容\n字符串'}
单引号之中如果还有单引号，必须连续使用两个单引号转义。
str: 'labor''s day'
转换为python格式：
{'str': "labor's day"}
字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格。
str: 这是一段 多行 字符串
转换为python格式：
{'str': '这是一段 多行 字符串'}
多行字符串可以使用|保留换行符，也可以使用>折叠换行。
this: | Foo Bar that: > Foo Bar
转换为python格式：
{'that': 'Foo Bar', 'this': 'Foo\nBar\n'}
+表示保留文字块末尾的换行，-表示删除字符串末尾的换行。
s1: | Foo s2: |+ Foo s3: |- Foo
转换为python格式：
{'s1': 'Foo\n', 's2': 'Foo\n\n\n', 's3': 'Foo'}
字符串之中可以插入 HTML 标记。
message: | <p style="color: red"> 段落 </p>
转换为python格式：
{'message': '\n<p style="color: red">\n 段落\n</p>'}
五、引用
锚点&和别名*，可以用来引用。
defaults: &defaults adapter: postgres host: localhost development: database: myapp_development <<: *defaults test: database: myapp_test <<: *defaults
等同于下面的代码。
defaults: adapter: postgres host: localhost development: database: myapp_development adapter: postgres host: localhost test: database: myapp_test adapter: postgres host: localhost
转换为python格式：
{'defaults': {'adapter': 'postgres', 'host': 'localhost'},
'development': {'adapter': 'postgres',
'database': 'myapp_development',
'host': 'localhost'},
'test': {'adapter': 'postgres',
'database': 'myapp_test',
'host': 'localhost'}}
&用来建立锚点（defaults），<<表示合并到当前数据，*用来引用锚点。
下面是另一个例子。
- &showell Steve - Clark - Brian - Oren - *showell COPY 转换为python格式 ['Steve', 'Clark', 'Brian', 'Oren', 'Steve']
yaml中引用变量
foo: ""
六、高级语法
!unsafe使用
变量值中保存的数据应被视为不安全的，防止不安全的字符子集和信息披露。
--- hosts: all vars: my_unsafe_variable: !unsafe 'unsafe value' tasks: ...
