第 4 章 API 对象引用

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(MutatingWebhookConfiguration)

MutatingWebhookConfiguration 列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ValidatingWebhookConfiguration)

ValidatingWebhookConfiguration 列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ControllerRevision)

items 是 ControllerRevisions 列表

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(DaemonSet)

守护进程集列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Deployment)

items 是 Deployments 列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ReplicaSet)

ReplicaSets 列表。更多信息： https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(StatefulSet)

items 是有状态的集合的列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表的元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(HorizontalPodAutoscaler)

items 是 pod 横向自动扩展对象的列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

metadata 是标准列表元数据。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(CronJob)

items 是 CronJobs 的列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Job)

items 是作业列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(CertificateSigningRequest)

items 是 CertificateSigningRequest 对象的集合

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Lease)

items 是 schema 对象列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

nodeAffinity

nodeAffinity

描述 pod 的节点关联性调度规则。

podAffinity

podAffinity

描述 pod 关联性调度规则（例如，将这个 pod 放置到同一节点、区域等）中。

podAntiAffinity

podAntiAffinity

描述 pod 反关联性调度规则（例如，避免将此 pod 放置到同一节点、区域等）中。

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

分区

整数

partition 是您要挂载的卷中的分区。如果省略，则默认为按卷名称挂载。示例：对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷分区是 "0" （或者您可以将属性留空）。

readOnly

布尔值

readonly 值 true 将强制 VolumeMounts 中的 readOnly 设置。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

VolumeId 是 AWS (Amazon EBS 卷)中的持久磁盘资源的唯一 ID。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

cachingMode

string

cachingMode 是主机缓存模式： None、Read Only、Read Write。

可能枚举值： - "None" - "ReadOnly" - "ReadWrite"

diskName

string

diskname 是 blob 存储中的数据磁盘的名称

diskURI

string

diskURI 是 blob 存储中数据磁盘的 URI

fsType

string

fstype 是要挂载的 Filesystem 类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

kind

string

kind expected 值是 Shared: multiple blob disk per storage account Managed: azure disk per storage account Managed: azure managed data disk (only in managed availability set)）。默认为 shared

possible enum 值： - "Dedicated" - "Managed" - "Shared"

readOnly

布尔值

只读默认值为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

readOnly

布尔值

只读默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

secretName

string

secretName 是包含 Azure Storage Account Name 和 Key 的 secret 名称

secretNamespace

string

secretNamespace 是包含 Azure Storage Account Name 和 Key default 的 secret 的命名空间与 Pod 相同

shareName

string

sharename 是 azure Share Name

readOnly

布尔值

只读默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

secretName

string

secretName 是包含 Azure Storage Account Name 和 Key 的 secret 名称

shareName

string

sharename 是 azure 共享名称

add

数组（字符串）

添加了功能

drop

数组（字符串）

删除的功能

monitor

数组（字符串）

Monitors is Required: Monitor is a collection of Ceph monitors more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

路径为可选： 作为挂载的 root 使用，而不是完整的 Ceph 树，默认为 /

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretfile 是可选：SecretFile 是 User 的密钥环的路径，默认为 /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

secretReference

secretRef 是可选的：SecretRef 是对 User 的身份验证 secret 的引用，默认为空。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

用户是可选的： User 是 rados 用户名，默认为 admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

monitor

数组（字符串）

Monitors is Required: Monitor is a collection of Ceph monitors more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

路径为可选： 作为挂载的 root 使用，而不是完整的 Ceph 树，默认为 /

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretfile 是可选：SecretFile 是 User 的密钥环的路径，默认为 /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

LocalObjectReference

secretRef 是可选的：SecretRef 是对 User 的身份验证 secret 的引用，默认为空。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

user

string

用户是可选的： User 是 rados 用户名，默认为 admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

fsType

string

要挂载的 fstype Filesystem 类型。必须是主机操作系统支持的文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

secretReference

secretRef 是可选的：指向包含用于连接 OpenStack 的参数的 secret 对象。

volumeID

string

用于识别 cinder 中的卷的卷 ID。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

布尔值

只读默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

LocalObjectReference

secretRef 是可选的：指向包含用于连接 OpenStack 的参数的 secret 对象。

volumeID

string

用于识别 cinder 中的卷的卷 ID。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

resourceClaimName

string

ResourceClaimName 是与这个 pod 相同的命名空间中的 ResourceClaim 对象的名称。

resourceClaimTemplateName

string

ResourceClaimTemplateName 是与这个 pod 相同的命名空间中的 ResourceClaimTemplate 对象的名称。

模板将用于创建新的 ResourceClaim，它将绑定到此 pod。删除此 pod 后，ResourceClaim 也会被删除。ResourceClaim 的名称将是 <pod name>-<resource name>，其中 <resource name> 是 PodResourceClaim.Name。如果串联名称对 ResourceClaim 无效（如太长，则 Pod 验证将拒绝 pod）。

没有为 pod 拥有该名称的现有 ResourceClaim 不会被用于 pod，以避免错误地使用不相关的资源。然后，调度和 pod 启动会被阻断，直到删除不相关的 ResourceClaim。

此字段不可变，在创建 ResourceClaim 后，control plane 不会对对应的 ResourceClaim 进行更改。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ComponentStatus)

组件状态对象列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap 还是其键

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(ConfigMap)

items 是 ConfigMap 的列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

items

数组(KeyToPath)

如果未指定项目，则引用 ConfigMap 的 Data 字段中的每一键值对将投射到卷中，名称为键，内容是值。如果指定，列出的键将投射到指定的路径中，且未列出的密钥将不存在。如果指定了在 ConfigMap 中不存在的密钥，则卷设置将错误，除非标记为可选。路径必须是 relative，且不能包含 '..' 路径或以 '..' 开头。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

可选指定是否必须定义 ConfigMap 还是其键

defaultMode

整数

defaultMode 是可选的：用于默认设置创建文件的权限的模式位。必须是 0000 到 0777 之间的数值，也可以是 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值，JSON 需要模式位的十进制值。默认值为 0644。该路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是设置其他模式位。

items

数组(KeyToPath)

如果未指定项目，则引用 ConfigMap 的 Data 字段中的每一键值对将投射到卷中，名称为键，内容是值。如果指定，列出的键将投射到指定的路径中，且未列出的密钥将不存在。如果指定了在 ConfigMap 中不存在的密钥，则卷设置将错误，除非标记为可选。路径必须是 relative，且不能包含 '..' 路径或以 '..' 开头。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

可选指定是否必须定义 ConfigMap 还是其键

args

数组（字符串）

入口点的参数。如果没有提供，则使用容器镜像的 CMD。变量引用 $(VAR_NAME)使用容器环境扩展。如果无法解析变量，输入字符串中的引用将不会改变。双引号被减少为一个 $，它允许转义 $(VAR_NAME)语法：例如：" (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会被扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

命令

数组（字符串）

ENTRYPOINT 数组.不会在 shell 中执行。如果没有提供，则使用容器镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器环境扩展。如果无法解析变量，输入字符串中的引用将不会改变。双引号被减少为一个 $，它允许转义 $(VAR_NAME)语法：例如：" (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会被扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

数组(EnvVar)

要在容器中设置的环境变量列表。无法更新。

envFrom

数组(EnvFromSource)

用于在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时，所有无效的密钥都会被报告为事件。当多个源中存在键时，与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。

image

string

容器镜像名称。更多信息： https://kubernetes.io/docs/concepts/containers/images 此字段是可选的，允许更高级别的配置管理默认或覆盖工作负载控制器中的容器镜像，如 Deployment 和 StatefulSets。

imagePullPolicy

字符串

镜像拉取策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签，则默认为 Always，否则为 IfNotPresent。无法更新。更多信息： https://kubernetes.io/docs/concepts/containers/images#updating-images

