三、kubernetes 集群 YAML 文件详解

1. 简单说明

是一个可读性高，用来表大数据列的格式。Yaml的意思其实是：仍是一种标记语言，但是为了强调这种语言以数据为中心。而不是以标记语言为重点。

2. 基本语法

• 缩进时不允许使用Tab键，只允许使用空格
• 缩进时空格数目不重要，只要相同层级的元素左侧对齐即可
• #标识注释，从这个字节一直到行尾，都会被解释器忽略
• 使用—表示新的yaml文件开始

3. YAML支持的数据结构

• 对象：键值对的集合，又称为映射（mapping）、哈希（hashes）/字典（dictionary）
• 数组：一组按次序排列的值，又称为序列（sequence）/ 列表 （list）
• 纯量（scalars）：单个的，不可再分的值

4. K8S YAML字段

4.1必须存在的属性

参数名称	字段类型	说明
version	String	这里是指的K8S API版本。目前基本上是v1，可以使用kubectl api-versions 命令查询
kind	String	这里指的时yaml文件定义的资源类型和角色，比如：Pod
metadata	Object	元数据对象，固定值就写metadata
metadata.name	String	元数据对象的名字，这里由我们编写，比我命名Pod的名字
metadata.namespace	String	元数据对象的命名空间，有我们自身定义
Spec	Object	详细定义对象，固定值就写spec
spec.containers[]	list	这里时spec对象的容器列表定义，是个列表
Spec.containers[].name	String	这里定义容器的名字
spec.containers[].image	String	这里定义要用到的镜像名称

4.2 主要对象

参数名称	字段类型	说明
spec.containers[].name	String	定义容器的名字
spec.containers[].image		定义要用到的镜像名称
spec.containers[].imagePullPolicy		定义镜像拉取策略，有Always（每次都尝试重新拉取镜像）、Nerver（表示仅适用本地镜像）、IfNotPresent（如果本地有镜像就是用本地镜像，如果没有就拉取在线镜像）三个值可选。默认值是Always
spec.containers[].command[]	List	只定容器启动命令，因为是数组可以指定多个，不指定则使用镜像打包时使用的启动命令。
spec.containers[].args[]	List	指定容器启动命令参数，因为是数组可以指定多个。
spec.containers[].workingDir	String	指定容器的工作目录
spec.containers[].volumeMounts[]	List	指定容器内部的存储卷配置
spec.containers[].volumeMounts[].name	String	指定可以呗容器挂在的存储卷的名称。
spec.containers[].volumeMounts[].mountPath	String	指定可以被容器挂在的存储卷的路径
spec.containers[].volumeMounts[].readOnly	String	设置存储卷路径的读写模式，true或者false,默认未读写模式
spec.containers[].ports[].	List	指定容器需要用到的端口列表
spec.containers[].ports[].name	String	指定端口名称
spec.containers[].ports[].containerPort	String	指定容器需要监听的端口号
spec.containers[].ports[]/hostPort	String	指定容器锁在主机需要坚挺的端口号，默认跟上面containerPort相同，注意设置hostPort同一台主机无法启动该容器的相同副本，（因为主机的端口号不能相同，这样会冲突）
spec.containers[].ports[].protocol	String	指定端口协议，支持TCP和UDP,默认值为TCP。
spec.containers[].env[]	List	指定容器运行前需设置的环境变量列表
spec.containers[].env[].name	String	指定环境变量名称
spec.containers[].env[].value	String	指定环境变量值
spec.containers[].resources	Object	指定资源限制和资源请求的值，（这里开始就是设置容器的资源上限）
spec.containers[].resources.limits	Object	指定设置容器运行时资源的运行上限
spec.containers[].resources.limits.cpu	String	指定CPU的闲置，单位为core数，将用于docker run --cpu-shares参数（这里前面文件Pod。）
spec.containers[].resources.limits.memory	String	指定MEM内存的闲置，单位为MIB,GIB
spec.containers[].resources.requests	Object	指定容器启动和调度时闲置设置
spec.containers[].resources.requests.cpu	String	CPU请求，单位core数，容器启动时初始化可用数量
spec.containers[].resources.requests.memory	String	内存请求，单位为MiB，GiB,容器启动时初始可用数量
spec.restartPolicy	String	定义Pod的重启策略，可选值为Always,OnFailure,默认值为Always。 1.Always：Pod一旦终止运行，则无论容器时如何终止的，kubelet服务都讲重启它。2.OnFailure：只有Pod以非零退出码终止时，kubelet才会重启该容器，如果容器正常结束（退出码为0），泽kubelet将不会重启它。3.Never：Pod终止后，kubelet将退出码报告给Master，不会重启该Pod。
spec.nodeSelector	Object	定义Node的Label过滤标签。以key:value
spec.imagePullSecrets	Object	定义Pull镜像时使用secret名称，以name:secretkey格式指定
spec.hostNetwork	Boolean	定义是否使用网络模式，默认值为false。设置true表示使用宿主机网络，不实用docker网桥，同事设置了true将无法在同一台宿主机上启动第二个副本。

5.如何快速编写yaml文件

5.1 使用kubectl create命令生成yaml文件

kubectl  create deployment web --image=nginx -o yaml --dry-run > my1.yaml

dry-run   #不启动改Pod
-o        #输入yaml文件

5.2 使用kubectl get 命令导出Pod的yaml文件

kubectl get deploy nginx -o yaml > my.yaml

各种实例资源YAML文件手册

1.glusterfsPV.yaml

1.1 endpoint. yaml

apiVersion: v1
kind: Endpoints
metadata: ------------------------------------#元数据
  name: glusterfs ----------------------------#ep名称
  namespace: default -------------------------#命名空间
subsets: -------------------------------------#配置glusterfs连接信息
- addresses: ---------------------------------#添加glusterfs分布式地址
  - ip: 10.0.0.14 
  - ip: 10.0.0.15
  - ip: 10.0.0.16
  ports: -------------------------------------#设定glusterfs服务端口
  - port: 49152
    protocol: TCP

1.2 glusterfs server. yaml

apiVersion: v1
kind: Service
metadata: 
  name: glusterfs
  namespace: default
spec:
  ports:
  - port: 49152
    protocol: TCP
    targetPort: 49152
  sessionAffinity: None ----------------------#是否支持session
  type: ClusterIP

2.PV.yaml

apiVersion: v1
kind: PersistentVolume
metadata: -------------------------------------#元数据
  name: tomcat-mysql --------------------------#pv名称
  labels: -------------------------------------#标签信息
    xxx: xxx 
spec: -----------------------------------------#定义pv模板