YAML语法基础(K8s基础)

  对于YAML语言,网上有很多将YAML转换为JSON格式的在线转换器,以下内容都可直接验证,另外若有兴趣更深入学习YAML,可到其官方站点去学习,下面介绍的仅仅是比较常用的内容,并非YAML语法的全部,因为还有很多高级用法,对于开发可能会更有帮助,这点需要说明。

YAML 语言的设计目标,就是方便人类读写。它实质上是一种通用的数据串行化格式。
它的基本语法规则如下。
  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进时不允许使用Tab键,只允许使用空格。
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可

YAML支持的数据结构有三种。
  • 对象(Object):键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
  • 数组(Aarry):一组按次序排列的值,又称为序列(sequence) / 列表(list)
  • 纯量(scalars):单个的、不可再分的值

以K8s中的示例来说明对象和数组:
apiVersion: apps/v1    #这是一个对象,key:value,这种形式的键值对,在yaml中就称为对象,也可以叫字典 或 映射(map).
kind: ReplicaSet      #这也是对象
metadata:           #对象可以是多个k:v 组合,这就是一个多k:v组合的对象。
 name: myapp
 namespace: default
spec:          #它也是对象,它更复杂点,它是复合型的对象
 replicas: 2
  selector:
   matchLabels:
    app: myapp
    release: canary
  template:
   metadata:
    name: myapp-pod
    labels:
     app: myapp
     release: canary
     environment:qa
   spec:
    containers:      #它的帮助信息中显示,它的类型为: <[]Object> ,但Yamy中,
               #它实际上是一个对象类型,但这个对象的值是一个数组类型。
    -  name: myapp-container    #这是一个多属性的数组,即一个数组有多个元素组成。
       image: busybox
       ports:        #它和containers一样。也是一个对象类型,但值(value)是数组类型.
     -  name:http        #注意: 数组是以"-"开头的.
      containerPort: 80
       -   name: https
      containerPort: 443

#对象数组类型比较容易混乱,我将其转化为单行形式的:【注意: YAML语法中,这种单行形式,称为流式(flow)语法】
  ports: [ {name: http, containerPort: 80 }, {name:https, containerPort: 443} ]
这样看就可以很容易看到: ports: VALUE 个格式, 但这个VALUE是一个数组,
而数组内部,每一个元素又是一个对象,因为name:http 其实就是K:V,所有它就是一个对象。
和对象相对应的是值,即单个字符串: 如下面的数组的示例。

#这里需要注意,数组还有一种形式是:
ports:
  -
    name: http
       containerPort: 80
  -
    name: https
  containerPort: 443
这样写,也表示"-" 下面的是数组的组成元素。YAML语法是需要使用空格对齐的!

#在YAML中表示一个这样的数组: [Nginx, Hadoop, Apache]
#就可以这样写:
  - Nginx
  - Hadoop   #像这样单个字符串Hadoop,就是一个值,对象是K:V组合,因此要区分开。
  - Apache

还需要强调:
    关于对齐,YAML要求,同级别要对齐,不同级别错位时,至少错开一个空格,产生上下级层次,即可,没有规定必须空出多少个空格。
    对于数组对象,因为它是以"-"横线开头,因此横线可与上层持平,也不算错,当然错开也是可以的。

YAML语法中在同一个文件中写多个配置段的语法:
server:
    address: 192.168.1.100
---      #在YAML格式中,使用三个横线("---")表示一个配置段的开始.
spring:
    profiles: development
    server:
  address: 127.0.0.1
---
spring:
    profiles: production
    server:
  address: 192.168.1.120

YAML中在同一个文件中,写两个YAML文件的语法
#yaml文档1
---          #三个横线表示文档开始
time: 20:03:20
player: Sammy Sosa
action: strike (miss)
...          #三个点表示文档结束

#yaml文档2
---
time: 20:03:47
player: Sammy Sosa
action: grand slam
...

YAML中单引号和双引号的区别和使用

s1: '内容\n字符串'
s2: "内容\n字符串"
用JavaScript表示:
  { s1: '内容\\n字符串', s2: '内容\n字符串' },可以看到,单引号会转义特殊字符,而双引号不会转义特殊字符.

