资源清单描述方法 · Kubernetes

**1. 资源清单** 在 k8s 中，一般使用 YAML 格式的文件来创建符合我们预期期望的 pod，这样的 YAML 文件称为资源清单。 **2. 常用属性** :-: **1. 必须存在的属性** | 属性名 | 属性值类型 | 说明 | | --- | --- | --- | | apiVersion | 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 | 这里定义要用到的镜像名称 | :-: **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、Never，默认值为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 将无法在同一台宿主机上启动第二个副本。 | **3. 举例说明** （1）创建一个namespace。 ```yaml apiVersion: v1 kind: Namespace metadata: name: test ``` （2）创建一个pod。 ```yaml apiVersion: v1 kind: Pod metadata: name: pod1 spec: containers: - name: nginx-containers image: nginx:latest ```