Kubernetes之yaml⽂件详解（汇总-详细）
⼀、YAML基础
YAML是专门⽤来写配置⽂件的语⾔，⾮常简洁和强⼤，使⽤⽐json更⽅便。它实质上是⼀种通⽤的数据串⾏化格式。
YAML语法规则：
⼤⼩写敏感
使⽤缩进表⽰层级关系
缩进时不允许使⽤Tal键，只允许使⽤空格
缩进的空格数⽬不重要，只要相同层级的元素左侧对齐即可
”#” 表⽰注释，从这个字符⼀直到⾏尾，都会被解析器忽略
在Kubernetes中，只需要知道两种结构类型即可：
Lists
Maps
1.1 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键
1.2 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
件：
{
称扬的近义词"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"五行属火的字大全
}]
}]
}
}
⼆、说明
定义配置时，指定最新稳定版API
配置⽂件应该存储在集群之外的版本控制仓库中。如果需要，可以快速回滚配置、重新创建和恢复
应该使⽤YAML格式编写配置⽂件，⽽不是json。YAML对⽤户更加友好
可以将相关对象组合成单个⽂件，通常会更容易管理
不要没必要指定默认值，简单和最⼩配置减⼩错误
在注释中说明⼀个对象描述更好维护
三、使⽤YAML创建Pod
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
apiVersion：此处值是v1，这个版本号需要根据安装的Kubernetes版本和资源类型进⾏变化，记住不是写死的。
kind：此处创建的是Pod，根据实际情况，此处资源类型可以是Deployment、Job、Ingress、Service等。
metadata：包含Pod的⼀些meta信息，⽐如名称、namespace、标签等信息。
spec：包括⼀些container，storage，volume以及其他Kubernetes需要的参数，以及诸如是否在容器失败时重新启动容器的属性。可在特定Kubernetes API找到完整的Kubernetes Pod的属性。
（1）查看apiVersion
# kubectl api-versions
admissionregistration.k8s.io/v1beta1
apiextensions.k8s.io/v1beta1
apiregistration.k8s.io/v1
apiregistration.k8s.io/v1beta1
apps/v1
apps/v1beta1《小英雄雨来》读后感
apps/v1beta2
authentication.k8s.io/v1
学生行为习惯authentication.k8s.io/v1beta1
authorization.k8s.io/v1
authorization.k8s.io/v1beta1
autoscaling/v1
autoscaling/v2beta1
batch/v1
batch/v1beta1
certificates.k8s.io/v1beta1
events.k8s.io/v1beta1
彼得兔的故事绘本
extensions/v1beta1
policy/v1beta1
rbac.authorization.k8s.io/v1
rbac.authorization.k8s.io/v1beta1
storage.k8s.io/v1
storage.k8s.io/v1beta1
v1
（2）下⾯是⼀个典型的容器定义：
spec:
containers:
- name: front-end
image: nginx
ports:
-
containerPort: 80
上述例⼦只是⼀个简单的最⼩定义：⼀个名字（front-end）、基于nginx的镜像，以及容器将会监听的指定端⼝号（80）。
除了上述的基本属性外，还能够指定复杂的属性，包括容器启动运⾏的命令、使⽤的参数、⼯作⽬录以及每次实例化是否拉取新的副本。还可以指定更深⼊的信息，例如容器的退出⽇志的位置。容器可选的设置属性包括：
name、image、command、args、workingDir、ports、env、resource、volumeMounts、livenessProbe、readinessProbe、livecycle、terminationMessagePath、imagePullPolicy、curityContext、stdin、stdinOnce、tty
（3）kubectl创建Pod
# kubectl create -f test_pod.yaml
pod "kube100-site" created
四、创建Deployment
名词解释
#test-pod
apiVersion: v1 #指定api版本，此值必须在kubectl apiversion中
kind: Pod #指定创建资源的⾓⾊/类型
metadata: #资源的元数据/属性
name: test-pod #资源的名字，在同⼀个namespace中必须唯⼀
labels: #设定资源的标签
k8s-app: apache
version: v1
kubernetes.io/cluster-rvice: "true"
annotations: #⾃定义注解列表
-
name: String #⾃定义注解名字
spec: #specification of the resource content 指定该资源的内容
restartPolicy: Always #表明该容器⼀直运⾏，默认k8s的策略，在此容器退出后，会⽴即创建⼀个相同的容器
nodeSelector: #节点选择，先给主机打标签kubectl label nodes kube-node1 zone=node1
zone: node1
containers:
- name: test-pod #容器的名字
image: 10.192.21.18:5000/test/chat:latest #容器使⽤的镜像地址
imagePullPolicy: Never #三个选择Always、Never、IfNotPrent，每次启动时检查和更新（从registery）images的策略，
# Always，每次都检查
# Never，每次都不检查（不管本地是否有）
# IfNotPrent，如果本地有就不检查，如果没有就拉取
command: ['sh'] #启动容器的运⾏命令，将覆盖容器中的Entrypoint，对应Dockefile中的ENTRYPOINT
args: ["$(str)"] #启动容器的命令参数，对应Dockerfile中CMD参数
env: #指定容器中的环境变量
- name: str #变量的名字
value: "/etc/run.sh" #变量的值
resources: #资源管理
requests: #容器运⾏时，最低资源需求，也就是说最少需要多少资源容器才能正常运⾏
cpu: 0.1 #CPU资源（核数），两种⽅式，浮点数或者是整数+m，0.1=100m，最少值为0.001核（1m）
memory: 32Mi #内存使⽤量
limits: #资源限制
cpu: 0.5
memory: 1000Mi
ports:
- containerPort: 80 #容器开发对外的端⼝
name: httpd #名称
protocol: TCP
livenessProbe: #pod内容器健康检查的设置
httpGet: #通过httpget检查健康，返回200-399之间，则认为容器正常
path: / #URI地址
port: 80
#host: 127.0.0.1 #主机地址
scheme: HTTP
initialDelaySeconds: 180 #表明第⼀次检测在容器启动后多长时间后开始
timeoutSeconds: 5 #检测的超时时间
periodSeconds: 15 #检查间隔时间
#也可以⽤这种⽅法
#exec: 执⾏命令的⽅法进⾏监测，如果其退出码不为0，则认为容器正常
# command:
# - cat
# - /tmp/health
#也可以⽤这种⽅法
#tcpSocket: //通过tcpSocket检查健康
lifecycle: #⽣命周期管理
postStart: #容器运⾏之前运⾏的任务
exec:
command:
- 'sh'
- 'yum upgrade -y'
preStop:#容器关闭之前运⾏的任务
exec:
command: ['rvice httpd stop']
volumeMounts: #挂载持久存储卷
- name: volume #挂载设备的名字，与volumes[*].name 需要对应
mountPath: /data #挂载到容器的某个路径下
readOnly: True
volumes: #定义⼀组挂载设备
- name: volume #定义⼀个挂载设备的名字
#meptyDir: {}
hostPath:
path: /opt #挂载设备类型为hostPath，路径为宿主机下的/opt，这⾥设备类型⽀持很多种
#nfs
（1）创建⼀个yaml⽂件
apiVersion: apps/v1beta2
kind: Deployment
metadata:
name: nginx-deployment
spec:
replicas: 3
lector:
matchLabels:
安息香
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.10
ports:
- containerPort: 80
（2）创建deployment
[root@master-01 YAML_k8s]# kubectl create -f nginx-deployment.yaml
deployment.apps "nginx-deployment" created
[root@master-01 YAML_k8s]# kubectl get pod -o wide
NAME READY STATUS RESTARTS AGE IP NODE
nginx-deployment-6b7b4d57b4-26wzj 1/1 Running 0 2m 10.20.184.83 master-01
nginx-deployment-6b7b4d57b4-9w7tm 1/1 Running 0 2m 10.20.190.60 node-01
nginx-deployment-6b7b4d57b4-mhh8t 1/1 Running 0 2m 10.20.254.108 node-03
[root@master-01 YAML_k8s]# kubectl get deployment
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
nginx-deployment 3333 2m
（3）查看标签
[root@master-01 YAML_k8s]# kubectl get pod --show-labels
NAME READY STATUS RESTARTS AGE LABELS
nginx-deployment-6b7b4d57b4-26wzj 1/1 Running 0 3m app=nginx,pod-template-hash=2636081360 nginx-deployment-6b7b4d57b4-9w7tm 1/1 Running 0 3m app=nginx,pod-template-hash=2636081360 nginx-deployment-6b7b4d57b4-mhh8t 1/1 Running 0 3m app=nginx,pod-template-hash=2636081360（4）通过标签查找Pod
[root@master-01 YAML_k8s]# kubectl get pod -l app=nginx
丙醇二酸NAME READY STATUS RESTARTS AGE
nginx-deployment-6b7b4d57b4-26wzj 1/1 Running 0 6m
nginx-deployment-6b7b4d57b4-9w7tm 1/1 Running 0 6m
nginx-deployment-6b7b4d57b4-mhh8t 1/1 Running 0 6m
（5）deployment创建过程
Deployment 管理的是replicat-controller，RC会创建Pod。Pod⾃⾝会下载镜像并启动镜像[root@master-01 YAML_k8s]# kubectl describe rs nginx-deployment
...
...
...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal SuccessfulCreate 33m replicat-controller Created pod: nginx-deployment-6b7b4d57b4-9w7tm
Normal SuccessfulCreate 33m replicat-controller Created pod: nginx-deployment-6b7b4d57b4-26wzj
Normal SuccessfulCreate 33m replicat-controller Created pod: nginx-deployment-6b7b4d57b4-mhh8t
[root@master-01 YAML_k8s]# kubectl describe pod nginx-deployment-6b7b4d57b4-26wzj
.
..
...
...
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 36m default-scheduler Successfully assigned nginx-deployment-6b7b4d57b4-26wzj to master-01 Normal SuccessfulMountVolume 36m kubelet, master-01 MountVolume.SetUp succeeded for volume "default-token-v5vw9" Normal Pulled 36m kubelet, master-01 Container image "nginx:1.10" already prent on machine
Normal Created 36m kubelet, master-01 Created container
Normal Started 36m kubelet, master-01 Started container
（6）升级镜像（nginx1.10–>nginx1.11）
[root@master-01 YAML_k8s]# kubectl t image deploy/nginx-deployment nginx=nginx:1.11
deployment.apps "nginx-deployment" image updated
[root@master-01 YAML_k8s]# kubectl exec -it nginx-deployment-b96c97dc-2pxjf bash
root@nginx-deployment-b96c97dc-2pxjf:/# nginx -V
nginx version: nginx/1.11.13
升级镜像的过程是逐步进⾏的，pod不会⼀下⼦全部关闭，⽽是⼀个⼀个升级
（7）查看发布状态
[root@master-01 ~]# kubectl rollout status deploy/nginx-deployment
deployment "nginx-deployment" successfully rolled out
（8）查看deployment历史修订版本
[root@master-01 ~]# kubectl rollout history deploy/nginx-deployment
deployments "nginx-deployment"
REVISION CHANGE-CAUSE
1 <none>
2 <none>
# 显⽰历史有两个版本
[root@master-01 ~]# kubectl rollout history deploy/nginx-deployment --revision=1
deployments "nginx-deployment" with revision #1
Pod Template:
Labels: app=nginx
pod-template-hash=2636081360
Containers:
nginx:
Image: nginx:1.10
Port: 80/TCP
Host Port: 0/TCP
Environment: <none>
Mounts: <none>
Volumes: <none>
[root@master-01 ~]# kubectl rollout history deploy/nginx-deployment --revision=2
deployments "nginx-deployment" with revision #2
Pod Template:
Labels: app=nginx
pod-template-hash=65275387
Containers:
nginx:
Image: nginx:1.11
Port: 80/TCP
Host Port: 0/TCP
Environment: <none>
Mounts: <none>
Volumes: <none>
（8）编辑deployment
[root@master-01 ~]# kubectl edit deploy/nginx-deployment
# 将nginx版本改为1.12
...
...
...
spec:
containers:
- image: nginx:1.12
imagePullPolicy: IfNotPrent
name: nginx