str: 'labor''s day'
用JavaScript表示:
   { str: 'labor\'s day' },从这个示例中,可以看到,双写单引号,可以起到转义后一个单引号的目的。

YAML语法中的一些高级用法:

下面是一种数组的另一种写法
意思即对象的属性是一个数组[key1, key2],对应的值也是一个数组[Value1, Value2]

  YAML语法基础(K8s基础)

数据类型:

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:
  - 2018-02-17      #日期必须使用ISO 8601格式,即yyyy-MM-dd
datetime:
  - 2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区

picture: !!binary |            # Base64 编码的图片数据. 这里的"|",是YAML语法中的表示保留换行符的符号.
  R0lGODlhDAAMAIQAAP//9/X      #与"|" 相对的是 ">", 它表示 折叠换行,即 不保留换行符, 换行符会被替换为空格.
  17unp5WZmZgAAAOfn515eXv    #关于是否保留换行符,还有"|+" 和 “|-”参考下面
  Pz7Y6OjuDg4J+fn5OTk6enp            #注意:Base64编码在书写时,每行的前面必须有一个空格!!
  56enmleECcgggoBADs=

数据类型转换:

string:
  - !!str 54321 #这种就是将int类型转换为字符串类型. 需要使用两个叹号,即可。
  - !!str true

YAML中多行文本时,换行符保留与替换:

str: 这是一段
   多行
     字符串
用JavaScript表示: { str: '这是一段 多行 字符串' } ,换行符为替换为空格了。

this: |
    Foo
    Bar
用JavaScript表示: {this: 'Foo\nBar\n'} ,可以看到每个换行符都保留了。

s2: |+
    Foo
    abc
用JavaScript表示: {s2: 'Foo\nabc\n\n'}, 可看到,它保留了原始文本中的换号符,解析后还加入了一个换行符.

s3: |-
   Foo
   abc
用JavaScript表示: {s3: 'Foo\nabc},减号,就表示删除文本块末尾的换行符.

that: >
   Foo
   Bar
用JavaScript表示: {that: 'Foo Bar\n'},这个可以看到,折叠换行就是,只保留文本块末尾的换行符.
注意: ">",也支持">-" 和 ">+" 以上和上面一样。

锚点(&) 和 引用(*) 的组合使用:

示例1
hr:
   - Mark McGwire
   - &SS Sammy Sosa      #创建了一个锚点叫SS, 其值为:Sammy Sosa
rbi:
   - *SS       #引用一个已经定义的锚点SS,这样就引用了SS的值 Sammy Sosa。
   - Ken Griffey
用JavaScript语法: {rbi: [Sammy Sosa, Ken Griffey], hr: [Mark McGwire, Sammy Sosa]}

另一种定义方法:
SS: &SS Sammy Sosa      #先定义一个对象,Key是SS,Value是一个锚点
hr:
    - Mark McGwire
    - *SS            #这里引用锚点SS.得到的结果和上面一样。
rbi:
    - *SS
    - Ken Griffey

示例2
defaults: &defaults          #定义了一个锚点:叫defautls
     adapter: postgres
   host: localhost

development:
  database: myapp_development
  <<: *defaults        #这里引用了defaults描点的值,并使用"<<"表示将其合并到当前对象(Object)或叫映射(map)中。

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

示例3:
merge:
  - &CENTER { x: 1, y: 2 }
  - &LEFT { x: 0, y: 2 }
  - &BIG { r: 10 }
  - &SMALL { r: 1 }

sample1:
  <<: *CENTER
  r: 10

sample2:
  << : [ *CENTER, *BIG ]
  other: haha

sample3:
  << : [ *LEFT, *BIG ]
  r: 100

合并就相当于下面:
sample1:
  x: 1
  y: 2
  r: 10

sample2:
  x: 1
  y: 2
  r: 10
  other: haha

sample3:
  x: 0
  y: 2
  r: 100 #sample3还引入了BIG,它的值是r:10,但sample3中已经有r:100了,因此引入后,sample3原始值会覆盖引入的r:10.

上一篇:k8s中yaml文件pod的语法(转)


下一篇:两通道实信号使用一个FFT同时计算算法