可能枚举值： - "Always" 表示 kubelet 始终会尝试拉取最新的镜像。如果拉取失败，则容器将失败。- "IfNotPresent" 表示 kubelet 在磁盘上不存在时拉取。如果镜像不存在，且拉取失败，则容器将失败。- "Never" 表示 kubelet 不会拉取镜像，但只使用本地镜像。如果镜像不存在，容器将失败

生命周期

生命周期

管理系统应采取的操作来响应容器生命周期事件。无法更新。

livenessProbe

probe

容器存活度的定期探测.如果探测失败，将重启容器。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

name

字符串

指定为 DNS_LABEL 的容器的名称。pod 中的每个容器都必须具有唯一名称(DNS_LABEL)。无法更新。

ports

数组(ContainerPort)

要从容器公开的端口列表。不在此处指定端口 不会阻止公开该端口。任何正在侦听容器内的默认"0.0.0.0"地址的端口都可以从网络访问。使用战略合并补丁修改此阵列可能会破坏数据。如需更多信息，请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。

readinessProbe

probe

容器服务的定期探测就绪。如果探测失败，容器将从服务端点中删除。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

resizePolicy

数组(ContainerResizePolicy)

容器的资源重新定义策略大小。

resources

ResourceRequirements

此容器所需的计算资源。无法更新。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

securityContext

SecurityContext

securityContext 定义容器应使用运行的安全选项。如果设置，SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息： https://kubernetes.io/docs/tasks/configure-pod-container/security-context/

startupProbe

probe

startupProbe 表示 Pod 已成功初始化。如果指定，则不会执行其他探测，直到成功完成为止。如果这个探测失败，则 Pod 将重启，就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数，当可能需要很长时间才能加载数据或温缓存，而不是在 steady-state 操作期间进行。这不能被更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

stdin

布尔值

此容器是否应该为容器运行时中的 stdin 分配缓冲区。如果没有设置，则从容器中的 stdin 读取总是会导致 EOF。默认值为 false。

stdinOnce

布尔值

容器运行时是否应该在单个附加打开后关闭 stdin 频道。当 stdin 为 true 时，stdin 流将在多个附加会话之间保持打开。如果将 stdinOnce 设为 true，则 stdin 在容器启动时打开，会为空，直到第一个客户端附加到 stdin，然后保持打开并接受数据，直到客户端断开连接，而时间 stdin 被关闭并保持关闭，直到容器重启为止。如果此标志为 false，则从 stdin 读取的容器进程永远不会收到 EOF。默认值为 false

terminationMessagePath

字符串

可选：将容器终止消息写入的文件路径被挂载到容器文件系统中。编写的消息应该是简短的最终状态，如断言失败消息。如果大于 4096 字节，则节点将被截断。所有容器的消息长度限制为 12kb。默认为 /dev/termination-log。无法更新。

terminationMessagePolicy

字符串

指明如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功和失败时填充容器状态消息。如果终止消息文件为空，并且容器退出并显示错误，则 FallbackToLogsOnError 将使用容器日志输出的最后块。日志输出限制为 2048 字节或 80 行，以较大者为准。默认为 file。无法更新。

可能的 enum 值： - "FallbackToLogsOnError" 会在容器退出时读取容器状态消息的最新内容，且 terminationMessagePath 没有内容。- "File" 是默认行为，并将容器状态消息设置为容器终止MessagePath 的内容。

tty

布尔值

此容器是否应为自己分配 TTY，还需要 'stdin' 为 true。默认值为 false。

volumeDevices

数组(VolumeDevice)

volumeDevices 是容器使用的块设备列表。

volumeMounts

数组(VolumeMount)

要挂载到容器文件系统中的 Pod 卷。无法更新。

workingDir

字符串

容器的工作目录。如果没有指定，则使用容器运行时的默认值，这可能会在容器镜像中配置。无法更新。

containerPort

整数

在 pod 的 IP 地址上公开的端口号。这必须是有效的端口号 0 < x < 65536。

hostIP

字符串

将外部端口绑定到的主机 IP。

hostPort

整数

要在主机上公开的端口号。如果指定，这必须是有效的端口号，0 < x < 65536。如果指定了 HostNetwork，则必须匹配 ContainerPort。大多数容器都不需要此操作。

name

字符串

如果指定，这必须是 IANA_SVC_NAME，并在 pod 中唯一。pod 中的每个指定端口都必须具有唯一的名称。服务可以引用的端口的名称。

protocol

字符串

端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。

可能的值有： - "SCTP" 是 SCTP 协议。- "TCP" 是 TCP 协议。- "UDP" 是 UDP 协议。

resourceName

string

应用此资源调整大小策略的资源名称。支持的值：cpu、memory。

restartPolicy

string

在调整指定资源大小时，重启策略会应用。如果没有指定，则默认为 NotRequired。

controllerExpandSecretRef

secretReference

controllerExpandSecretRef 是对包含要传递给 CSI 驱动程序的敏感信息的 secret 对象的引用，以完成 CSI ControllerExpandVolume 调用。此字段是可选的，如果不需要 secret，则可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会被传递。

controllerPublishSecretRef

secretReference

controllerPublishSecretRef 是对包含要传递给 CSI 驱动程序的 secret 对象的引用，以完成 CSI ControllerPublishVolume 和 ControllerUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会被传递。

driver

string

driver 是要用于此卷的驱动程序名称。必需。

fsType

string

要挂载的 fstype。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".

nodeExpandSecretRef

secretReference

nodeExpandSecretRef 是对包含要传递给 CSI 驱动程序的 secret 对象的引用，以完成 CSI NodeExpandVolume 调用。这是一个 beta 字段，由 CSINodeExpandSecret 功能门启用。如果不需要 secret，则可以省略此字段。如果 secret 对象包含多个 secret，则所有 secret 都会被传递。

nodePublishSecretRef

secretReference

nodePublishSecretRef 是对包含要传递给 CSI 驱动程序的 secret 对象的引用，以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会被传递。

nodeStageSecretRef

secretReference

nodeStageSecretRef 是包含传递给 CSI 驱动程序的 secret 对象的引用，以完成 CSI NodeStageVolume 和 NodeStageVolume 和 NodeUnstageVolume 调用。此字段是可选的，如果不需要 secret，则可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会被传递。

readOnly

布尔值

传递给 ControllerPublishVolumeRequest 的 readonly 值。默认为 false （读/写）。

volumeAttributes

对象（字符串）

要发布的卷的 volumeAttributes。

volumeHandle

string

volumeHandle 是 CSI 卷插件的 CreateVolume 返回的唯一卷名称，以在所有后续调用中引用卷。必需。

driver

string

driver 是处理这个卷的 CSI 驱动程序的名称。请参考您的管理员获取集群中注册的正确名称。

fsType

string

要挂载的 fstype。Ex. "ext4", "xfs", "ntfs".如果没有提供，空值会被传递给关联的 CSI 驱动程序，该驱动程序将决定要应用的默认文件系统。

nodePublishSecretRef

LocalObjectReference

nodePublishSecretRef 是对包含要传递给 CSI 驱动程序的 secret 对象的引用，以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的，如果不需要 secret，则可能为空。如果 secret 对象包含多个 secret，则所有 secret 引用都会传递。

readOnly

布尔值

readonly 指定卷的只读配置。默认为 false （读/写）。

volumeAttributes

对象（字符串）

volumeAttributes 存储传递给 CSI 驱动程序的特定于驱动程序的属性。如需支持的值，请参考您的驱动程序文档。

items

数组(DownwardAPIVolumeFile)

items 是 DownwardAPIVolume 文件列表

fieldRef

ObjectFieldSelector

必需：选择 pod 的字段：只支持注解、标签、名称和命名空间。

模式

整数

可选：用于在此文件上设置权限的模式位，必须是 0000 到 0777 之间或 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值，JSON 需要模式位的十进制值。如果没有指定，则使用卷 defaultMode。这可能会与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是设置其他模式位。

path

字符串

必需：Path 是要创建的文件的相对路径名称。不能绝对或包含 '..' 路径。必须采用 utf-8 编码。相对路径的第一个项目不能以 '..' 开头。

resourceFieldRef

