资源清单
清单书写格式:
vim pod.yml ##创建一个yml文件
apiVersion: group/version ##指明api资源属于那个群组和版本,同一个组可以有多个版本
kind: ##标记创建的资源类型,k8s主要支持以下资源类别
Pod,ReplicaSet,Deployment,Statefulset,DaemonSet,Job,Cronjob ##这些资源中选一个。
metadata: ##元数据
name: ##对象名称
namespace: ##对象属于哪个命名空间
labels: ##指定资源标签,标签是一种键值数据
spec: ##定义目标资源的期望状态
以上是一个清单的大概书写格式,在书写清单时我们也可以通过修改别人书写的清单来完成目标。前提是,我们得看懂清单里面的内容。接下来将一一讲解参数的含义。
参数名/字符类型 | 说明 |
---|---|
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 | 这里是定义要用到的镜像名称 |
spec.containers[].imagePullPolicy / String | 定义镜像拉取策略,有Always,Nerver,IfNotPresent三个值可选。Always:意思是每次都尝试重新拉取镜像。Nerver:表示仅使用本地镜像。IfNotPresent:如果本地有镜像就使用本地镜像,没有就拉取在线镜像。上面三个值都没有设置的话,默认是Always。 |
spec.containers[].commaned / 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资源限制有讲过 |