一、概述

k8s 集群中对资源管理和资源对象编排部署都可以通过声明样式（YAML）文件来解决，也就是可以把需要对资源对象操作编辑到YAML 格式文件中，我们把这种文件叫做资源清单文件，通过kubectl 命令直接使用资源清单文件就可以实现对大量的资源对象进行编排部署了。一般在我们开发的时候，都是通过配置YAML文件来部署集群的。

YAML文件：就是资源清单文件，用于资源编排

二、YAML文件介绍

2.1 YAML概述

YAML ：仍是一种标记语言。为了强调这种语言以数据做为中心，而不是以标记语言为重点。

YAML 是一个可读性高，用来表达数据序列的格式。

2.2 YAML 基本语法

• 使用空格做为缩进
• 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
• 低版本缩进时不允许使用Tab 键，只允许使用空格
• 字符后缩进一个空格，比如冒号，逗号后面
• 使用#标识注释，从这个字符一直到行尾，都会被解释器忽略
• 使用 --- 表示新的yaml文件开始

2.3 YAML 支持的数据结构

2.3.1 对象

键值对的集合，又称为映射(mapping) / 哈希（hashes） / 字典（dictionary）

# 对象类型：对象的一组键值对，使用冒号结构表示
name: Tom
age: 18

# yaml 也允许另一种写法，将所有键值对写成一个行内对象
hash: {name: Tom, age: 18}

2.3.2 数组

# 数组类型：一组连词线开头的行，构成一个数组
People
- Tom
- Jack

# 数组也可以采用行内表示法
People: [Tom, Jack]

2.3.3 纯量（scalars）

纯量:纯量是最基本的、不可再分的值。以下数据类型都属于纯量

#数值直接以字面量的形式表示
number: 12.30

#布尔值用true和false表示
isset: true


#nu71用~表示
parent: ~

#时间采用Iso8601格式
iso8601:2001-12-14t21:59:43.10-05:00

#日期采用复合iso8601格式的年、月、日表示
date: 1976-07-31

#YAML 允许使用两个感叹号，强制转换数据类型
e: ! !str 123
f: ! !str true

#字符串默认不使用引号表示
str:这是一行字符串

#如果字符串之中包含空格或特殊字符，需要放在引号之中
str: '内容:字符串'

#单引号和双引号都可以使用，双引号不会对特殊字符转义
s1:'内容\n字符串'
s2:"内容\n字符串"

#单引号之中如果还有单引号，必须连续使用两个单引号转义
str: 'labor' 's day'

#字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格
str:这是一段
多行
字符串

#多行字符串可以使用|保留换行符，也可以使用>折叠换行
this: |
Foo
Bar
thatFooBar

三、YAML文件组成部分

在 k8s 中，一般使用 YAML 格式的文件来创建符合我们预期期望的 pod,这样的 YAML 文件称为资源清单。

主要分为了两部分，一个是控制器的定义 和 被控制的对象

3.1 控制器的定义

apiVersion: apps/v1  #api的版本
kind: Deployment  #deployment是用来管理pod的
metadata:  #元数据对象，固定值写metadata
 name: nginx-deployment   #元数据对象的名字，由我们编写，比如命名pod的名字
 namespace: default    #元数据对象的命令空间，由我们自身定义
spec:   #详细定义对象，固定式写spec
 replicas: 3 #有哪些副本
 selector: #用那个选择器
  matchLabels: 
   app: nainx #应用的名字

3.2 被控制的对象

包含一些 镜像，版本、端口等

template:  #pod模板
 metadata:
  labels:  #标签
   app: nginx  #应用名字
  spec:
   containers:
   - name: nginx
   image: nginx:latest
   ports:
   - containerPort: 80

常用属性说明

属性名称	介绍
apiVersion	API版本，可以用kubectl api-versions命令查询
kind	资源类型，比如pod
metadata	资源元数据
spec	资源规格
replicas	副本数量
selector	标签选择器
template	Pod模板
metadata	Pod元数据
spec	Pod规格
containers	容器配置

举例说明

创建一个namespace

apiVersion: v1
kind: namespace
metadata:  #元数据对象，固定值写metadata
 name: test

创建一个pod

apiVersion: v1
kind: pod
metadata: 
 name: pod1
spec: 
 containers: 
 - name: nginx-containers
   image: nginx: latest

四、如何快速编写YAML文件

一般来说，我们很少自己手写YAML文件，因为这里面涉及到了很多内容，我们一般都会借助工具来创建

4.1 使用kubectl create命令

这种方式一般用于资源没有部署的时候，我们可以直接创建一个YAML配置文件

# 尝试运行,并不会真正的创建镜像
[root@localhost ~]$ kubectl create deployment web --image=nginx -o yaml --dry-run
#-o yaml: 把操作用yaml格式生成出来
#--dry-run: 尝试运行，并不真正执行，空跑的意思

或者我们可以输出到一个文件中

[root@localhost ~]$ kubectl create deployment web --image=nginx -o yaml --dry-run > demo.yaml

4.2 使用kubectl get命令导出yaml文件

可以首先查看一个目前已经部署的镜像

[root@localhost ~]$ kubectl get deploy

然后我们导出 nginx的配置

[root@localhost ~]$ kubectl get deploy nginx -o=yaml > nginx.yaml
#会生成一个 nginx.yaml 的配置文件
#高版本没有--export，如果报错就去掉--export