---

K8s - 目录

---

---

一、kubernetes 集群 YAML 文件详解

---

1. YAML 文件概述

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

2. YAML 文件书写格式

2.1 YAML 介绍

• YAML 是一种标记语言；
• 以数据做为中心，而不是以标记语言为重点；
• YAML 是一个可读性高，用来表达数据序列的格式。

2.2 YAML 基本语法

• 使用空格做为缩进；
• 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可；
• 低版本缩进时不允许使用 Tab 键，只允许使用空格；
• 使用#标识注释，从这个字符一直到行尾，都会被解释器忽略。

2.3 YAML 支持的数据结构

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

# 对象类型：对象的一组键值对，使用冒号结构表示
name: Tome
age: 18# yaml 也允许另一种写法，将所有键值对写成一个行内对象
hash: { name: Tom, age: 18 }

数组
一组按次序排列的值，又称为序列（sequence） / 列表 （list）

# 数组类型：一组连词线开头的行，构成一个数组
People
- Tom
- Jack# 数组也可以采用行内表示法
People: [ Tom, Jack ]

纯量（scalars）
单个的、不可再分的值

# 纯量：纯量是最基本的、不可再分的值。以下数据类型都属于纯量# 数值直接以字面量的形式表示
number: 12.30# 布尔值用 true 和 false 表示
isSet: true# null 用 ~ 表示
parent: ~# 时间采用 ISO8601 格式
iso8601: 2001-12-14t21:01:01.01-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
that
Foo
Bar

3. 资源清单描述方法

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

3.1 常用字段

必须存在的属性

参数名	字段类型	说明
apiVersion	String	k8s API 的版本，目前基本是v1，可以用 kubectl api-versions 命令查询。
kind	String	yaml 文件定义的资源类型的角色。比如： pod
metadata	Object	元数据对象，固定写 metadata
metadata.name	String	元数据对象的名称，自行定义。
metadata.namespace	String	元数据对象的命名空间，自行定义。
spec	Object	详细定义对象，固定写spec
spec.containers[]	list	spec 对象的容器列表定义。
spec.container[].name	String	容器的名称。
spec.container[].image	String	需要使用到的镜像的名称。

spec 主要对象

参数名	字段类型	说明

额外的参数

参数名	字段类型	说明
spec.restartPolicy	String	定义 pod 重启策略，可以选择值为 Always、OnFailure，默认值为 Always。1.Always：pod 一旦终止运行，则无论容器是如何终止的，kubelet 服务都降重其他。2.OnFailure：只有 pod 以非零退出带吗终止时，kubelet 才会重启该容器。如果容器正常结束（推出代码为0），则 kubelet 将不会重启它。
spec.nodeSelector	Object	定义 Node 的 Label 过滤标签，以 key: value 格式指定。
spec.imagesPullSecrets	Object	定义pull 镜像时使用 secret 名称，以 name: secretkey 格式指定。
spec.hostNetwork	Boolean	定义是否使用主机网络模式，数值为 false。设置 true 表示使用宿主机网络，不使用 docker 网桥，同时设置了 true 将无法在同一宿主机上启动第二个副本。

官网地址：https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

