YAML(YAML 不是标记语言)是一种人性化的跨语言数据序列化语言,通常用于配置文件,并将数据表示为映射、序列和标量。版本 1.2 使 YAML 成为 JSON 的严格超集。在代理和抓取工作中,YAML 出现在配置文件中。例如,Envoy 代理的静态配置是用 YAML 编写的,并定义了流量通过的监听器和集群。
YAML 语法基础
- 映射:
key: value对,类似于字典或哈希表。 - 序列: 列表,每个项目单独一行,以
-开头。 - 缩进: 在块样式中,缩进决定结构,因此错误的空格会改变数据的含义。
- 无制表符: 不得使用制表符字符进行缩进。
- 注释:
#开始注释。
在抓取器和代理配置中安全使用 YAML
YAML 解析器可以做的不仅仅是读取纯数据。PyYAML 文档警告说,从不可信来源的数据调用 yaml.load 是不安全的,因为它可以构造任意的 Python 对象。它的 yaml.safe_load 函数仅识别标准 YAML 标签,这使其成为处理不可信输入的文档选择。
多行字符串、锚和多个文档
- 字面块 (
|): 在多行字符串中保留每个换行符。 - 折叠块 (
>): 将每个换行符变为空格,除非在空行或更缩进的行之前。 - 锚和别名:
&name标记一个节点,*name后续重用它,而不是重复它。 - 多个文档:
---标记文档内容的开始,因此一个流可以包含多个文档。...在不开始新文档的情况下结束一个文档。