文章目录- Yaml 格式的 Pod 定义文件的完整内容如下
- 对 Pod 定义文件模板中各属性的详细说明
- 如果记不住
Yaml 格式的 Pod 定义文件的完整内容如下
代码语言:javascript复制apiVersion: v1
kind: Pod
metadate:
name: string
namespace: string
labels:
- name: string
annotations:
- name: string
spce:
containers:
- name: string
image: string
imagePullPolicy: [Always | Never | IfNotPresent]
command: [string]
args: [string]
workingDir: string
vilumnMounts:
- name: string
mountsPath: string
readOnly: boolean
ports:
- name: string
containerPort: int
hostPort: int
protocol: string
env:
- name: string
value: string
resource:
limits:
cpu: string
memory: string
requests:
cpu: string
memory: string
livenessProbe:
exec:
command: [string]
httpGet:
path: string
port: string
host: string
scheme: string
httpHeaders:
- name: string
values: string
tcpSocket:
port: number
initialDelaySeconds: 0
timeoutSeconds: 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
对 Pod 定义文件模板中各属性的详细说明
属性名称 | 取值类型 | 是否必选 | 取值说明 | 备注 |
---|---|---|---|---|
apiVersion | string | Required | 版本号 | |
kind | string | Required | 资源类型 | |
meatdate | object | Required | 元数据 | |
m.name | string | Required | pod 名称 | |
m.namespace | string | Required | pod 所属命名空间 | 默认为 default |
m.labels | list | 自定义标签列表 | ||
m.annotation | list | 自定义注解列表 | ||
spec | object | Required | pod 中容器的详细定义 | |
s.containers | list | Required | pod 中的容器列表 | |
s.c.name | string | Required | 容器名称 | |
s.c.image | string | Required | 容器镜像 | |
s.c.imagePullPolicy | string | 容器拉取策略: | Always(默认) | IfNotPresent | Never | |
s.c.command | list | 容器启动命令列表 | 如果不指定,则使用镜像打包时设定的启动命令 | |
s.c.args | list | 容器启动命令参数列表 | ||
s.c.workingDir | string | 容器的工作目录 | ||
s.c.volumeMounts | list | 挂载到容器内部的存储卷配置 | ||
s.c.v.name | string | 引用 pod 定义的共享存储卷名称 | ||
s.c.v.mountPath | string | 存储卷在容器内挂载的绝对路径 | ||
s.c.v.readOnly | boolean | 是否为只读模式 | 默认为读写模式 | |
s.c.ports | list | 容器的端口号列表 | ||
s.c.p.name | string | 端口的名称 | ||
s.c.p.containerPort | string | 容器需要监听的端口号 | ||
s.c.p.hostPost | string | 容器所在的主机需要监听的端口号 | 设置该项,同一台宿主机将无法启动该容器的第二份副本 | |
s.c.p.protocol | string | 端口协议,支持 TCP 和 UDP,默认使用 TCP | ||
s.c.env | list | 容器运行前虚设置的环境变量列表 | ||
s.c.e.name | string | 环境变量的名称 | ||
s.c.e.value | string | 环境变量的值 | ||
s.c.resources | object | 资源限制和资源请求的设置 | ||
s.c.r.limits | object | 资源限制的设置 | ||
s.c.r.l.cpu | string | CPU 限制,单位为 core 核数 | ||
s.c.r.l.memory | string | 内存限制,单位可以为 MiB,GiB 等 | ||
s.c.r.requests | object | 资源请求的设置 | ||
s.c.r.r.cpu | string | CPU 请求 | ||
s.c.r.r.memory | string | 内存请求 | ||
s.volumes | list | 在该 pod 上定义的共享存储列表 | ||
s.v.name | string | 共享存储卷的名称 | 1 | |
s.v.emptyDir | object | 类型为 emptyDir 的存储卷 | ||
s.v.hostPath | object | 类型为 hostPath 的存储卷 | ||
s.v.h.path | string | Pod 容器挂载的宿主机目录 | ||
s.v.secret | object | 类型为 secret 的存储卷 | 表示挂载集群预定义的 Secret 到容器内部 | |
s.v.configMap | object | 类型为 configMap 的存储卷 | 表示挂载集群预定义的 ConfigMap 到容器内部 | |
s.livenessProbe | object | 对 Pod 内各容器健康检查的设置 | 当探测几次无反应后,将依据重启策略干活 | |
s.l.exec | object | 对 Pod 内各容器健康检查的设置,exec 方式 | ||
s.l.e.command | string | exec 方式需要制定的命令或脚本 | ||
s.l.httpGet | object | 对 Pod 内各容器健康检查的设置,httpGet 方式 | ||
s.l.tcpSocket | object | 对 Pod 内各容器健康检查的设置,tcpSocket 方式 | ||
s.l.initDelaySeconds | number | 容器启动完成后首次探测的时间 | ||
s.l.timeoutSeconds | number | 对容器健康检查的探测等待超时时间,默认为1s | ||
s.l.periodSeconds | number | 对容器健康的定期探测时间设置,默认 10 s 一次 | ||
s.restartPolicy | string | Pod 的重启方式 | Always | Never | OnFailure,默认为 Always | |
s.nodeSelector | object | 设置 node 的 label,pod 将被指定到具有这些 Label 的 node 上 | ||
s.imagePullSecrets | object | pull 推送镜像时使用的 Secret 名称 | ||
s.hostNetwork | boolean | 是否使用主机网络模式,默认为false | 使用主机网络模式,该 Pod 将无法在宿主机上启动第二个副本 |
如果记不住
如果上面的详细清单记不住,可以使用如下kubectl explain工具随时查看:
代码语言:javascript复制#小提示:
# 在这里,可通过一个命令来查看每种资源的可配置项
# kubectl explain 资源类型 查看某种资源可以配置的一级属性
# kubectl explain 资源类型.属性 查看属性的子属性
[root@k8s-master01 ~]# kubectl explain pod
KIND: Pod
VERSION: v1
FIELDS:
apiVersion <string>
kind <string>
metadata <Object>
spec <Object>
status <Object>
[root@k8s-master01 ~]# kubectl explain pod.metadata
KIND: Pod
VERSION: v1
RESOURCE: metadata <Object>
FIELDS:
annotations <map[string]string>
clusterName <string>
creationTimestamp <string>
deletionGracePeriodSeconds <integer>
deletionTimestamp <string>
finalizers <[]string>
generateName <string>
generation <integer>
labels <map[string]string>
managedFields <[]Object>
name <string>
namespace <string>
ownerReferences <[]Object>
resourceVersion <string>
selfLink <string>
uid <string>