apiVersion: apps/v1  # 指定api版本，此值必须在kubectl api-versions中  
kind: Deployment  # 指定创建资源的角色/类型   
metadata:  # 资源的元数据/属性 name: demo  # 资源的名字，在同一个namespace中必须唯一namespace: default # 部署在哪个namespace中labels:  # 设定资源的标签app: demoversion: stable
spec: # 资源规范字段replicas: 1 # 声明副本数目revisionHistoryLimit: 3 # 保留历史版本selector: # 选择器matchLabels: # 匹配标签app: demoversion: stablestrategy: # 策略rollingUpdate: # 滚动更新maxSurge: 30% # 最大额外可以存在的副本数，可以为百分比，也可以为整数maxUnavailable: 30% # 示在更新过程中能够进入不可用状态的 Pod 的最大值，可以为百分比，也可以为整数type: RollingUpdate # 滚动更新策略template: # 模版metadata: # 资源的元数据/属性 annotations: # 自定义注解列表sidecar.istio.io/inject: "false" # 自定义注解名字labels: # 设定资源的标签app: demoversion: stablespec: # 资源规范字段containers:- name: demo # 容器的名字   image: demo:v1 # 容器使用的镜像地址   imagePullPolicy: IfNotPresent # 每次Pod启动拉取镜像策略，三个选择 Always、Never、IfNotPresent# Always，每次都检查；Never，每次都不检查（不管本地是否有）；IfNotPresent，如果本地有就不检查，如果没有就拉取（手动测试时，# 已经打好镜像存在docker容器中时，使用存在不检查级别，# 默认为每次都检查，然后会进行拉取新镜像，因镜像仓库不存在，导致部署失败）resources: # 资源管理limits: # 最大使用cpu: 300m # CPU，1核心 = 1000mmemory: 500Mi # 内存，1G = 1000Mirequests:  # 容器运行时，最低资源需求，也就是说最少需要多少资源容器才能正常运行cpu: 100mmemory: 100MilivenessProbe: # pod 内部健康检查的设置httpGet: # 通过httpget检查健康，返回200-399之间，则认为容器正常path: /healthCheck # URI地址port: 8080 # 端口scheme: HTTP # 协议# host: 127.0.0.1 # 主机地址initialDelaySeconds: 30 # 表明第一次检测在容器启动后多长时间后开始timeoutSeconds: 5 # 检测的超时时间periodSeconds: 30 # 检查间隔时间successThreshold: 1 # 成功门槛failureThreshold: 5 # 失败门槛，连接失败5次，pod杀掉，重启一个新的podreadinessProbe: # Pod 准备服务健康检查设置httpGet:path: /healthCheckport: 8080scheme: HTTPinitialDelaySeconds: 30timeoutSeconds: 5periodSeconds: 10successThreshold: 1failureThreshold: 5#也可以用这种方法   #exec: 执行命令的方法进行监测，如果其退出码不为0，则认为容器正常   #  command:   #    - cat   #    - /tmp/health   #也可以用这种方法   #tcpSocket: # 通过tcpSocket检查健康  #  port: number ports:- name: http # 名称containerPort: 8080 # 容器开发对外的端口 protocol: TCP # 协议imagePullSecrets: # 镜像仓库拉取密钥- name: harbor-certificationaffinity: # 亲和性调试nodeAffinity: # 节点亲和力requiredDuringSchedulingIgnoredDuringExecution: # pod 必须部署到满足条件的节点上nodeSelectorTerms: # 节点满足任何一个条件就可以- matchExpressions: # 有多个选项，则只有同时满足这些逻辑选项的节点才能运行 pod- key: beta.kubernetes.io/archoperator: Invalues:- amd64---
apiVersion: v1 # 指定api版本，此值必须在kubectl api-versions中 
kind: Service # 指定创建资源的角色/类型 
metadata: # 资源的元数据/属性name: demo # 资源的名字，在同一个namespace中必须唯一namespace: default # 部署在哪个namespace中labels: # 设定资源的标签app: demo
spec: # 资源规范字段type: ClusterIP # ClusterIP 类型ports:- port: 8080 # service 端口targetPort: http # pod端口容器暴露的端口protocol: TCP # 协议name: http # 端口名称nodePort: 31319  # 对外访问端口selector: # 选择器app: demo

---

