一、YAML 语言介绍

YAML：YAML Ain't Markup Language，即YAML不是标记语言。不过，在开发的这种语言时，YAML的意思其实是："Yet Another Markup Language"（仍是一种标记语言）
YAML是一个可读性高的用来表达资料序列的格式。YAML参考了其他多种语言，包括：XML、C语言、 Python、Perl以及电子邮件格式RFC2822等。Clark Evans在2001年在首次发表了这种语言，另外Ingy d?t Net与Oren Ben-Kiki也是这语言的共同设计者,目前很多最新的软件比较流行采用此格式的文件存放配置信息，如:ubuntu，anisble，docker，kubernetes等

二、 YAML 语言特性

yaml语言特性归纳如下：

YAML的可读性好
YAML和脚本语言的交互性好
YAML使用实现语言的数据类型
YAML有一个一致的信息模型
YAML易于实现
YAML可以基于流来处理YAML表达能力强，扩展性好

三、YAML语法简介

大小写敏感
使用缩进表示层级关系
禁止使用tab缩进，只能使用空格键
缩进长度没有限制，只要元素对齐就表示这些元素属于一个层级
使用#表示注释
字符串可以不用引号标注

四、支持的数据类型

YAML 支持以下常用几种数据类型：

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

4.1 scalar 标量

key对应value

name: sam
age:18

4.2 使用缩进的方式

name: 
  sam
age:
  18

标量是最基本的，不可再分的值，包括：

字符串
布尔值
浮点数
Null
时间
日期

4.3 Dictionary 字典

字典由多个key与value构成，key和value之间用：分隔, 并且 : 后面有一个空格，所有k/v可以放在一行，或者每个 k/v 分别放在不同行
格式如下:

account: { name: sam, age: 18 }

使用缩进方式

account: 
  name: sam
  age: 18

范例：

#不同行
# An employee record
name: Example Developer
job: Developer
skill: Elite(社会精英)
#同一行,也可以将key:value放置于{}中进行表示，用,分隔多个key:value
# An employee record
{name: "Example Developer", job: "Developer", skill: "Elite"}

4.4 List 列表

列表由多个元素组成，每个元素放在不同行，且元素前均使用"-"打头，并且 - 后有一个空格, 或者将所有元素用 [ ] 括起来放在同一行。

course: [ linux, golang, python ]

也可以写成以 - 开头的多行

course: 
   - linux
   - golang
   - python

数据里面也可以包含字典

course:
 - linux: manjaro
 - golang: gin
 - python: django

不同行,行以-开头,后面有一个空格# A list of tasty fruits

# A list of tasty fruits
-   Apple
-   Orange
-   Strawberry
-   Mango

#同一行
[Apple,Orange,Strawberry,Mango]

范例：YAML 表示一个家庭

name: John Smith
age: 41
gender: Male
spouse: { name: Jane Smith, age: 37, gender: Female } # 写在一行里
  name: Jane Smith   #也可以写成多行   
  age: 37
  gender: Female
children:[{name: Jimmy Smith,age: 17, gender: Male}, {name: Jenny Smith, age:13, gender: Female}, {name: hao Smith, age: 20, gender: Male } ]  #写在一行
- name: Jimmy Smith
  age: 17     
  gender: Male

-   {name: Jenny Smith, age: 13, gender: Female}
-   {name: hao Smith, age: 20, gender: Male }

五、三种常见的数据格式

XML：Extensible Markup Language，可扩展标记语言，可用于数据交换和配置
JSON：JavaScript Object Notation, JavaScript 对象表记法，主要用来数据交换或配置，不支持注释
YAML：YAML Ain't Markup Language YAML 不是一种标记语言，主要用来配置，大小写敏感，不支持tab

六、yaml文件在kubernetes中的应用

Kubernetes 支持 YAML 和 JSON格式管理资源对象

JSON 格式：主要用于 api 接口之间消息的传递

yaml 文件的学习方法总结：

