字典同级元素 缩进
A:
  a
  b
列表同级元素 - 缩进
A:
  - a
  - b
--- 同一个文件 不同资源

YAML介绍

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

使用YAML做K8s资源定义的好处

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

YAML语法规则

- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键，只允许使用空格
- 缩进的空格数不重要，只要相同层级的元素左侧对齐即可
- #表示注释，从这个字符一直到行尾，都会被解析器忽略
在同一个yaml配置文家内可以同时定义多个资源
必须带"---"

yaml结构类型

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

YAML Maps

Map指的是字典，即一个Key:Value 的键值对信息。
eg:
---
apiVersion: v1
kind: Pod
---"
为可选的分隔符 ，
当需要在一个文件中定义多个结构的时候需要使用。
上述内容表示有两个键apiVersion和kind，分别对应的值为v1和Pod。
Maps的value既能够对应字符串也能够对应一个Maps
eg:
---
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 Lists

List即列表，就是数组。
eg：
args:
    - beijing
    - shanghai
  - shenzhen
  - guangzhou
可以指定任何数量的项在列表中，每个项的定义以连字符（-）开头，并且与父元素之间存在缩进。
 在JSON格式中，表示如下：
{
 "args": ["beijing", "shanghai", "shenzhen", "guangzhou"]
}
当然Lists的子项也可以是Maps，Maps的子项也可以是List，
eg：
---
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:  
  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"]

服务部署文档

Yaml语法解析

YAML介绍

使用YAML做K8s资源定义的好处

YAML语法规则

yaml结构类型

YAML Maps

YAML Lists