# yaml格式的pod定义文件完整内容：
apiVersion: v1       #必选，版本号，例如v1
kind: Pod       #必选，Pod
metadata:       #必选，元数据name: string       #必选，Pod名称namespace: string    #必选，Pod所属的命名空间labels:      #自定义标签- name: string     #自定义标签名字annotations:       #自定义注释列表- name: string
spec:         #必选，Pod中容器的详细定义containers:      #必选，Pod中容器列表- name: string     #必选，容器名称image: string    #必选，容器的镜像名称imagePullPolicy: [Always | Never | IfNotPresent] #获取镜像的策略 Alawys表示下载镜像 IfnotPresent表示优先使用本地镜像，否则下载镜像，Nerver表示仅使用本地镜像command: [string]    #容器的启动命令列表，如不指定，使用打包时使用的启动命令args: [string]     #容器的启动命令参数列表workingDir: string     #容器的工作目录volumeMounts:    #挂载到容器内部的存储卷配置- name: string     #引用pod定义的共享存储卷的名称，需用volumes[]部分定义的的卷名mountPath: string    #存储卷在容器内mount的绝对路径，应少于512字符readOnly: boolean    #是否为只读模式ports:       #需要暴露的端口库号列表- name: string     #端口号名称containerPort: int   #容器需要监听的端口号hostPort: int    #容器所在主机需要监听的端口号，默认与Container相同protocol: string     #端口协议，支持TCP和UDP，默认TCPenv:       #容器运行前需设置的环境变量列表- name: string     #环境变量名称value: string    #环境变量的值resources:       #资源限制和请求的设置limits:      #资源限制的设置cpu: string    #Cpu的限制，单位为core数，将用于docker run --cpu-shares参数memory: string     #内存限制，单位可以为Mib/Gib，将用于docker run --memory参数requests:      #资源请求的设置cpu: string    #Cpu请求，容器启动的初始可用数量memory: string     #内存清楚，容器启动的初始可用数量livenessProbe:     #对Pod内个容器健康检查的设置，当探测无响应几次后将自动重启该容器，检查方法有exec、httpGet和tcpSocket，对一个容器只需设置其中一种方法即可exec:      #对Pod容器内检查方式设置为exec方式command: [string]  #exec方式需要制定的命令或脚本httpGet:       #对Pod内个容器健康检查方法设置为HttpGet，需要制定Path、portpath: stringport: numberhost: stringscheme: stringHttpHeaders:- name: stringvalue: stringtcpSocket:     #对Pod内个容器健康检查方式设置为tcpSocket方式port: numberinitialDelaySeconds: 0  #容器启动完成后首次探测的时间，单位为秒timeoutSeconds: 0   #对容器健康检查探测等待响应的超时时间，单位秒，默认1秒periodSeconds: 0    #对容器监控检查的定期探测时间设置，单位秒，默认10秒一次successThreshold: 0failureThreshold: 0securityContext:privileged:falserestartPolicy: [Always | Never | OnFailure]#Pod的重启策略，Always表示一旦不管以何种方式终止运行，kubelet都将重启，OnFailure表示只有Pod以非0退出码退出才重启，Nerver表示不再重启该PodnodeSelector: obeject  #设置NodeSelector表示将该Pod调度到包含这个label的node上，以key：value的格式指定imagePullSecrets:    #Pull镜像时使用的secret名称，以key：secretkey格式指定- name: stringhostNetwork:false      #是否使用主机网络模式，默认为false，如果设置为true，表示使用宿主机网络volumes:       #在该pod上定义共享存储卷列表- name: string     #共享存储卷名称 （volumes类型有很多种）emptyDir: {}     #类型为emtyDir的存储卷，与Pod同生命周期的一个临时目录。为空值hostPath: string     #类型为hostPath的存储卷，表示挂载Pod所在宿主机的目录path: string     #Pod所在宿主机的目录，将被用于同期中mount的目录secret:      #类型为secret的存储卷，挂载集群与定义的secre对象到容器内部scretname: string  items:     - key: stringpath: stringconfigMap:     #类型为configMap的存储卷，挂载预定义的configMap对象到容器内部name: stringitems:- key: stringpath: string

3.2 举例说明

创建一个 namespace

apiVersion: v1
kind: Namespace
metadata:name: test

创建一个 pod

apiVersion: v1
kind: Pod
metadata:name: pod1
spec:containers:- name: nginx-containers- image: nginx:laster