Linux运维-yaml资源清单语法规范（常用于ansible、kubernetes）

YAML 是 “YAML Ain’t a Markup Language”（YAML 不是一种标记语言）的递归缩写。在开发的这种语言时，YAML 的意思其实是：“Yet Another Markup Language”（仍是一种标记语言）。

YAML 的配置文件后缀为 .yml，如：abong.yml 。

①基本语法

• 区分大小写
• 使用缩进表示层级关系
• 缩进不允许使用tab，只允许空格
• 缩进的空格数不重要，只要相同层级的元素左对齐即可
• ’#'表示注释

②数据类型

• 对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
• 数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）
• 纯量（scalars）：单个的、不可再分的值

③yaml对象

• 对象键值对使用冒号结构表示 key: value，冒号后面要加一个空格。也可以使用 key:{key1: value1, key2: value2, …}。

• 使用缩进表示层级关系

  key: 
      child-key: value
      child-key2: vale2
  

• 使用问号加一个空格代表一个复杂的key，使用一个冒号加一个空格代表一个value

  ?  
      - complexkey1
      - complexkey2
  :
      - complexvalue1
      - complexvalue2
  

④yaml数组

• 以 - 开头的行表示构成一个数组

• 多维数组的行内表示：key: [value1, value2, ...]

• 数据结构的子成员是一个数组，则可以在该项下面缩进一个空格。

  -
   - A
   - B
   - C
   
  # 举例
  companies:
      -
          id: 1
          name: company1
          price: 200W
      -
          id: 2
          name: company2
          price: 500W
  

⑤复合结构：

• 对象和数组构成复合结构

  # yaml格式
  languages:
    - Ruby
    - Perl
    - Python 
  websites:
    YAML: yaml.org 
    Ruby: ruby-lang.org 
    Python: python.org 
    Perl: use.perl.org
    
  # json格式
  { 
    languages: [ 'Ruby', 'Perl', 'Python'],
    websites: {
      YAML: 'yaml.org',
      Ruby: 'ruby-lang.org',
      Python: 'python.org',
      Perl: 'use.perl.org' 
    } 
  }
  

⑥纯量

• 纯量是最基本的，不可再分的值。

• 字符串、布尔值、整数、浮点数、NULL、时间、日期等

  boolean: 
      - TRUE  #true,True都可以
      - FALSE  #false，False都可以
  float:
      - 3.14
      - 6.8523015e+5  #可以使用科学计数法
  int:
      - 123
      - 0b1010_0111_0100_1010_1110    #二进制表示
  null:
      nodeName: 'node'
      parent: ~  #使用~表示null
  string:
      - 哈哈
      - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符
      - newline
        newline2    #字符串可以拆成多行，每一行会被转化成一个空格
  date:
      - 2020-12-15    #日期必须使用ISO 8601格式，即yyyy-MM-dd
  datetime: 
      -  2020-12-15T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用
  

⑦引用

• & 用来建立锚点（defaults），<< 表示合并到当前数据，* 用来引用锚点。

• 举例

  # 例1
  - &showell Steve      # 建立锚点（标记点）
  - Clark 
  - Brian 
  - Oren 
  - *showell      # 引用锚点（标记点嵌入）
  
  [ 'Steve', 'Clark', 'Brian', 'Oren', 'Steve' ]
  
  
  # 例2
  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
  

在使用yml文件的过程中，遇到新的语法也会不断补充进来，逐步完善掌握yaml语法。