kubernetes--资源清单

⒈资源含义

　　k8s中所有的内容都被抽象为资源，资源实例化之后，叫做对象。

⒉资源分类

　　名称空间级别

　　仅在此名称空间下生效，k8s的系统组件是默认放在kube-system名称空间下的，而kubectl get pod等价于kubectl get pod -n default，因此查看不到k8s的系统组件。
　　1.工作负载型资源(workload）：Pod【k8s最小组成部分，共享网络栈共享存储卷】、ReplicaSet【RS，调度器、控制器，通过标签去控制pod的创建、副本数量】、Deployment【控制器，通过控制RS的创建去创建pod】、StatefulSet【为有状态服务所建立的管理器】、DaemonSet【可以在每一个节点都运行一个pod的组件】、Job【工作、任务】、CronJob【轮询工作、轮询任务，为批处理而生的】（ReplicationController在v1.11版本被废弃）
　　2.服务发现及负载均衡型资源（ServiceDiscovery LoadBalance):Service【简称svc，服务，将服务暴露出去】、Ingress【将服务暴露出去】、...
　　3.配置与存储型资源：Volume（存储卷）【给pod提供持久化的能力】、CSI（容器存储接口，可以扩展各种各样的第三方存储卷）
　　4.特殊类型的存储卷：ConfigMap（当配置中心来使用的资源类型）【一般用来存储配置文件达到热更新的状态】、Secret（保存敏感数据）【加密方案存储数据，一般用来保存密码文件、密钥等等】、DownwardAPI（把外部环境中的信息输出给容器）【类似于CSI，】

　　集群级别
　　不管在任何名称空间下定义，在其他的名称空间下都能看得到，在定义的时候无需指定名称空间
　　例如：Namespace【名称空间】、Node【节点】、Role【角色】、ClusterRole、RoleBinding、ClusterRoleBinding

　　元数据级别
　　提供一个指标，不像是名称空间类型又不像集群级别，本质上更像是在两者之间，但是它有自己的特点，所以更应该作为一个单独的分类，例如HPA【通过cpu的利用率进行平滑扩展】就是一个很明显的元数据类型，通过指标进行操作。
　　根据一些指标去进行对应的操作
　　例如：HPA、PodTemplate【pod模板】、LimitRange【资源限制】

⒊资源清单

　　k8s一般都是通过定义资源清单的方式去创建资源
　　资源清单等价于剧本，写好了每一步应该如何去做

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

⒋资源清单常用的字段

　　必须存在的属性【创建资源清单的时候没有这些属性的存在它是不允许被执行的】

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

 　　主要属性【这些属性比较重要，如果不指定的话系统会自动补充默认值】

参数名称	字段类型	说明
spec.containers[].name	String	这里定义容器的名字
spec.containers[].image	String	这里定义要用到的镜像名称
spec.containers[].imagePullPolicy	String	定义镜像拉取策略，有Always、Never、 IfNotPresent三个值可选（1）Always:意思是 每次都尝试重新拉取镜像（2）Never:表示仅 使用本地镜像（3）lfNotPresent:如果本地有 镜像就使用本地镜像，没有就拉取在线镜像。 上面三个值都没设置的话，默认是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内存的限制，单位为MlB、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格式指定，选择node节点 去运行
spec.imagePullSecrets	Object	定义pull镜像时使用secret名称，以name:secretkey格式指定
spec.hostNetwork	Boolean	定义是否使用主机网络模式，默认值为false。设置true表示使用 宿主机网络，不使用docker网桥，同时设置了true将无法在同 一台宿主机上启动第二个副本。

　　查看资源有那些资源清单属性，使用以下命令

kubectl explain pod

　　查看属性说明，使用以下命令

kubectl explain pod.apiVersion

⒌资源清单格式

apiVersion: group/apiversion #如果没有给定group名称，那么默认为core，可以使用kubectlapi-versions命令获取当前k8s版本上所有的apiversion版本信息（每个版本可能不同）kind: #资源类别
metadata: #资源元数据
 name:
 namespace:
 lables:
 annotations: #主要目的是方便用户阅读查找
spec: #期望的状态（disired state)
status: #当前状态，本字段由Kubernetes自身维护，用户不能去定义

⒍资源清单的常用命令

　　1.获取apiVersion版本信息

kubectl api-versions

　　2.获取资源的apiVersion的版本信息(以pod为例)，该命令同时输出属性设置帮助文档

kubectl explain pod

　　*字段配置格式

apiVersion <string> #表示字符串类型
metadata <Object> #表示需要嵌套多层字段
1abels <map[string]string> #表示由k：v组成的映射
finalizers <[]string> #表示字串列表
ownerReferences <[]Object>#表示对象列表
hostPID <boolean> #布尔类型
priority <integer> #整型
name <string> -required- #如果类型后面接-required-，表示为必填字段

⒎示例：通过定义清单文件创建Pod

apiVersion: v1
kind: Pod
metadata:
 name: pod-demo
 namespace: default
 1abels:
  app:myapp
spec:
 containers:
 - name: myapp-1
   image: hub.coreqi.cn/1ibrary/myapp:v1
 - name: busybox-1
   image: busybox:latest
   command:
   - "/bin/sh"
   - "-c"
   - "sleep 3600"

　　通过yaml文件创建pod

kubectl create -f xxx.yaml

　　获取资源的资源配置文件

#使用 -o 参数 加 yaml，可以将资源的配置以yaml的格式输出出来，也可以使用json，输出为json格式
kubectl get pod {podName} -o yaml