ResourceFieldSelector

选择容器的资源：当前仅支持资源限值和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。

defaultMode

整数

可选：默认在创建的文件中使用的模式位。必须是可选：用于默认设置创建文件的权限的模式位。必须是 0000 到 0777 之间的数值，也可以是 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值，JSON 需要模式位的十进制值。默认值为 0644。该路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是设置其他模式位。

items

数组(DownwardAPIVolumeFile)

items 是 Downward API 卷文件列表

中

string

Medium 代表这个目录应该支持哪些存储类型。默认值为 ""，它需要使用节点的默认介质。必须是空字符串（默认）或 Memory。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

数量

sizeLimit 是此 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存用量 EmptyDir 的最大用法是此处指定的 SizeLimit 和 pod 中所有容器的内存限值总和。默认值为 nil，表示限制未定义。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#emptydir

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Endpoints)

端点列表。

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

configMapRef

ConfigMapEnvSource

要从中选择的 ConfigMap

prefix

字符串

用于添加到 ConfigMap 中每个键的可选标识符。必须是 C_IDENTIFIER。

secretRef

SecretEnvSource

要从中选择的 Secret

name

字符串

环境变量的名称。必须是 C_IDENTIFIER。

value

字符串

变量引用 $(VAR_NAME)使用容器中之前定义的环境变量和任何服务环境变量进行扩展。如果无法解析变量，输入字符串中的引用将不会改变。双引号被减少为一个 $，它允许转义 $(VAR_NAME)语法：例如：" (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会被扩展，无论变量是否存在。默认值为 ""。

valueFrom

EnvVarSource

环境变量的值的源。如果 value 不是空，则无法使用。

configMapKeyRef

ConfigMapKeySelector

选择 ConfigMap 的密钥。

fieldRef

ObjectFieldSelector

选择 pod 的字段：支持 metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs.

resourceFieldRef

ResourceFieldSelector

