Kubernetes 资源清单 常用字段,Pod 实例

一 集群资源分类

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

1.名称空间级别:仅在此名称空间下生效。

① 工作负载型资源(workload):Pod,ReplicaSet,Deployment,StatefulSet,DaemonSet,Job,CronJob( ReplicationController 在 v1.11 版本被废弃 )

② 服务发现及负载均衡型资源(ServiceDiscovery  LoadBalance ):Service,Ingress...

③ 配置与存储型资源:Volume( 存储卷 ),CSI(容器存储接口,可以扩展各种各样的第三方存储卷)

④ 特殊类型的存储卷:ConfigMap(当配置中来使用的资源那类型),Secret(保存敏感数据),DownwardAPI(把外部环境中的信息输出给容器)

 

2.集群级别:不管在什么名称空间下定义,在其他的名称空间中都能看的到。

例如:Namespace,Node,Role,ClusterRole,RoleBinding,ClusterRoleBinding

 

3.元数据型

例如:HPA,PodTemplate,LimitRange

 

二 常用字段说明

1.必须存在的属性

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

 

 

 

 

 

 

 

 

 

 

 






2.spec 主要对象

参数名 字段类型 说明
spec.containers[].name String 定义容器的名字
spec.containers[].image String 定义要用到的镜像的名称
spec.containers[].imagePullPolicy String 定义镜像拉取策略,有 Always,Never,IfNotPresent 三个值课选 (1)Always:意思是每次尝试重新拉取镜像 (2)Never:表示仅使用本地镜像 (3)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 参数
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 容器启动的初始化可用数量

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 






















3.额外的参数项

参数名 字段类型 说明
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 将无法在同一台宿主机上启动第二个副本。

 

 

 

 

 

 

 

 

 









 

以上是 pod 常用的一些资源清单 属性信息,如果想查看更多,可以使用一下命令查看

#查看 pod 的模板属性
kubectl explain pod

#查看 pod 的 spec 模板中的属性
kubectl explain pod.spec

 

 

4.创建 Pod 的资源模板 实例

创建 pod yaml文件

vim pod.yaml

 

编写yaml 文件内容

apiVersion: v1
kind: Pod
metadata:
  name: myapp-pod
  labels:
    app: myapp
    version: v1
spec:
  containers: 
  -  name: app
     image: hub.harbor.com/kubernetes-test/kubernetes-test:latest

 

测试启动 Pod

kubectl apply -f pod.yaml

#查看 pod 是否启动成功
kubectl get pod

 

posted @ 2020-04-04 18:03  谋知  阅读(681)  评论(0编辑  收藏  举报