多看别人(官方)写的，能读懂
能照着现场的文件改着用
遇到不懂的，善用 kubectl explain ...命令查.

下面是一份nginx服务的详解。一份标准的yaml文件

kind: Deployment  #类型，是deployment控制器，kubectl explain  Deployment
apiVersion: apps/v1  #API版本，# kubectl explain  Deployment.apiVersion
metadata: #pod的元数据信息，kubectl explain  Deployment.metadata
  labels: #自定义pod的标签，# kubectl explain Deployment.metadata.labels
    app: nginx-deployment-label #标签名称为app值为nginx-deployment-label，后面会用到此标签 
  name: nginx-deployment #pod的名称
  namespace: nginx-demo #pod的namespace，默认是defaule
spec: #定义deployment中容器的详细信息，kubectl explain  Deployment.spec
  replicas: 1 #创建出的pod的副本数，即多少个pod，默认值为1
  selector: #定义标签选择器
    matchLabels: #定义匹配的标签，必须要设置
      app: nginx-selector #匹配的目标标签，
  template: #定义模板，必须定义，模板是起到描述要创建的pod的作用
    metadata: #定义模板元数据
      labels: #定义模板label，Deployment.spec.template.metadata.labels
        app: nginx-selector #定义标签，等于Deployment.spec.selector.matchLabels
    spec: #定义pod信息
      containers:#定义pod中容器列表，可以多个至少一个，pod不能动态增减容器
      - name: nginx-container #容器名称
        image: harbor.host.com/base/nginx-web1:v1 #镜像地址
        #command: ["/apps/tomcat/bin/run_tomcat.sh"] #容器启动执行的命令或脚本
        #imagePullPolicy: IfNotPresent
        imagePullPolicy: Always #拉取镜像策略IfNotPresent、Always、Nerver
        ports: #定义容器端口列表
        - containerPort: 80 #定义一个端口
          protocol: TCP #端口协议
          name: http #端口名称
        - containerPort: 443 #定义一个端口
          protocol: TCP #端口协议
          name: https #端口名称
        env: #配置环境变量
        - name: "password" #变量名称。必须要用引号引起来
          value: "123456" #当前变量的值
        - name: "age" #另一个变量名称
          value: "18" #另一个变量的值
        resources: #对资源的请求设置和限制设置
          limits: #资源限制设置，上限
            cpu: 500m  #cpu的限制，单位为core数，可以写0.5或者500m等CPU压缩值
            memory: 2Gi #内存限制，单位可以为Mib/Gib，将用于docker run --memory参数
          requests: #资源请求的设置
            cpu: 200m #cpu请求数，容器启动的初始可用数量,可以写0.5或者500m等CPU压缩值
            memory: 512Mi #内存请求大小，容器启动的初始可用数量，用于调度pod时候使用
              
---
kind: Service #类型为service
apiVersion: v1 #service API版本， service.apiVersion
metadata: #定义service元数据，service.metadata
  labels: #自定义标签，service.metadata.labels
    app: linux66-nginx #定义service标签的内容
  name: linux66-nginx-spec #定义service的名称，此名称会被DNS解析
  namespace: nginx-demo #该service隶属于的namespaces名称，即把service创建到哪个namespace里面
spec: #定义service的详细信息，service.spec
  type: NodePort #service的类型，定义服务的访问方式，默认为ClusterIP， service.spec.type
  ports: #定义访问端口， service.spec.ports
  - name: http #定义一个端口名称
    port: 80 #service 80端口
    protocol: TCP #协议类型
    targetPort: 80 #目标pod的端口
    nodePort: 30001 #node节点暴露的端口
  - name: https #SSL 端口
    port: 443 #service 443端口
    protocol: TCP #端口协议
    targetPort: 443 #目标pod端口
    nodePort: 30043 #node节点暴露的SSL端口
  selector: #service的标签选择器，定义要访问的目标pod
    app: nginx-selector #将流量路到选择的pod上，须等于Deployment.spec.selector.matchLabels