了解YAML¶

默认的SLS文件的renderer是YAML renderer。YAML是一个有很多强大特性的标记性语言。Salt使用了一个YAML的小型子集，映射非常常用的数据结构，像列表和字典。YAML renderer的工作是将YAML数据格式的结构编译成为Python数据结构给Salt使用。

尽管YAML语法可能第一眼看上去很简洁但令人畏惧，但是只要记住三个非常简单的规则就可以使用YAML语法写SLS文件了。

规则一: 缩进¶

YAML使用一个固定的缩进风格表示数据层结构关系。Salt需要每个缩进级别由两个空格组成。不要使用tabs。

Python的字典当然理所当然是简单的键值对。其他语言的用户应该知道这个数据类型叫哈希表或者关联数组。

字典的keys在YAML中的表现形式是一个以冒号结尾的字符串。Values的表现形式冒号下面的每一行，用一个空格隔开:

my_key: my_value

在Python中，上面的将映射为:

{'my_key': 'my_value'}

另一种选择，一个value可以通过缩进与key联接。

my_key:
  my_value

注解

上面的语法是有效的YAML，但是在SLS文件罕见，因为通常情况下，一个key的value不是单一的，而是一个列表的values。

在Python中，上面的将映射为:

{'my_key': 'my_value'}

字典可以被嵌套:

first_level_dict_key:
  second_level_dict_key: value_in_second_level_dict

在Python中:

{
    'first_level_dict_key': {
        'second_level_dict_key': 'value_in_second_level_dict'
    }
}

想要表示列表项，使用一个短横杠加一个空格。多个项使用同样的缩进级别作为同一列表的一部分。

- list_value_one
- list_value_two
- list_value_three

列表可以可以作为一个键值对的value。这个在Salt很常见:

my_dictionary:
  - list_value_one
  - list_value_two
  - list_value_three

在Python中，上面的将映射为:

{'my_dictionary': ['list_value_one', 'list_value_two', 'list_value_three']}

一个简单的学习更多关于YAML如何渲染为Python数据结构的方式是使用一个在线的YAML解析器去看看Python的输出。

一个优异的的体验YAML解析过程的选择: http://yaml-online-parser.appspot.com/