YAML(YAML 不是标记语言)是一种人性化的跨语言数据序列化语言,通常用于配置文件,并将数据表示为映射、序列和标量。版本 1.2 使 YAML 成为 JSON 的严格超集。在代理和抓取工作中,YAML 出现在配置文件中。例如,Envoy 代理的静态配置是用 YAML 编写的,并定义了流量通过的监听器和集群。

YAML 语法基础

  • 映射: key: value 对,类似于字典或哈希表。
  • 序列: 列表,每个项目单独一行,以 - 开头。
  • 缩进: 在块样式中,缩进决定结构,因此错误的空格会改变数据的含义。
  • 无制表符: 不得使用制表符字符进行缩进。
  • 注释: # 开始注释。

在抓取器和代理配置中安全使用 YAML

YAML 解析器可以做的不仅仅是读取纯数据。PyYAML 文档警告说,从不可信来源的数据调用 yaml.load 是不安全的,因为它可以构造任意的 Python 对象。它的 yaml.safe_load 函数仅识别标准 YAML 标签,这使其成为处理不可信输入的文档选择。

多行字符串、锚和多个文档

  • 字面块 (|): 在多行字符串中保留每个换行符。
  • 折叠块 (>): 将每个换行符变为空格,除非在空行或更缩进的行之前。
  • 锚和别名: &name 标记一个节点,*name 后续重用它,而不是重复它。
  • 多个文档: --- 标记文档内容的开始,因此一个流可以包含多个文档。... 在不开始新文档的情况下结束一个文档。

相关术语