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

不念不忘少年蓝@ 2022-10-23 11:26 167阅读 0赞

`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语法。**