选择容器的资源：当前仅支持资源限值和请求(limits.cpu、limits.memory、limits.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。

secretKeyRef

SecretKeySelector

在 pod 命名空间中选择 secret 的密钥

args

数组（字符串）

入口点的参数。如果没有提供，则使用镜像的 CMD。变量引用 $(VAR_NAME)使用容器环境扩展。如果无法解析变量，输入字符串中的引用将不会改变。双引号被减少为一个 $，它允许转义 $(VAR_NAME)语法：例如：" (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会被扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

命令

数组（字符串）

ENTRYPOINT 数组.不会在 shell 中执行。如果没有提供，则使用镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器环境扩展。如果无法解析变量，输入字符串中的引用将不会改变。双引号被减少为一个 $，它允许转义 $(VAR_NAME)语法：例如：" (VAR_NAME) " 将生成字符串 literal "$(VAR_NAME) "。转义的引用永远不会被扩展，无论变量是否存在。无法更新。更多信息： https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

数组(EnvVar)

要在容器中设置的环境变量列表。无法更新。

envFrom

数组(EnvFromSource)

用于在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时，所有无效的密钥都会被报告为事件。当多个源中存在键时，与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。

image

string

容器镜像名称。更多信息： https://kubernetes.io/docs/concepts/containers/images

imagePullPolicy

字符串

镜像拉取策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签，则默认为 Always，否则为 IfNotPresent。无法更新。更多信息： https://kubernetes.io/docs/concepts/containers/images#updating-images

可能枚举值： - "Always" 表示 kubelet 始终会尝试拉取最新的镜像。如果拉取失败，则容器将失败。- "IfNotPresent" 表示 kubelet 在磁盘上不存在时拉取。如果镜像不存在，且拉取失败，则容器将失败。- "Never" 表示 kubelet 不会拉取镜像，但只使用本地镜像。如果镜像不存在，容器将失败

生命周期

生命周期

临时容器不允许使用生命周期。

livenessProbe

probe

临时容器不允许探测。

name

字符串

指定为 DNS_LABEL 的临时容器的名称。此名称在所有容器、init 容器和临时容器中必须是唯一的。

ports

数组(ContainerPort)

临时容器不允许使用端口。

readinessProbe

probe

临时容器不允许探测。

resizePolicy

数组(ContainerResizePolicy)

容器的资源重新定义策略大小。

resources

ResourceRequirements

临时容器不允许使用资源。临时容器使用已分配给 pod 的备用资源。

securityContext

SecurityContext

可选： SecurityContext 定义临时容器应使用的安全选项。如果设置，SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。

startupProbe

probe

临时容器不允许探测。

stdin

布尔值

此容器是否应该为容器运行时中的 stdin 分配缓冲区。如果没有设置，则从容器中的 stdin 读取总是会导致 EOF。默认值为 false。

stdinOnce

布尔值

容器运行时是否应该在单个附加打开后关闭 stdin 频道。当 stdin 为 true 时，stdin 流将在多个附加会话之间保持打开。如果将 stdinOnce 设为 true，则 stdin 在容器启动时打开，会为空，直到第一个客户端附加到 stdin，然后保持打开并接受数据，直到客户端断开连接，而时间 stdin 被关闭并保持关闭，直到容器重启为止。如果此标志为 false，则从 stdin 读取的容器进程永远不会收到 EOF。默认值为 false

targetContainerName

字符串

如果设置，则此临时容器目标的 PodSpec 中的容器名称。临时容器将在此容器的命名空间中运行(IPC、PID 等)。如果没有设置，则临时容器将使用 Pod spec 中配置的命名空间。

容器运行时必须实施对此功能的支持。如果运行时不支持以命名空间为目标，则设置此字段的结果未定义。

terminationMessagePath

字符串

可选：将容器终止消息写入的文件路径被挂载到容器文件系统中。编写的消息应该是简短的最终状态，如断言失败消息。如果大于 4096 字节，则节点将被截断。所有容器的消息长度限制为 12kb。默认为 /dev/termination-log。无法更新。

terminationMessagePolicy

字符串

指明如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功和失败时填充容器状态消息。如果终止消息文件为空，并且容器退出并显示错误，则 FallbackToLogsOnError 将使用容器日志输出的最后块。日志输出限制为 2048 字节或 80 行，以较大者为准。默认为 file。无法更新。

可能的 enum 值： - "FallbackToLogsOnError" 会在容器退出时读取容器状态消息的最新内容，且 terminationMessagePath 没有内容。- "File" 是默认行为，并将容器状态消息设置为容器终止MessagePath 的内容。

tty

布尔值

此容器是否应为自己分配 TTY，还需要 'stdin' 为 true。默认值为 false。

volumeDevices

数组(VolumeDevice)

volumeDevices 是容器使用的块设备列表。

volumeMounts

数组(VolumeMount)

要挂载到容器文件系统中的 Pod 卷。临时容器不允许进行 subPath 挂载。无法更新。

workingDir

字符串

容器的工作目录。如果没有指定，则使用容器运行时的默认值，这可能会在容器镜像中配置。无法更新。

volumeClaimTemplate

PersistentVolumeClaimTemplate

将用于创建独立 PVC 来置备卷。嵌入了此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者，即 PVC 将与 pod 一起删除。PVC 的名称将是 < pod name>-<volume name>，其中 <volume name> 是 PodSpec.Volumes 数组条目中的名称。如果串联的名称对 PVC 无效，则 Pod 验证将拒绝 pod （例如，太长）。

没有为 pod 拥有该名称的现有 PVC 不会被 用于 pod，以避免错误地使用不相关的卷。然后，启动 pod 会被阻断，直到删除不相关的 PVC。如果 pod 使用预先创建的 PVC，则在 pod 存在后，PVC 必须使用所有者引用 pod 更新。通常，这不应该是必需的，但在手动重新创建损坏的集群时可能很有用。

此字段是只读的，在创建后 Kubernetes 不会对 PVC 进行任何更改。

必需，不能是 nil。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组（事件）

事件列表

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

component

字符串

生成事件的组件。

主机

字符串

生成事件的节点名称。

命令

数组（字符串）

命令是在容器内执行的命令行，命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd，它不在 shell 中运行，因此传统的 shell 指令('|' 等)不起作用。要使用 shell，您需要明确调用该 shell。0 的退出状态被视为 live/healthy，非零为不健康。

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

LUN

整数

LUN 是可选的： FC 目标 lun 号

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

targetWWNs

数组（字符串）

targetWWN 可选： FC 目标全球名称(WWN)

wwids

数组（字符串）

wwids 可选：FC 卷全局广泛的标识符(wwids) Either wwids 或 targetWWNs 和 lun 的组合必须同时设置，但不能同时设置。

driver

string

driver 是要用于此卷的驱动程序名称。

fsType

string

fstype 是要挂载的 Filesystem 类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认文件系统取决于 FlexVolume 脚本。

options

对象（字符串）

选项是可选的：此字段包含额外的命令选项（若有）。

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

secretRef

secretReference

secretRef 是可选的：SecretRef 是对包含要传递给插件脚本的敏感信息的 secret 对象的引用。如果没有指定 secret 对象，则这可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会传递给插件脚本。

driver

string

driver 是要用于此卷的驱动程序名称。

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认文件系统取决于 FlexVolume 脚本。

options

对象（字符串）

选项是可选的：此字段包含额外的命令选项（若有）。

readOnly

布尔值

readonly 是可选的：默认为 false （读/写）。此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。

secretRef

LocalObjectReference

secretRef 是可选的：secretRef 是对包含要传递给插件脚本的敏感信息的 secret 对象的引用。如果没有指定 secret 对象，则这可能为空。如果 secret 对象包含多个 secret，则所有 secret 都会传递给插件脚本。

datasetName

string

datasetName 是存储在 Flocker 的 dataset 的 dataset 的 dataset 的 Name。

datasetUUID

string

datasetUUID 是 dataset 的 UUID。这是 Flocker 数据集的唯一标识符

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

分区

整数

partition 是您要挂载的卷中的分区。如果省略，则默认为按卷名称挂载。示例：对于卷 /dev/sda1，您可以将分区指定为 "1"。同样，/dev/sda 的卷分区是 "0" （或者您可以将属性留空）。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName 是 GCE 中的 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

布尔值

此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

目录

string

directory 是目标目录名称。不得包含或以 '..' 开头。如果提供了 '.'，则卷目录将是 git 存储库。否则，如果指定，卷将包含具有指定名称的子目录中的 git 存储库。

软件仓库

string

repository 是 URL

revision

string

revision 是指定修订版本的提交哈希。

端点

string

Endpoints 是详细信息 Glusterfs 拓扑的端点名称。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

endpointsNamespace

string

endpointsNamespace 是包含 Glusterfs 端点的命名空间。如果此字段为空，则 EndpointNamespace 默认为与绑定 PVC 相同的命名空间。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path 是 Glusterfs 卷路径。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

布尔值

此处的只读将强制使用只读权限挂载 Glusterfs 卷。默认为false。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

端点

string

Endpoints 是详细信息 Glusterfs 拓扑的端点名称。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path 是 Glusterfs 卷路径。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

布尔值

此处的只读将强制使用只读权限挂载 Glusterfs 卷。默认为false。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

port

整数

gRPC 服务的端口号。数字必须在 1 到 65535 之间。

service

string

service 是要放在 gRPC HealthCheckRequest 中的服务名称（请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md）。

如果没有指定，则默认的行为由 gRPC 定义。

主机名

数组（字符串）

以上 IP 地址的主机名。

ip

字符串

主机文件条目的 IP 地址。

path

string

主机上目录的路径。如果路径是符号链接，它将遵循到实际路径的链接。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath Volume Defaults 为 "" more info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

可能枚举值：- "" 对于向后兼容，如果未设置 - "BlockDevice" A 块设备必须存在于给定路径 - "CharDevice" A 字符设备必须存在于给定路径上 - "Directory" A 目录必须存在于给定路径 - "DirectoryOrCreate" 中（如果给定路径不存在）， 将根据需要创建一个空目录，且文件模式为 0755，其具有与 Kubelet 相同的组和所有权。- "File" A 文件必须存在于给定路径上 - "FileOrCreate" 如果给定路径上不存在，将根据需要创建一个空文件，该文件与文件模式 0644 具有相同的组和所有权。- "Socket" A UNIX 套接字必须存在于给定路径上。

主机

字符串

要连接的主机名，默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。

httpHeaders

数组(HTTPHeader)

在请求中设置的自定义标头。HTTP 允许重复标头。

path

字符串

在 HTTP 服务器上访问的路径。

port

IntOrString

在容器中要访问的端口的名称或数量。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

scheme

字符串

用于连接到主机的方案。默认为 HTTP。

可能枚举的值： - "HTTP" 表示使用的方案将是 http:// - "HTTPS" 意味着所使用的方案将是 https://

name

string

标头字段名称。这将在输出时规范，因此案例名称将理解为相同的标头。

value

字符串

标头字段值

chapAuthDiscovery

布尔值

chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI Session CHAP 身份验证

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname 是自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName，则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

IQN

string

IQN 是 iSCSI 限定名称的目标。

iscsiInterface

string

iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 'default'(tcp)。

LUN

整数

LUN 是 iSCSI 目标 Lun 编号。

门户

数组（字符串）

门户是 iSCSI 目标门户列表。如果端口不是默认值（通常是 TCP 端口 860 和 3260），则门户可以是 IP 或 ip_addr:port。

readOnly

布尔值

此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。默认为false。

secretRef

secretReference

secretRef 是 iSCSI 目标和启动器验证的 CHAP Secret

targetPortal

string

targetPortal 是 iSCSI 目标门户。如果端口不是默认值（通常是 TCP 端口 860 和 3260），则门户可以是 IP 或 ip_addr:port。

chapAuthDiscovery

布尔值

chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI Session CHAP 身份验证

fsType

string

fstype 是您要挂载的卷的文件系统类型。提示： 确保主机操作系统支持文件系统类型。示例："ext4", "xfs", "ntfs"。如果未指定，则隐式推断为"ext4"。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname 是自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName，则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。

IQN

string

IQN 是目标 iSCSI 限定名称。

iscsiInterface

string

iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 'default'(tcp)。

LUN

整数

LUN 代表 iSCSI 目标 Lun 编号。

门户

数组（字符串）

门户是 iSCSI 目标门户列表。如果端口不是默认值（通常是 TCP 端口 860 和 3260），则门户可以是 IP 或 ip_addr:port。

readOnly

布尔值

此处的 readonly 将强制使用 VolumeMount 中的 ReadOnly 设置。默认为false。

secretRef

LocalObjectReference

secretRef 是 iSCSI 目标和启动器验证的 CHAP Secret

targetPortal

string

targetPortal 是 iSCSI 目标门户。如果端口不是默认值（通常是 TCP 端口 860 和 3260），则门户可以是 IP 或 ip_addr:port。

key

string

key 是项目的关键。

模式

整数

模式是可选的：用于设置此文件权限的模式位。必须是 0000 到 0777 之间的数值，也可以是 0 到 511 之间的十进制值。YAML 接受八进制值和十进制值，JSON 需要模式位的十进制值。如果没有指定，则使用卷 defaultMode。这可能会与影响文件模式的其他选项（如 fsGroup ）冲突，结果可以是设置其他模式位。

path

string

path 是要将密钥映射到的文件的相对路径。可能不是绝对路径。不得包含 path 元素 '..'。不能以字符串 '..' 开始。

postStart

LifecycleHandler

在创建容器后，postStart 会立即调用。如果处理程序失败，容器会根据重启策略终止并重启。对容器块的其他管理，直到 hook 完成为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

preStop

LifecycleHandler

由于 API 请求或管理事件（如存活度/启动探测失败、抢占、资源争用等）在容器终止前立即调用 preStop。如果容器崩溃或退出，则不会调用处理程序。Pod 的终止宽限期倒计时在执行 PreStop hook 前开始。无论处理程序的结果如何，容器最终都会在 Pod 终止宽限期内终止（除非终结器没有延迟）。对容器进行其他管理，直到 hook 完成或到达终止宽限期为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

exec

ExecAction

exec 指定要执行的操作。

httpGet

HTTPGetAction

httpGet 指定要执行的 http 请求。

tcpSocket

TCPSocketAction

已弃用。tcpSocket 不支持作为 LifecycleHandler，并保持向后兼容。当指定了 tcp 处理程序时，没有此字段验证，生命周期 hook 会在运行时失败。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(LimitRange)

items 是 LimitRange 对象列表。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

fsType

string

fstype 是要挂载的文件系统类型。只有在路径是块设备时，它才会应用。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则默认值为自动选择文件系统。

path

string

到节点上卷的完整路径的路径。它可以是目录或块设备(disk, partition, …​)。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Namespace)

