第 12 章 Subscription [operators.coreos.com/v1alpha1]

channel

字符串

config

对象

subscriptionConfig 包含为订阅指定的配置。

installPlanApproval

字符串

Approval 是 InstallPlan 的用户批准策略。它必须是 "Automatic" 或 "Manual"。

name

字符串

source

字符串

sourceNamespace

字符串

startingCSV

字符串

关联性

object

如果指定，覆盖 pod 的调度限制。nil sub-attributes 不会覆盖 这些子属性的 pod.spec 中的原始值。使用空对象({})擦除原始子属性值。

annotations

对象（字符串）

annotations 是一个无结构的键值映射，存储于 Operator 中的每个 Deployment、Pod 和 APIService。通常，注解可以被外部工具设置，以存储和检索任意元数据。使用此字段预定义 OLM 应该添加到每个订阅的部署、Pod 和 apiservices 中的注解。

env

array

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

env[]

对象

EnvVar 代表容器中存在的环境变量。

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

nodeSelector

对象（字符串）

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

资源

对象

resources 代表此容器所需的计算资源。不可变。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

selector

对象

selector 是要配置的 pod 的标签选择器。其 pod 被选择的现有 ReplicaSet 将会受到此部署的影响。它必须与 pod 模板的标签匹配。

容限（tolerations）

array

容限(toleration)是 pod 的容限。

tolerations[]

对象

此 Toleration 附加到 pod，以使用匹配的 operator <operator> 容许与 triple <key,value,effect> 匹配的任何污点。

volumeMounts

array

要在容器中设置的 VolumeMount 列表。

volumeMounts[]

对象

VolumeMount 描述了容器内卷挂载。

卷

array

podSpec 中设置的卷列表。

volumes[]

对象

卷代表 pod 中的指定卷，可以被 pod 中的任何容器访问。

nodeAffinity

对象

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

podAffinity

对象

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

podAntiAffinity

对象

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

preferredDuringSchedulingIgnoredDuringExecution

array

调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、必需关联表达式等）的每个节点，计算出一个总和总和总和总和（如果节点与相应的 matchExpressions 匹配），则计算总和最高的节点是最首选的。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

空白的首选调度术语与带有隐式权重 0 （例如，它的一个 no-op）的所有对象匹配。空首选调度术语不匹配任何对象（例如，也是 no-op）。

requiredDuringSchedulingIgnoredDuringExecution

对象

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

preference

对象

与对应权重关联的节点选择器术语。

weight

整数

与对应 nodeSelectorTerm 关联的权重，范围为 1-100。

matchExpressions

array

按节点标签划分的节点选择器要求列表。

