YAML格式的Pod定义文件的完整内容如下:
apiVersion: v1
kind: Pod
metadata:
name: string
namespace: string
labels:
- name: string
annotations:
- name: string
spec:
containers:
- name: string
image: string
imagePullPolicy: [Always | Never | IfNotPresent]
command: [string]
args: [string]
workingDir: string
volumeMounts:
- name: string
mountPath: string
readOnly: boolean
ports:
- name: string
containerPort: int
hostPort: int
protocol: string
env:
- name: string
value:string
resources:
limits:
cpu: string
memory: string
requests:
cpu: string
memory: string
livenessProbe:
exec:
command: [string]
httpGet:
path: string
port: number
host: string
scheme: string
httpHeaders:
- name: string
value: string
tcpSocket:
port: number
initialDelaySeconds: 0
timeoutSeconds: 0
periodSeconds: 0
successThreshold: 0
failureThreshold: 0
securityContext:
privileged: false
restartPolicy: [Always | Never | OnFailure]
nodeSelector: object
imagePullSecrets:
- name: string
hostNetwork: false
volumes:
- name: string
emptyDir: {}
hostPath:
path: string
secret:
secretName: string
items:
- key: string
path: string
configMap:
name: string
items:
- key: string
path: string
属性名称 | 取值说明 |
---|---|
apiVersion | 版本号,例如v1,获取可用版本号:kubectl api-versions |
kind | Pod |
metadata | 元数据 |
metadata.name | Pod的名称,命名规范需符合RFC 1035规范 |
metadata.namespace | Pod所属的命名空间,默认值为default |
metadata.labels[] | 自定义标签列表 |
metadata.annotation[] | 自定义注解列表 |
Spec | Pod中容器的详细定义 |
spec.containers[] | Pod中的容器列表 |
spec.containers[].name | 容器的名称,需符合RFC 1035规范 |
spec.containers[].image | 容器的镜像名称 |
spec.containers[].imagePullPolicy | 镜像拉取策略,可选值包括:Always,Never,IfNotPresent,默认值为Always 。(1)Always:表示每次都尝试重新拉取镜像。(2)IfNotPresent:表示如果本地有该镜像,则使用本地的镜像,本地不存在时拉取镜像。(3)Never: 表示仅使用本地镜像。另外,如果包含如下设置,系统则将默认设置imagePullPolicy=Always,如下所述:(1)不设置imagePullPolicy,也未指定镜像的tag。(2)不设置imagePullPolicy,镜像tag为latest。(3)启用了名为AlwaysPullImages 的准入控制器(Adminssion Controller) |
spec.containers[].command | 容器的启用命令列表,如果不指定,则使用镜像打包时使用的启动命令 |
spec.containers[].args[] | 容器的启用命令参数列表 |
spec.containers[].workingDir | 容器的工作目录 |
spec.containers[].volumeMounts[] | 挂载到容器内部的存储卷配置 |
spec.containers[].volumeMounts[].name | 引用Pod定义的共享存储卷的名称,需使用volumes[]部分定义的共享存储卷名称 |
spec.containers[].volumeMounts[].mountPath | 存储卷在容器内挂载的绝对路径,应少于512个字符 |
spec.containers[].volumeMounts[].readOnly | 是否为只读模式,默认为读写模式 |
spec.containers[].ports[] | 容器需要暴露的端口号列表 |
spec.containers[].ports[] .name | 端口的名称 |
spec.containers[].ports[] .containerPort | 容器需要监听的端口号 |
spec.containers[].ports[] .hostPort | 容器所在主机需要监听的端口号,默认与containerPort相同,设置hostPort时,同一台宿主机将无法启动该容器的第二份副本 |
spec.containers[].ports[] .protocol | 端口协议,支持TCP和UDP,默认值为TCP |
spec.containers[].env[] | 容器运行前需设置的环境变量列表 |
spec.containers[].env[] .name | 环境变量的名称 |
spec.containers[].env[] .value | 环境变量的值 |
spec.containers[].resources | 资源限制和资源请求的设置 |
spec.containers[].resources .limits | 资源限制的设置 |
spec.containers[].resources .limits.cpu | CPU限制,单位为core数,将用于docker run --cpu-shares 参数 |
spec.containers[].resources .limits.memory | 内存限制,单位可以为MiB,GiB等,将用于docker run --memory 参数 |
spec.containers[].resources .requests | 资源限制的设置 |
spec.containers[].resources .requests.cpu | CPU请求,单位为core数,容器启动的初始可用数量 |
spec.containers[].resources .requests.memory | 内存请求,单位可以为MiB,GiB等,容器启动的初始可用数量 |
spec.volumes[] | 在该Pod 上定义的共享存储卷列表 |
spec.volumes[].name | 共享存储卷的名称,在一个Pod中每个存储卷定义一个名称,应符合RFC 1035规范,容器定义部分的containers[],volumeMounts[].name将引用该共享存储卷名称。 |
spec.volumes[].emptyDir | 类型为emptyDir的存储卷,表示与Pod同生命周期的一个临时目录,其值为一个空对象:emptyDir:{} |
spec.volumes[].hostPath | 类型为hostPath的存储卷,表示Pod容器挂载的宿主机目录,通过volumes[].hostPath.path指定 |
spec.volumes[] .hostPath.path | Pod容器挂载的宿主机目录 |
spec.volumes[].secret | 类型为configMap的存储卷,表示挂载集群预定义的secret对象到容器内部 |
spec.volumes[].configMap | 类型为configMap的存储卷,表示挂载集群预定义的configMap对象到容器内部 |
spec.volumes[] .livenessProbe | 对Pod内各容器健康检查的设置,当探测无响应几次之后,系统将自动重启该容器,可以设置的方法包括:exec ,httpGet 和tcpSocket,对一个容器仅需设置一种健康检查方法 |
spec.volumes[].livenessProbe.exec | 对Pod内各容器健康检查的设置,exec的方式 |
spec.volumes[].livenessProbe.exec.command[] | exec方式需要指定的命令或者脚本 |
spec.volumes[].livenessProbe.httpGet | 对Pod内各容器健康的设置,HTTPGet方式,需指定path,port |
spec.volumes[].livenessProbe.tcpSocket | 对Pod内各容器健康的设置,tcpSocket方式 |
spec.volumes[].livenessProbe.initialDelaySeconds | 容器启动完成后首次探测的时间,单位为s |
spec.volumes[].livenessProbe.timeoutSeconds | 对容器健康的探测等待响应的超时时间设置,单位为s ,默认值为1,若超过该超时时间设置,则将默认该容器不健康,会重启该容器 |
spec.volumes[].livenessProbe.periodSeconds | 对容器健康检查的定期探测时间设置,单位为s,默认10s 探测一次 |
spec.restartPolicy | Pod 重启策略,可选值为Always,OnFailure,Never ,默认值为Always。(1)Always:Pod一旦终止运行,则无论容器是如何终止的,kubelet 都将重启它。(2)OnFailure: 只有Pod以非零退出码终止时,kubelet才会重启该容器,如果容器正常结束(退出码为0),则kubelet将不会重启它。(3)Never: Pod终止后,kubelet将退出码报告给Master,不会再重启该Pod |
spec.nodeSelector | 设置Node的Label,以key:value格式指定,Pod将被调度到具有这些Label的Node上 |
spec.imagePullSecrets | pull 镜像时使用Secret 名称,以name:secretkey 格式指定 |
spec.hostNetwork | 是否使用主机网络模式,默认值为false,设置为true 表示容器使用宿主机网络,不再使用Docker网桥,该Pod 将无法在同一台宿主机上启动第二个副本 |