items 是列表中的 Namespace 对象列表。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

path

string

NFS 服务器导出的路径。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

布尔值

此处的只读将强制使用只读权限挂载 NFS 导出。默认为false。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

server 是 NFS 服务器的主机名或 IP 地址。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

preferredDuringSchedulingIgnoredDuringExecution

数组(PreferredSchedulingTerm)

调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点，但可以选择违反了一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 关联性表达式等）的每个节点，它通过迭代此字段元素并将 "weight" 添加到摘要中（如果节点与相应的 matchExpressions 匹配）；节点具有最高总和和最高的节点。

requiredDuringSchedulingIgnoredDuringExecution

NodeSelector

如果在调度时不满足此字段指定的关联性要求，则 pod 不会调度到该节点上。如果在 Pod 执行期间由此字段指定的关联性要求满足（例如，由于更新），系统可能无法尝试最终从其节点中驱除 pod。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Node)

节点列表

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

nodeSelectorTerms

数组(NodeSelectorTerm)

必需。节点选择器术语列表。条款是 ORed。

key

字符串

选择器应用到的标签键。

operator

字符串

代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt, 和 Lt.

possible enum 值：- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组（字符串）

字符串值数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。如果 Operator 是 Gt 或 Lt，则值数组必须具有单个元素，该元素将解释为整数。这个数组会在策略性合并补丁中被替换。

matchExpressions

数组(NodeSelectorRequirement)

节点标签(label)的节点选择器要求列表。

matchFields

数组(NodeSelectorRequirement)

节点字段的节点选择器要求列表。

apiVersion

字符串

FieldPath 用术语编写的 schema 版本，默认为 "v1"。

fieldPath

字符串

在指定 API 版本中选择的字段路径。

apiVersion

字符串

引用的 API 版本。

fieldPath

字符串

如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。

kind

字符串

引用的类型。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

namespace

字符串

引用的命名空间。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

字符串

指定构成这个引用的 resourceVersion（如果存在）。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

字符串

引用的 UID。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

PersistentVolumeClaimSpec 描述了存储设备的通用属性，并允许特定于供应商的属性的源

status

对象

PersistentVolumeClaimStatus 是持久性卷声明的当前状态。

accessModes

数组（字符串）

accessModes 包含卷应具有的所需访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

对象

TypedLocalObjectReference 包含足够信息，可让您找到同一命名空间中的 typed referenced 对象。

dataSourceRef

object

dataSourceRef 指定在需要非空卷时，使用数据填充卷的对象。这可以是来自非空 API 组（非核心对象）或 PersistentVolumeClaim 对象的任何对象。当指定此字段时，只有在指定对象的类型与一些已安装的卷填充器或动态置备程序匹配时才会成功。此字段将替换 dataSource 字段的功能，因此如果这两个字段都不是空的，则它们必须具有相同的值。为向后兼容，当 namespace 没有在 dataSourceRef 中指定时，如果其中一个字段(dataSource 和 dataSourceRef)都自动设置为相同的值，另一个是非空的值。当在 dataSourceRef 中指定命名空间时，dataSource 不会设置为相同的值，且必须为空。dataSource 和 dataSourceRef: * While dataSource 有三个重要区别：但 dataSourceRef 只允许两种特定类型的对象，dataSourceRef 允许任何非核心对象和 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略禁止的值（过滤它们），dataSourceRef 会保留所有值，并在指定了禁止的值时生成错误。* 虽然 dataSource 只允许本地对象，但 dataSourceRef 允许任何命名空间中的对象。(beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。

resources

对象

ResourceRequirements 描述计算资源要求。

selector

labelSelector

selector 是卷上的标签查询，用于绑定。

storageClassName

string

storageClassName 是声明所需的 StorageClass 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

字符串

volumeMode 定义声明所需的卷类型。当没有包括在 claim spec 中时，文件系统的值会被简化。

可能枚举值： - "Block" 表示卷不会被格式化为文件系统，并将保留原始块设备。- "Filesystem" 表示该卷将使用文件系统进行或格式化。

volumeName

string

volumeName 是支持此声明的 PersistentVolume 的绑定引用。

apiGroup

字符串

apiGroup 是被引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

apiGroup

字符串

apiGroup 是被引用资源的组。如果没有指定 APIGroup，则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型，需要 APIGroup。

kind

字符串

kind 是被引用的资源类型

name

字符串

name 是被引用的资源的名称

namespace

string

namespace 是被引用的资源的命名空间。在指定命名空间时，引用命名空间中需要 gateway.networking.k8s.io/ReferenceGrant 对象，以允许该命名空间的所有者接受引用。详情请查看 ReferenceGrant 文档。(alpha)此字段需要启用 CrossNamespaceVolumeDataSource 功能门。

声明

数组

声明列出了此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段是不可变的。它只能为容器设置。

claim[]

object

ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。

limits

对象（数量）

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

对象（数量）

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中一个条目的名称匹配。它使得资源在容器内可用。

accessModes

数组（字符串）

accessModes 包含支持 PVC 的卷的实际访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

allocatedResources

对象（数量）

allocatedResources 是 AllocatedResources 中的存储资源，跟踪分配给 PVC 的容量。当请求卷扩展操作时，它可能大于实际容量。对于存储配额，使用 allocatedResources 和 PVC.spec.resources 的较大的值。如果没有设置 allocatedResources，则只用于配额计算的 PVC.spec.resources。如果卷扩展容量请求较低，则仅当没有扩展操作且实际卷容量等于或小于请求的容量时，才会降低 allocatedResources。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。

capacity

对象（数量）

capacity 代表底层卷的实际资源。

conditions

数组

conditions 是持久性卷声明的当前条件。如果底层持久性卷大小调整，则 Condition 将设置为 'ResizeStarted'。

conditions[]

object

PersistentVolumeClaimCondition 包含有关 pvc 状态的详细信息

phase

string

phase 代表 PersistentVolumeClaim 的当前阶段。

可能枚举值： - "Bound" 用于绑定的 PersistentVolumeClaims - "Lost" 用于丢失其底层 PersistentVolume 的 PersistentVolumeClaim。这个声明被绑定到一个 PersistentVolume，这个卷不再存在，且其上的所有数据都丢失。- "Pending" 用于尚未绑定的 PersistentVolumeClaims

resizeStatus

string

resizeStatus 存储调整大小操作的状态。默认情况下，不会设置 ResizeStatus，但当扩展为 complete resizeStatus 时，通过调整大小 controller 或 kubelet 被设为空字符串。这是一个 alpha 字段，需要启用 RecoverVolumeExpansionFailure 功能。

可能枚举值： - "" when expansion is complete，通过调整大小 controller 或 kubelet 设置空字符串。- 当扩展失败时，会在扩展失败时使用终端错误设置 "ControllerExpansionFailed" State set。临时错误（如 timeout ）不应设置这个状态，且应该修改 ResizeStatus，因为调整大小的控制器可以恢复卷扩展。- 在 control-plane 中扩展卷时， "ControllerExpansionInProgress" State set failed with an terminal error。临时错误不会设置 NodeExpansionFailed. - 当 kubelet 启动扩展卷时，"NodeExpansionInProgress" State set when "NodeExpansionPending" State set when resize controller has completed the volume but on the node is required on the node.

lastProbeTime

时间

lastProbeTime 是我们探测到条件的时间。

lastTransitionTime

时间

lastTransitionTime 是条件从一个状态转换到另一个状态的时间。

message

string

Message 是人类可读的消息，指示最后一次转换的详细信息。

reason

string

原因是唯一的，这应该是简短的、机器易理解的字符串，它给出了状况最后一次转换的原因。如果报告了"ResizeStarted"，这表示基础持久卷正在调整大小。

status

字符串

type

字符串

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(PersistentVolumeClaim)

items 是持久性卷声明列表。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

accessModes

数组（字符串）

accessModes 包含卷应具有的所需访问模式。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

TypedLocalObjectReference

DataSource 字段可以用来指定：* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim)，如果置备程序或外部控制器可以支持指定的数据源，它将根据指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时，DataSource 内容将复制到 dataSourceRef，当没有指定 dataSourceRef.namespace 时，dataSourceRef 内容将复制到 dataSource。如果指定了命名空间，则 dataSourceRef 将不会复制到 dataSource 中。