matchExpressions[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchFields

array

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

matchFields[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

nodeSelectorTerms

array

必需。节点选择器术语列表。术语为 ORed。

nodeSelectorTerms[]

对象

null 或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。

matchExpressions

array

按节点标签划分的节点选择器要求列表。

matchExpressions[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchFields

array

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

matchFields[]

对象

节点选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点（即，对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点，计算并迭代此字段元素，并在节点具有与对应 podAffinityTerm 匹配的 pod 时，将"weight"添加到总和（如果节点具有最高 podAffinityTerm）、具有最高总和最高的节点是首选。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。

podAffinityTerm

对象

必需。与对应权重关联的 pod 关联性术语。

weight

整数

与对应的 podAffinityTerm 关联的权重，范围为 1-100。

labelSelector

对象

对一组资源进行标签查询，本例中为 pod。如果为空，则此 PodAffinityTerm 与任何 Pod 匹配。

matchLabelKeys

数组（字符串）

matchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。matchLabelKeys 和 labelSelector 中都禁止相同的密钥。另外，当 labelSelector 未设置时，无法设置 matchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

mismatchLabelKeys

数组（字符串）

MismatchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector as key notin (value) 合并，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。禁止相同的键存在于 mismatchLabelKeys 和 labelSelector 中。另外，当 labelSelector 未设置时，无法设置 mismatchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

namespaceSelector

对象

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

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。

topologyKey

字符串

此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

labelSelector

对象

对一组资源进行标签查询，本例中为 pod。如果为空，则此 PodAffinityTerm 与任何 Pod 匹配。

matchLabelKeys

数组（字符串）

matchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。matchLabelKeys 和 labelSelector 中都禁止相同的密钥。另外，当 labelSelector 未设置时，无法设置 matchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

mismatchLabelKeys

数组（字符串）

MismatchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector as key notin (value) 合并，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。禁止相同的键存在于 mismatchLabelKeys 和 labelSelector 中。另外，当 labelSelector 未设置时，无法设置 mismatchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

namespaceSelector

对象

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

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。

topologyKey

字符串

此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

preferredDuringSchedulingIgnoredDuringExecution

array

调度程序更喜欢将 pod 调度到满足此字段指定的反关联性表达式的节点，但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 反关联性表达式等）的每个节点，计算通过此字段元素来计算总和总和（如果节点具有与对应的 podAffinityTerm 匹配的 pod）的总和。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点，以查找最首选节点。

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 pod （即，与给定命名空间相对 labelSelector 匹配的 labelSelector ），该 pod 应该与 pod 共同定位（反关联性）或没有共同定位（反关联性）的节点上运行，其中 co-located 在具有键 <topologyKey> 标签的节点上运行，它与其上运行一组 pod 的 pod 匹配。

podAffinityTerm

对象

必需。与对应权重关联的 pod 关联性术语。

weight

整数

与对应的 podAffinityTerm 关联的权重，范围为 1-100。

labelSelector

对象

对一组资源进行标签查询，本例中为 pod。如果为空，则此 PodAffinityTerm 与任何 Pod 匹配。

matchLabelKeys

数组（字符串）

matchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。matchLabelKeys 和 labelSelector 中都禁止相同的密钥。另外，当 labelSelector 未设置时，无法设置 matchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

mismatchLabelKeys

数组（字符串）

MismatchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector as key notin (value) 合并，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。禁止相同的键存在于 mismatchLabelKeys 和 labelSelector 中。另外，当 labelSelector 未设置时，无法设置 mismatchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

namespaceSelector

对象

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

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。

topologyKey

字符串

此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

labelSelector

对象

对一组资源进行标签查询，本例中为 pod。如果为空，则此 PodAffinityTerm 与任何 Pod 匹配。

matchLabelKeys

数组（字符串）

matchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。matchLabelKeys 和 labelSelector 中都禁止相同的密钥。另外，当 labelSelector 未设置时，无法设置 matchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

mismatchLabelKeys

数组（字符串）

MismatchLabelKeys 是一组 pod 标签键，用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值，这些键值标签与 labelSelector as key notin (value) 合并，以选择要考虑传入 pod 的 pod (anti)关联性的现有 pod 组。传入的 pod 标签中不存在的键将被忽略。默认值为空。禁止相同的键存在于 mismatchLabelKeys 和 labelSelector 中。另外，当 labelSelector 未设置时，无法设置 mismatchLabelKeys。这是一个 beta 字段，需要启用 MatchLabelKeysInPodAffinity 功能门（默认启用）。

namespaceSelector

对象

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

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union，namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。

topologyKey

字符串

此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存（反关联性），其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

name

字符串

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

value

字符串

变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。默认为 ""。

valueFrom

对象

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

configMapKeyRef

对象

选择 ConfigMap 的键。

fieldRef

对象

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

resourceFieldRef

对象

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

secretKeyRef

对象

在 pod 命名空间中选择 secret 的键

key

字符串

要选择的密钥。

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

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

apiVersion

字符串

模式的版本是按术语编写的 FieldPath，默认为 "v1"。

fieldPath

字符串

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

containerName

字符串

容器名称：卷需要，对于 env vars是可选的

divisor

integer-or-string

指定公开资源的输出格式，默认为 "1"

resource

字符串

必需：要选择的资源

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否需要定义 Secret 还是其密钥

configMapRef

对象

要从中选择的 ConfigMap

prefix

字符串

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

secretRef

对象

要从中选择的 Secret

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 Secret

claims

数组

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

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

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

claims[]

object

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

limits

integer-or-string

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

requests

integer-or-string

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

name

string

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

Request （请求）

string

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

effect

字符串

effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后，允许的值为 NoSchedule，PreferNoSchedule 和 NoExecute。

key

字符串

key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空，则必须存在运算符；组合意味着匹配所有值和所有键。

operator

字符串

Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符，以便 pod 可以容忍特定类别的所有污点。

tolerationSeconds

整数

tolerationSeconds 代表容限的期间（必须生效 NoExecute，否则此字段将被忽略）可以容忍污点。默认情况下，它不会被设置，这意味着容许任何污点（不要驱除）。零值和负值将被视为 0 （立即删除）。

value

字符串

value 是容限匹配的污点值。如果运算符是 Exists，则该值应该为空，否则仅是一个常规字符串。

mountPath

字符串

应挂载卷的容器中的路径。不得包含 ':'。

mountPropagation

字符串

mountPropagation 决定挂载如何从主机传播到容器以及反向传播。如果没有设置，则使用 MountPropagationNone。此字段在 1.10 中是 beta。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时，mountPropagation 必须是 None 或未指定（默认为 None）。

name

字符串

这必须与卷的 Name 匹配。

readOnly

布尔值

如果为 true，则以只读方式挂载，否则读写(false 或未指定)。默认为false。

recursiveReadOnly

string

RecursiveReadOnly 指定是否应递归处理只读挂载。

如果 ReadOnly 为 false，则此字段没有意义，必须未指定。

如果 ReadOnly 为 true，且此字段设置为 Disabled，则不会递归只读挂载。如果将此字段设置为 IfPossible，则挂载将递归只读（如果容器运行时支持）。如果此字段设置为 Enabled，则挂载将在容器运行时支持时递归只读，否则不会启动 pod，并生成错误来指示原因。

如果将此字段设置为 IfPossible 或 Enabled，则 MountPropagation 必须设为 None （或未指定，默认为 None）。

如果没有指定此字段，它将被视为与 Disabled 的等效值。

subPath

字符串

应从中挂载容器卷的卷中的路径。默认为 "" （卷的 root）。

subPathExpr

字符串

在应该挂载容器卷的卷中扩展路径。行为与 SubPath 类似，但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" （卷的 root）。SubPathExpr 和 SubPath 是互斥的。

awsElasticBlockStore

object

awsElasticBlockStore 代表一个 AWS Disk 资源，附加到 kubelet 的主机机器，然后公开给 pod。弃用：AWSElasticBlockStore 已被弃用。in-tree awsElasticBlockStore 类型的所有操作都会重定向到 ebs.csi.aws.com CSI 驱动程序。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

azureDisk

object

azureDisk 代表主机上的 Azure Data Disk 挂载，并绑定到 pod。已弃用：AzureDisk 已被弃用。in-tree azureDisk 类型的所有操作都会重定向到 disk.csi.azure.com CSI 驱动程序。

azureFile

object

azureFile 代表主机上的 Azure File Service 挂载，并绑定到 pod。已弃用：AzureFile 已被弃用。in-tree azureFile 类型的所有操作都会重定向到 file.csi.azure.com CSI 驱动程序。

cephfs

object

CephFS 代表共享 pod 生命周期的主机上的 Ceph FS 挂载。弃用：CephFS 已被弃用，in-tree cephfs 类型不再被支持。

cinder

object

Cinder 代表附加并挂载到 kubelet 主机机器上的 cinder 卷。已弃用：Cinder 已被弃用。in-tree cinder 类型的所有操作都会重定向到 cinder.csi.openstack.org CSI 驱动程序。更多信息： https://examples.k8s.io/mysql-cinder-pd/README.md

configMap

object

ConfigMap 代表应填充此卷的 configMap

csi

object

CSI (Container Storage Interface)代表由某些外部 CSI 驱动程序处理的临时存储。

downwardAPI

object

downwardAPI 代表应填充此卷的 pod 的 Downward API

emptyDir

object

emptyDir 代表共享 pod 生命周期的临时目录。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#emptydir

ephemeral

object

ephemeral 代表由集群存储驱动程序处理的卷。卷的生命周期与定义它的 pod 关联 - 将在 pod 启动前创建，并在 pod 被删除时删除。

如果 pod 运行（如需要从快照或容量跟踪中恢复）正常卷时，才需要这个卷。c）通过存储类指定存储驱动程序，以及 d）存储驱动程序支持通过 PersistentVolumeClaim 进行动态卷置备（请参阅 EphemeralVolumeSource 以了解有关这个卷类型和 PersistentVolumeClaim 间的连接的更多信息。

对于保留的时间超过单个 pod 的生命周期，使用 PersistentVolumeClaim 或特定于供应商的 API 之一。

如果使用 CSI 驱动程序，使用 CSI 驱动程序来轻量级本地临时卷 - 如需更多信息，请参阅驱动程序文档。

pod 可以同时使用两种类型的临时卷和持久性卷。

fc

object

FC 代表附加到 kubelet 主机机器的光纤通道资源，然后公开给 pod。

flexVolume

object

FlexVolume 代表使用基于 exec 的插件置备的/附加的通用卷资源。已弃用：FlexVolume 已被弃用。考虑使用 CSIDriver 替代。

flocker

object

flocker 代表附加到 kubelet 主机机器的 Flocker 卷。这取决于正在运行的 Flocker 控制服务。deprecated: Flocker 已弃用，in-tree flocker 类型不再被支持。

gcePersistentDisk

object

gcePersistentDisk 代表一个 GCE Disk 资源，该资源附加到 kubelet 的主机机器，然后公开给 pod。已弃用： GCEPersistentDisk 已被弃用。树内 gcePersistentDisk 类型的所有操作都会重定向到 pd.csi.storage.gke.io CSI 驱动程序。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

gitRepo

object

gitRepo 代表特定修订版本中的 git 存储库。deprecated: GitRepo 已被弃用。要使用 git 存储库置备容器，请将 EmptyDir 挂载到使用 git 克隆存储库的 InitContainer 中，然后将 EmptyDir 挂载到 Pod 的容器中。

glusterfs

object

GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。已弃用： Glusterfs 已被弃用，in-tree glusterfs 类型不再被支持。更多信息： https://examples.k8s.io/volumes/glusterfs/README.md

hostPath

object

hostpath 代表主机机器上直接公开给容器的已存在的文件或目录。这通常用于系统代理或其他允许查看主机机器的特权事情。大多数容器都不需要这样做。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

image

object

Image 代表一个 OCI 对象（容器镜像或工件）拉取并挂载到 kubelet 的主机机器上。根据提供 PullPolicy 值，卷会在 pod 启动时解析：

- always ：kubelet 始终会尝试拉取引用。如果拉取失败，则容器会失败。- Never: kubelet 永不拉取引用，只使用本地镜像或工件。如果引用不存在，则容器创建会失败。- 如果不是Present：kubelet 会拉取（如果磁盘上不存在引用）。如果引用不存在，则容器创建会失败，拉取会失败。

如果 pod 被删除并重新创建，则卷会被重新解析，这意味着新的远程内容将在 pod 重新创建时可用。在 pod 启动期间无法解析或拉取镜像将阻止容器启动，并可能会增加大量延迟。故障将使用正常的卷 backoff 重试，并将报告在 pod 原因和消息上。此卷可以挂载的对象类型由主机机器上的容器运行时实施定义，至少必须包含容器镜像字段支持的所有有效类型。通过合并清单层与容器镜像相同，OCI 对象会被挂载到单个目录中(spec.containers[].volumeMounts.mountPath)。该卷将被挂载为只读(ro)和不可执行的文件(noexec)。不支持容器的子路径挂载(spec.containers[].volumeMounts.subpath)。字段 spec.securityContext.fsGroupChangePolicy 对这个卷类型没有影响。

iscsi

object

iSCSI 代表附加到 kubelet 主机机器的 ISCSI Disk 资源，然后公开给 pod。更多信息： https://examples.k8s.io/volumes/iscsi/README.md

name

string

卷的名称。必须是 DNS_LABEL，且必须在 pod 中唯一。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

object

NFS 代表共享 pod 生命周期更多信息的主机上 NFS 挂载： https://kubernetes.io/docs/concepts/storage/volumes#nfs

persistentVolumeClaim

object

persistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

photonPersistentDisk

object

photonPersistentDisk 代表附加并挂载到 kubelets 主机上的 PhotonController 持久磁盘。弃用： PhotonPersistentDisk 已被弃用，in-tree photonPersistentDisk 类型不再被支持。

portworxVolume

object

portworxVolume 代表附加并挂载到 kubelets 主机上的 portworx 卷。deprecated: PortworxVolume 已被弃用。当 CSIMigrationPortworx feature-gate 为 on 时，in-tree portworxVolume 类型的所有操作都会被重定向到 pxd.portworx.com CSI 驱动程序。

projected

object

一个资源 secret、configmap 和 Downward API 中所有的项目项目

quobyte

object

quobyte 代表共享 pod 生命周期的主机上执行 Quobyte 挂载。deprecated: Quobyte 已被弃用，in-tree quobyte 类型不再被支持。

rbd

object

RBD 代表共享 pod 生命周期的主机上 Rados 块设备挂载。弃用：RBD 已被弃用，in-tree rbd 类型不再被支持。更多信息： https://examples.k8s.io/volumes/rbd/README.md

scaleIO

object

scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。deprecated: ScaleIO 已被弃用，in-tree scaleIO 类型不再被支持。

secret

object

Secret 代表应填充此卷的 secret。更多信息： https://kubernetes.io/docs/concepts/storage/volumes#secret

storageos

object

storageos 代表附加并挂载到 Kubernetes 节点上的 StorageOS 卷。已弃用：StorageOS 已被弃用，in-tree storageos 类型不再被支持。

vsphereVolume

object

vsphereVolume 代表附加并挂载到 kubelets 主机上的 vSphere 卷。已弃用：VsphereVolume 已被弃用。in-tree vsphereVolume 类型的所有操作都会重定向到 csi.vsphere.vmware.com CSI 驱动程序。

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 将强制 VolumeMount 中的 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。

diskName

string

diskname 是 blob 存储中的数据磁盘的 Name

diskURI

string

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

fsType

string

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

kind

string

kind 预期值为 Shared: 每个存储帐户 Dedicated 有多个 blob 磁盘：每个存储帐户 Managed: azure managed data disk (only on managed availability set). 默认为 shared

readOnly

布尔值

readonly Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

readOnly

布尔值

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

secretName

string

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

shareName

string

sharename 是 azure 共享名称

monitor

数组（字符串）

monitor 是必需的： monitor 是 Ceph 监视器更多信息的集合： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

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

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息： https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretfile 为 Optional: SecretFile 是用户密钥环的路径，默认为 /etc/ceph/user.secret 更多信息 ：https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

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

user

string

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

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

fsType

string

fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例："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

object

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

volumeID

string

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

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

defaultMode

整数

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

items

数组

如果未指定，则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中，其名称是键，内容是值。如果指定，列出的键将投射到指定的路径中，并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键，则卷设置将失败，除非标记为可选。路径必须是相对的，且不能包含 '..' 路径，或者以 '..' 开始。

items[]

对象

将字符串键映射到卷中的路径。

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

（可选）指定是否必须定义 ConfigMap 或其键

key

string

key 是项目的关键。

模式

整数

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

path

string

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

driver

string

driver 是处理此卷的 CSI 驱动程序的名称。请联系您的 admin，了解集群中注册的正确名称。

fsType

string

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

nodePublishSecretRef

object

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

readOnly

布尔值

readOnly 将卷指定为只读。默认为 false （读/写）。

volumeAttributes

对象（字符串）

volumeAttributes 存储传递给 CSI 驱动程序的驱动程序特定属性。有关支持的值，请参阅驱动程序的文档。

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

defaultMode

整数

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

items

array

items 是 Downward API 卷文件的列表

items[]

对象

DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息

fieldRef

object

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

模式

整数

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

path

字符串

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

resourceFieldRef

对象

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

apiVersion

字符串

模式的版本是按术语编写的 FieldPath，默认为 "v1"。

fieldPath

字符串

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

containerName

字符串

容器名称：卷需要，对于 env vars是可选的

divisor

integer-or-string

指定公开资源的输出格式，默认为 "1"

resource

字符串

必需：要选择的资源

中

string

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

sizeLimit

integer-or-string

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

volumeClaimTemplate

对象

将用于创建独立 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 存在后使用对 pod 的所有者引用来更新 PVC。通常，这应该不需要，但手动重建一个有问题的集群时可能会很有用。

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

必需，不能是 nil。

metadata

对象

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

spec

对象

PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。

accessModes

数组（字符串）

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

dataSource

object

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

dataSourceRef

object

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

resources

object

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

selector

object

selector 是要考虑绑定的卷的标签查询。

storageClassName

string

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

volumeAttributesClassName

string

volumeAttributesClassName 可用于设置此声明使用的 VolumeAttributesClass。如果指定，CSI 驱动程序将使用对应的 VolumeAttributesClass 中定义的属性创建或更新卷。这有一个不同于 storageClassName 的目的，可在创建声明后更改。空字符串表示，不会将 VolumeAttributesClass 应用到声明，但不允许在设置后将此字段重置为空字符串。如果未指定，并且 PersistentVolumeClaim 为 unbound，则 persistentvolume 控制器将设置默认的 VolumeAttributesClass （如果存在）。如果 volumeAttributesClass 引用的资源不存在，则这个 PersistentVolumeClaim 将被设置为 Pending 状态，如 modifyVolumeStatus 字段反映，直到资源存在为止。更多信息： https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta)使用此字段需要启用 VolumeAttributesClass 功能门（默认为关闭）。

volumeMode

字符串

volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时，文件系统的值会被表示。

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

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

limits

integer-or-string

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

requests

integer-or-string

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

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

key 是选择器应用到的标签键。

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。

fsType

string

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

lun

整数

LUN 是可选的：FC 目标 lun 号

readOnly

布尔值

readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。

targetWWNs

数组（字符串）

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

wwids

数组（字符串）

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

driver

string

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

fsType

string

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

options

对象（字符串）

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

readOnly

布尔值

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

secretRef

object

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

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

datasetName

string

datasetName 是数据存储为 Flocker dataset 上的 metadata name 的 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

directory

string

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

软件仓库

string

repository 是 URL

revision

string

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

端点

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

布尔值

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

path

string

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

type

string

HostPath Volume 默认为 "" 更多信息： https://kubernetes.io/docs/concepts/storage/volumes#hostpath

pullPolicy

string

拉取 OCI 对象的策略。可能的值有： Always: kubelet 始终会尝试拉取引用。如果拉取失败，容器创建将失败。Never：kubelet 从不拉取引用，只使用本地镜像或工件。如果引用不存在，容器创建将失败。IfNotPresent ：如果磁盘上不存在引用，kubelet 会拉取。如果引用不存在，则容器创建会失败，拉取会失败。如果指定了 :latest 标签，则默认为 Always，否则则默认为 IfNotPresent。

reference

string

必需：要使用的镜像或工件引用。行为与 pod.spec.containers[*].image 相同。pull secret 将像查找节点凭证、SA 镜像 pull secret 和 pod spec 镜像 pull secret 一样对容器镜像进行编译。更多信息： https://kubernetes.io/docs/concepts/containers/images 此字段是可选的，允许更高级别的配置管理默认或覆盖工作负载控制器（如 Deployments 和 StatefulSets）中的容器镜像。

chapAuthDiscovery

布尔值

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

chapAuthSession

布尔值

chapAuthSession 定义是否支持 iSCSI 会话 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

object

secretRef 是 iSCSI 目标和发起方身份验证的 CHAP Secret

targetPortal

string

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

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

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

claimName

string

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

readOnly

布尔值

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

fsType

string

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

pdID

string

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

fsType

string

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

readOnly

布尔值

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

volumeID

string

VolumeId 唯一标识 Portworx 卷