yaml语法解析

介绍

除了某些强制性的命令，如：kubectl run或者expose等，会隐式创建rc或者svc（resver/svice），k8s还允许通过配置文件的方式来创建这些操作对象。
通常，使用配置文件的方式会比直接使用命令行更可取，因为这些文件可以进行版本控制，而且文件的变化和内容也可以进行审核，当使用及其复杂的配置来提供一个稳健、可靠和易维护的系统时，这些点就显得非常重要。
在声明定义配置文件的时候，所有的配置文件都存储在YAML或者JSON格式的文件中并且遵循k8s的资源配置方式。
kubectl可以创建、更新、删除和获得API操作对象，当前apiVersion、kind和name会组成一个API Path以供kubectl来调用。

yaml优点

YAML是专门用来写配置文件的语言，非常简洁和强大，使用比json更方便。它实质上是一种通用的数据串行化格式。

kubernetes中用来定义YAML文件创建Pod和创建Deployment等资源。

使用YAML用于K8s的定义的好处：
便捷性： 不必添加大量的参数到命令行中执行命令
可维护性：YAML文件可以通过源头控制，跟踪每次操作
灵活性： YAML可以创建比命令行更加复杂的结构

YAML语法规则：

1. 大小写敏感
2. 使用缩进表示层级关系
3. 缩进时不允许使用Tab键，只允许使用空格
4. 缩进的空格数不重要，只要相同层级的元素左侧对齐即可
5. "表示注释，从这个字符一直到行尾，都会被解析器忽略

注：在同一个yaml配置文家内可以同时定义多个资源

在 k8s 中，只需要知道两种结构类型：
1.Lists
2.Maps

字典
    a={key:value, key1:{key2:value2}, key3:{key4:[1,{key5:value5},3,4,5]}}
    
key: value
key1:
      key2: value2
key3:
      key4:
         - 1
         - key5: value5
         - 3
         - 4
         - 5
key: value
key1:
   key2: value2
key3:
   key4:
     - 1
     - key5: value5
     - 3
     - 4
     - 5
key: value
key1:
  key2: value2

YAML Maps

Map指的是字典，即一个Key:Value 的键值对信息。

例如：
---
apiVersion: v1
kind: Pod

注：— 为可选的分隔符 ，当需要在一个文件中定义多个结构的时候需要使用。上述内容表示有两个键apiVersion和kind，分别对应的值为v1和Pod。

Maps的value既能够对应字符串也能够对应一个Maps。

例如：
---
apiVersion: v1
kind: Pod
metadata:
  name: kube100-site
  labels:
    app: web    

注：上述的YAML文件中，metadata这个KEY对应的值为一个Maps，而嵌套的labels这个KEY的值又是一个Map。实际使用中可视情况进行多层嵌套。

​ YAML处理器根据行缩进来知道内容之间的关联。上述例子中，使用两个空格作为缩进，但空格的数据量并不重要，只是至少要求一个空格并且所有缩进保持一致的空格数 。例如，name和labels是相同缩进级别，因此YAML处理器知道他们属于同一map；它知道app是lables的值因为app的缩进更大。
注意：在YAML文件中绝对不要使用tab键

YAML   Lists
List即列表，就是数组
例如：
args:
 - beijing
 - shanghai
 - shenzhen
 - guangzhou

可以指定任何数量的项在列表中，每个项的定义以连字符（-）开头，并且与父元素之间存在缩进。

在JSON格式中，表示如下：

{
  "args": ["beijing", "shanghai", "shenzhen", "guangzhou"]
}

当然Lists的子项也可以是Maps，Maps的子项也可以是List，例如：

---
apiVersion: v1
kind: Pod
metadata:
  name: kube100-site
  labels:
    app: web
spec:
  containers:
    - name: front-end
      image: nginx
      ports:
        - containerPort: 80
        
    - name: flaskapp-demo
      image: jcdemo/flaskapp
      ports: 8080

如上述文件所示，定义一个containers的List对象，每个子项都由name、image、ports组成，每个ports都有一个KEY为containerPort的Map组成，转成JSON格式文件：

{
  "apiVersion": "v1",
  "kind": "Pod",
  "metadata": {
        "name": "kube100-site",
        "labels": {
            "app": "web"
        },

  },
  "spec": {
        "containers": [{
            "name": "front-end",
            "image": "nginx",
            "ports": [{
                "containerPort": "80"
            }]
        }, {
            "name": "flaskapp-demo",
            "image": "jcdemo/flaskapp",
            "ports": [{
                "containerPort": "5000"
            }]
        }]
  }
}

k8s的pod中运行容器，一个包含简单的Hello World容器的pod可以通过YAML文件这样来定义：

apiVersion: v1
kind: Pod  deployment service
metadata:  
    name: hello-world
    
spec: # 当前pod内容的声明  
    restartPolicy: Never
    containers:
    - name: hello
      image: "ubuntu:14.04"    
      command: ["/bin/echo","hello","world"]

创建的pod名为metadata.name的值：hello-world，该名称必须是唯一的。
spec的内容为该pod中，各个容器的声明：

restartPolicy：Never表示启动后运行一次就终止这个pod。
containers[0].name为容器的名字。
containers[0].image为该启动该容器的镜像。
containers[0].command相当于Dockerfile中定义的Entrypoint，可以通过下面的方式来声明cmd的参数：
command: ["/bin/echo"]
args: [“hello”,“world”]