dataSourceRef

TypedObjectReference

dataSourceRef 指定在需要非空卷时，使用数据填充卷的对象。这可以是来自非空 API 组（非核心对象）或 PersistentVolumeClaim 对象的任何对象。当指定此字段时，只有在指定对象的类型与一些已安装的卷填充器或动态置备程序匹配时才会成功。此字段将替换 dataSource 字段的功能，因此如果这两个字段都不是空的，则它们必须具有相同的值。为向后兼容，当 namespace 没有在 dataSourceRef 中指定时，如果其中一个字段(dataSource 和 dataSourceRef)都自动设置为相同的值，另一个是非空的值。当在 dataSourceRef 中指定命名空间时，dataSource 不会设置为相同的值，且必须为空。dataSource 和 dataSourceRef: * While dataSource 有三个重要区别：但 dataSourceRef 只允许两种特定类型的对象，dataSourceRef 允许任何非核心对象和 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略禁止的值（过滤它们），dataSourceRef 会保留所有值，并在指定了禁止的值时生成错误。* 虽然 dataSource 只允许本地对象，但 dataSourceRef 允许任何命名空间中的对象。(beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。

resources

ResourceRequirements

resources 代表卷应具有的最少资源。如果启用了 RecoverVolumeExpansionFailure 功能，则允许用户指定低于之前值的资源要求，但必须大于声明的 status 字段中记录的容量。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

selector

labelSelector

selector 是卷上的标签查询，用于绑定。

storageClassName

string

storageClassName 是声明所需的 StorageClass 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

字符串

volumeMode 定义声明所需的卷类型。当没有包括在 claim spec 中时，文件系统的值会被简化。

可能枚举值： - "Block" 表示卷不会被格式化为文件系统，并将保留原始块设备。- "Filesystem" 表示该卷将使用文件系统进行或格式化。

volumeName

string

volumeName 是支持此声明的 PersistentVolume 的绑定引用。

metadata

ObjectMeta

可以包含在创建时复制到 PVC 中的标签和注解。不允许其他字段，并在验证过程中被拒绝。

spec

PersistentVolumeClaimSpec

PersistentVolumeClaim 的规格。整个内容都会不动地复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中的相同字段也有效。

claimName

string

claimName 是使用此卷与 pod 相同的命名空间中的 PersistentVolumeClaim 的名称。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

布尔值

readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认 false。

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(PersistentVolume)

items 是持久性卷列表。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

accessModes

数组（字符串）

accessModes 包含可挂载卷的所有方法。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes

awsElasticBlockStore

AWSElasticBlockStoreVolumeSource

awsElasticBlockStore 代表附加到 kubelet 主机机器的 AWS Disk 资源，然后公开给 pod。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

AzureDiskVolumeSource

azureDisk 代表主机上的 Azure Data Disk 挂载，并绑定到 pod。

azureFile

AzureFilePersistentVolumeSource

azureFile 代表主机上的 Azure File Service 挂载，并绑定到 pod。

capacity

对象（数量）

capacity 是持久性卷资源和容量的描述。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity

cephfs

CephFSPersistentVolumeSource

CephFS 代表共享 pod 生命周期的主机上的 Ceph FS 挂载

cinder

CinderPersistentVolumeSource

Cinder 代表附加并挂载到 kubelet 主机上的 cinder 卷。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

claimRef

ObjectReference

claimRef 是 PersistentVolume 和 PersistentVolumeClaim 之间的双向绑定的一部分。当绑定时，预期为非il。claim.VolumeName 是 PV 和 PVC 之间的权威绑定。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding

csi

CSIPersistentVolumeSource

CSI 代表由外部 CSI 驱动程序(Beta 功能)处理的存储。

fc

FCVolumeSource

FC 代表附加到 kubelet 主机的 Fibre Channel 资源，然后公开给 pod。

flexVolume

FlexPersistentVolumeSource

FlexVolume 代表一个通用卷资源，它使用基于 exec 的插件置备/附加。

flocker

FlockerVolumeSource

flocker 代表附加到 kubelet 主机机器的 Flocker 卷，并公开给 pod 以供其使用。这取决于运行 Flocker 控制服务

gcePersistentDisk

GCEPersistentDiskVolumeSource

gcePersistentDisk 代表附加到 kubelet 主机机器的 GCE Disk 资源，然后公开给 pod。由管理员调配。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

glusterfs

GlusterfsPersistentVolumeSource

GlusterFS 代表附加到主机并公开给 pod 的 Glusterfs 卷。由管理员调配。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

HostPathVolumeSource

hostpath 代表主机上的目录。由开发人员或测试程序调配。这仅适用于单节点开发和测试！在多节点集群中，不支持主机存储，在多节点集群中不支持 WILL NOT WORK。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

iscsi

ISCSIPersistentVolumeSource

iSCSI 代表附加到 kubelet 主机机器的 ISCSI 磁盘资源，然后公开给 pod。由管理员调配。

local

LocalVolumeSource

local 代表与节点关联性直接附加的存储

mountOptions

数组（字符串）

mountOptions 是挂载选项列表，如 ["ro", "soft"]。未验证 - 如果挂载无效，则挂载将失败。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options

nfs

NFSVolumeSource

NFS 代表主机上的 NFS 挂载。由管理员调配。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#nfs

nodeAffinity

VolumeNodeAffinity

nodeAffinity 定义限制此卷可从中访问哪些节点。此字段会影响使用这个卷的 pod 的调度。

persistentVolumeReclaimPolicy

string

persistentVolumeReclaimPolicy 定义从声明中释放持久性卷时会发生什么。有效选项为 Retain （为手动创建的 PersistentVolume 的默认设置）、Delete （动态置备的 PersistentVolume 的默认）和 Recycle （已弃用）。Recycle 必须被此 PersistentVolume 底层的卷插件支持。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming

可能枚举值： - "Delete" 表示该卷将从其声明中的 Kubernetes 中删除。卷插件必须支持 Deletion。- "Recycle" 意味着卷将被重新回收到其声明中未绑定持久性卷的池。卷插件必须支持 Recycling。- "Retain" 表示该卷将保留在其当前阶段(Released)中，供管理员手动回收。默认策略为 Retain。

photonPersistentDisk

PhotonPersistentDiskVolumeSource

photonPersistentDisk 代表在 kubelets 主机上附加并挂载的 PhotonController 持久磁盘

portworxVolume

PortworxVolumeSource

portworxVolume 代表附加并挂载到 kubelet 主机上的 portworx 卷

quobyte

QuobyteVolumeSource

quobyte 代表共享 pod 生命周期的主机上的 Quobyte 挂载

rbd

RBDPersistentVolumeSource

RBD 代表共享 pod 生命周期的主机上的 Rados 块设备挂载。更多信息： https://examples.k8s.io/volumes/rbd/README.md

scaleIO

ScaleIOPersistentVolumeSource

scaleIO 代表一个在 Kubernetes 节点上附加并挂载的 ScaleIO 持久性卷。

storageClassName

string

storageClassName 是这个持久性卷所属的 StorageClass 的名称。空值意味着这个卷不属于任何 StorageClass。

storageos

StorageOSPersistentVolumeSource

storageos 代表附加到 kubelet 主机机器的 StorageOS 卷，并挂载到 pod 更多信息： https://examples.k8s.io/volumes/storageos/README.md

volumeMode

字符串

volumeMode 定义卷是否要与格式化的文件系统一起使用，或者保持在原始块状态。当没有包括在 spec 中时，文件系统的值会被简化。

可能枚举值： - "Block" 表示卷不会被格式化为文件系统，并将保留原始块设备。- "Filesystem" 表示该卷将使用文件系统进行或格式化。

vsphereVolume

VsphereVirtualDiskVolumeSource

vsphereVolume 代表在 kubelets 主机上附加并挂载的 vSphere 卷

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定，则隐式推断为"ext4"。

pdID

string

pdID 是标识 Photon Controller 持久磁盘的 ID

preferredDuringSchedulingIgnoredDuringExecution

数组(WeightedPodAffinityTerm)

调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点，但可以选择违反了一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 关联性表达式等）的每个节点，它通过迭代此字段元素并将 "weight" 添加到摘要中，如果节点具有与相应 podAffinityTerm 匹配的 pod；具有最高总和最高的节点是首选的节点。

requiredDuringSchedulingIgnoredDuringExecution

数组(PodAffinityTerm)

如果在调度时不满足此字段指定的关联性要求，则 pod 不会调度到该节点上。如果在 pod 执行期间由此字段指定的关联性要求满足（例如，因为 pod 标签更新），则系统可能无法最终尝试从其节点中驱除 pod。当有多个元素时，每个 podAffinityTerm 对应的节点列表会被干扰，例如，所有术语都必须满足。

labelSelector

labelSelector

一个对一组资源的标签查询，本例中为 pod。

namespaceSelector

labelSelector

对术语应用到的命名空间集合的标签查询。术语应用于此字段选择的命名空间的联合，以及 namespaces 字段中列出的命名空间。null selector 和 null 或 empty namespace 列表表示"此 pod 的命名空间"。空选择器({})与所有命名空间匹配。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用于此字段中列出的命名空间，由 namespaceSelector. null 或空命名空间列表和 null namespaceSelector 选择的命名空间合并意味着"此 pod 的命名空间"。

topologyKey

字符串

此 pod 应该与指定命名空间中 labelSelector 匹配的 pod 在一起（关联性）或不并置（反关联性），其中 co-located 定义为在具有键 topologyKey 标签的节点中运行。不允许空的 topologyKey。

preferredDuringSchedulingIgnoredDuringExecution

数组(WeightedPodAffinityTerm)

调度程序希望将 pod 调度到满足此字段指定的反关联性表达式的节点，但可以选择违反了一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 反关联性表达式等）的每个节点，它通过迭代此字段元素来计算和将"权重"添加到节点具有与相应 podAffinityTerm 匹配的 pod；如果节点具有与相应 podAffinityTerm 匹配的 pod，则该节点是首选的。

requiredDuringSchedulingIgnoredDuringExecution

数组(PodAffinityTerm)

如果在调度时不满足由此字段指定的反关联性要求，则 pod 不会调度到节点上。如果在 pod 执行期间由此字段指定的反关联性要求满足（例如，因为 pod 标签更新），则系统可能无法最终尝试从其节点中驱除 pod。当有多个元素时，每个 podAffinityTerm 对应的节点列表会被干扰，例如，所有术语都必须满足。

nameservers

数组（字符串）

DNS 名称服务器 IP 地址列表。这将附加到从 DNSPolicy 生成的基本名称服务器。将删除重复的名称服务器。

options

数组(PodDNSConfigOption)

DNS 解析器选项列表。这将与 DNSPolicy 生成的基本选项合并。将删除重复的条目。Options 中给出的解析选项将覆盖基本 DNSPolicy 中显示的解析选项。

搜索

数组（字符串）

host-name 查找的 DNS 搜索域列表。这将附加到 DNSPolicy 生成的基本搜索路径中。将删除重复的搜索路径。

name

字符串

必需。

value

string

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

items

数组(Pod)

pod 列表。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md

kind

字符串

kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ListMeta

标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

name 是操作系统的名称。目前支持的值有 linux 和 windows。额外值可能会在以后定义，可以是： https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration 客户端应该应该处理附加值，并将此字段中的未识别的值视为 os: null

conditionType

字符串

conditionType 指的是 pod 条件列表中具有匹配类型的条件。

name

string

在 pod 中唯一标识此资源声明的名称。这必须是 DNS_LABEL。

source

ClaimSource

source 描述在什么位置查找 ResourceClaim。

name

string

调度授权的名称。每个调度最低要求都必须具有唯一的 name 字段。

fsGroup

整数

适用于 pod 中所有容器的特殊补充组。有些卷类型允许 Kubelet 将该卷的所有权更改为 pod 拥有：

1.所属 GID 将是 FSGroup 2。set setgid 位（在卷中创建的新文件将归 FSGroup 所有）3。权限位为 OR'd with rw-rw----

如果未设置，Kubelet 将不修改任何卷的所有权和权限。请注意，当 spec.os.name 是窗口时，无法设置此字段。

fsGroupChangePolicy

字符串

fsGroupChangePolicy 定义在 Pod 中公开卷之前更改卷的所有权和权限的行为。此字段仅适用于支持 fsGroup 基于所有权（和权限）的卷类型。它对临时卷类型没有影响，如： secret、configmaps 和 emptydir。有效值为 "OnRootMismatch" 和 "Always"。如果没有指定，则使用 "Always"。请注意，当 spec.os.name 是窗口时，无法设置此字段。

可能枚举值： - "Always" 表示当卷挂载到 Pod 中时，应始终更改卷的所有权和权限。这个默认行为。- "OnRootMismatch" 表示只有在根目录的权限与卷上预期权限不匹配时才会更改卷的所有权和权限。这有助于缩短更改卷的所有权和权限所需的时间。

runAsGroup

整数

运行容器进程的入口点的 GID。如果未设置，则使用运行时默认值。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则在 SecurityContext 中指定的值优先于该容器。请注意，当 spec.os.name 是窗口时，无法设置此字段。

runAsNonRoot

布尔值

表示容器必须以非 root 用户身份运行。如果为 true，Kubelet 将在运行时验证镜像，以确保它不会以 UID 0 (root)运行，如果容器确实无法启动它，则无法启动它。如果未设置或 false，则不会执行这样的验证。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则优先使用 SecurityContext 指定的值。

runAsUser

整数

运行容器进程的入口点的 UID。如果未指定，则默认为镜像元数据中指定的用户。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则在 SecurityContext 中指定的值优先于该容器。请注意，当 spec.os.name 是窗口时，无法设置此字段。

seLinuxOptions

seLinuxOptions

要应用到所有容器的 SELinux 上下文。如果未指定，容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则在 SecurityContext 中指定的值优先于该容器。请注意，当 spec.os.name 是窗口时，无法设置此字段。

seccompProfile

SeccompProfile

此 pod 中容器使用的 seccomp 选项。请注意，当 spec.os.name 是窗口时，无法设置此字段。

supplementalGroups

数组（整数）

除了容器的主 GID、fsGroup （如果指定）以及容器镜像中定义的组成员资格（如果指定）之外，应用于每个容器中的第一个进程运行的组列表。如果未指定，则不会将额外的组添加到任何容器中。请注意，容器进程的 uid 中定义的组成员资格仍然有效，即使它们没有包括在此列表中。请注意，当 spec.os.name 是窗口时，无法设置此字段。

sysctls

数组(Sysctl)

sysctl 包含用于 pod 的命名空间 sysctl 的列表。带有不支持的 sysctl （由容器运行时）的 Pod 可能无法启动。请注意，当 spec.os.name 是窗口时，无法设置此字段。

windowsOptions

WindowsSecurityContextOptions

应用到所有容器的 Windows 特定设置。如果未指定，则使用容器的 SecurityContext 选项。如果在 SecurityContext 和 PodSecurityContext 中设置，则优先使用 SecurityContext 指定的值。请注意，当 spec.os.name 是 linux 时，无法设置此字段。

activeDeadlineSeconds

整数

在系统主动尝试标记失败并终止相关的容器前，pod 可以在相对于 StartTime 的节点上处于活跃状态。值必须是正整数。

关联性

关联性

如果指定，pod 的调度限制

automountServiceAccountToken

布尔值

AutomountServiceAccountToken 指明是否应该自动挂载服务帐户令牌。

containers

数组(Container)

属于 pod 的容器列表。容器目前无法添加或删除。Pod 中必须至少有一个容器。无法更新。

dnsConfig

PodDNSConfig

指定 pod 的 DNS 参数。此处指定的参数将根据 DNSPolicy 合并到生成的 DNS 配置中。

dnsPolicy

字符串

为 pod 设置 DNS 策略。默认为 "ClusterFirst"。有效值为 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' 或 'None'。DNSConfig 中给定的 DNS 参数将与选择与 DNSPolicy 的策略合并。要将 DNS 选项与 hostNetwork 一起设置，您必须将 DNS 策略明确指定为 'ClusterFirstWithHostNet'。

可能枚举值： - "ClusterFirst" 表示 pod 应该先使用集群 DNS，除非 hostNetwork 为 true，如果可用，则回退到默认的（由 kubelet 决定）DNS 设置。- "ClusterFirstWithHostNet" 表示 pod 应该首先使用集群 DNS，如果可用，则回退到它。 在默认的（由 kubelet 决定）DNS 设置中。- "Default" 表示 pod 应该使用默认（由 kubelet 决定）DNS 设置。- "None" 表示 pod 应该使用空的 DNS 设置。名称服务器和搜索路径等 DNS 参数应该通过 DNSConfig 定义。

enableServiceLinks

布尔值

EnableServiceLinks 指示是否应将有关服务的信息注入到 pod 的环境变量中，与 Docker 链接的语法匹配。可选：默认为 true。

ephemeralContainers

数组(EphemeralContainer)

此 pod 中运行的临时容器列表。临时容器可以在现有 pod 中运行，以执行用户发起的操作，如调试。创建 pod 时无法指定此列表，无法通过更新 pod 规格来修改它。要将临时容器添加到现有 pod 中，请使用 pod 的 ephemeralcontainers 子资源。

hostAliases

数组(HostAlias)

hostAliases 是主机和 IP 的可选列表，如果指定，将注入到 pod 的主机文件中。这只适用于非主机网络 pod。

hostIPC

布尔值

使用主机的 ipc 命名空间。可选：默认为 false。

hostNetwork

布尔值

为此 pod 请求的主机网络。使用主机的网络命名空间。如果设置了这个选项，则必须指定要使用的端口。默认为 false。

hostPID

布尔值

使用主机的 pid 命名空间。可选：默认为 false。

hostUsers

布尔值

使用主机的用户命名空间。可选：默认为 true。如果设置为 true 或不存在，则 pod 将在主机用户命名空间中运行，当 pod 需要可供主机用户命名空间使用的功能时，如加载带有 CAP_SYS_MODULE 的内核模块。当设置为 false 时，会为 pod 创建一个新的 userns。设置 false 有助于缓解容器中断漏洞，即使允许用户以 root 身份运行其容器，而无需实际在主机上具有 root 特权。此字段是 alpha-level，仅被启用 UserNamespacesSupport 功能的服务器所接受。

hostname

字符串

如果没有指定 Pod 的主机名，则 pod 的主机名将设置为系统定义的值。

imagePullSecrets

数组(LocalObjectReference)

imagePullSecrets 是同一命名空间中 secret 的引用列表，用于拉取此 PodSpec 使用的任何镜像。如果指定，这些 secret 将传递给单独的 puller 实现，供它们使用。更多信息： https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod

initContainers

数组(Container)

属于 pod 的初始化容器列表。init 容器在容器启动前先执行。如果任何 init 容器失败，pod 被视为失败，并根据其 restartPolicy 处理。init 容器或普通容器的名称必须在所有容器间唯一。Init 容器可能没有生命周期操作、就绪度探测、存活度探测或启动探测。init 容器的 resourceRequirements 在调度过程中考虑，方法是为每个资源类型找到最高 request/limit，然后使用该值或普通容器的总和。限制以类似的方式应用到 init 容器。目前无法添加或删除 init 容器。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/init-containers/

nodeName

字符串

nodeName 是一个将此 pod 调度到特定节点的请求。如果是非空，调度程序只会将此 pod 调度到该节点上，假设它符合资源要求。

nodeSelector

对象（字符串）

nodeSelector 是一个选择器，必须为 true 才能使 pod 适合节点。必须与 pod 标签匹配的选择器，才能调度到该节点上。更多信息： https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

OS

PodOS

指定 pod 中容器的 OS。如果设置了，则一些 pod 和容器字段会被限制。

如果 OS 字段设为 linux，则必须取消设置以下字段： -securityContext.windowsOptions

如果 OS 字段设置为 windows，则必须取消设置以下字段： - spec.hostPID - spec.hostIPC - spec.hostUsers - spec.hostUsers - spec.securityContext.seccompProfile - spec.securityContext.fsGroup - spec.securityContext.fsGroupChangePolicy - spec.securityContext.sysctls - spec.shareProcessNamespace - spec.securityContext.runAsUser - spec.securityContext.runAsGroup - spec.securityContext.supplementalGroups - spec.containers[].securityContext.seLinuxOptions - spec.containers[].securityContext.seccompProfile - spec.securityContext.capabilities - spec.containers[].securityContext.readOnlyRootFilesystem - spec.containers[].securityContext.privileged - spec.containers[].securityContext.allowPrivilegeEscalation - spec.containers[].securityContext.procMount - spec.containers[].securityContext.runAsUser - spec.containers[*].securityContext.runAsGroup

开销

对象（数量）

开销代表了与为给定 RuntimeClass 运行 pod 相关的资源开销。此字段将由 RuntimeClass 准入控制器在准入时自动填充。如果启用了 RuntimeClass 准入控制器，则无法在 Pod 创建请求中设置开销。RuntimeClass 准入控制器将拒绝 Pod 创建已设置开销的请求。如果在 PodSpec 中配置并选择了 RuntimeClass，则 Overhead 将被设置为对应的 RuntimeClass 中定义的值，否则它将保留为未设置并被视为零。更多信息： https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md

preemptionPolicy

字符串

preemptionPolicy 是抢占优先级较低的 pod 的策略。Never, PreemptLowerPriority 之一。如果未设置，则默认为 PreemptLowerPriority。

可能枚举值： - "Never" 表示 pod 不会抢占优先级较低的其他 pod。- "PreemptLowerPriority" 表示 pod 可以抢占优先级较低的其他 pod。

priority

整数

优先级值。各种系统组件使用此字段查找 pod 的优先级。启用 Priority Admission Controller 时，它会阻止用户设置此字段。准入控制器从 PriorityClassName 填充此字段。数值越大，优先级越高。

priorityClassName

字符串

如果指定，则表示 pod 的优先级。"system-node-critical"和"system-cluster-critical"是两个特殊关键字，表示前者最高的优先级。必须使用该名称创建 PriorityClass 对象来定义任何其他名称。如果没有指定，如果没有默认值，pod 优先级将为 default 或零。

readinessGates

数组(PodReadinessGate)

如果指定，则会针对 pod 就绪度评估所有就绪度。当它的所有容器都就绪且在就绪度授权中指定的所有条件都等于"True"更多信息时，pod 已就绪： https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates

resourceClaims

数组(PodResourceClaim)