PodTemplate [v1]

metadata

ObjectMeta

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

spec

对象

PodSpec 是 Pod 的描述。

activeDeadlineSeconds

整数

Pod 相对于 StartTime 在节点上可能处于活动状态的可选持续时间（以秒为单位），在此之后，系统将主动尝试将其标记为失败并终止关联的容器。值必须是正整数。

affinity

对象

Affinity 是一组亲和调度规则。

automountServiceAccountToken

布尔值

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

containers

数组

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

containers[]

对象

要在 Pod 中运行的单个应用程序容器。

dnsConfig

对象

PodDNSConfig 定义了 Pod 的 DNS 参数，此外还有从 DNSPolicy 生成的参数。

dnsPolicy

字符串

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

可能的枚举值：- "ClusterFirst" 指示 Pod 应首先使用集群 DNS，除非 hostNetwork 为 true，如果可用，则回退到默认 (由 kubelet 确定) DNS 设置。- "ClusterFirstWithHostNet" 指示 Pod 应首先使用集群 DNS，如果可用，则回退到默认 (由 kubelet 确定) DNS 设置。- "Default" 指示 Pod 应使用默认 (由 kubelet 确定) DNS 设置。- "None" 指示 Pod 应使用空的 DNS 设置。诸如 nameservers 和搜索路径之类的 DNS 参数应通过 DNSConfig 定义。

enableServiceLinks

布尔值

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

ephemeralContainers

数组

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

ephemeralContainers[]

对象

EphemeralContainer 是一个临时容器，您可以将其添加到现有 Pod 中以执行用户启动的活动，例如调试。临时容器没有资源或调度保证，并且在它们退出或 Pod 被删除或重新启动时不会重新启动。如果临时容器导致 Pod 超出其资源分配，则 kubelet 可能会逐出 Pod。

要添加临时容器，请使用现有 Pod 的 ephemeralcontainers 子资源。临时容器不能被删除或重新启动。

hostAliases

数组

HostAliases 是主机和 IP 的可选列表，如果指定，它们将被注入到 Pod 的 hosts 文件中。

hostAliases[]

对象

HostAlias 保持 IP 和主机名之间的映射，这些映射将作为条目注入到 Pod 的 hosts 文件中。

hostIPC

布尔值

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

hostNetwork

布尔值

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

hostPID

布尔值

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

hostUsers

布尔值

使用宿主机用户命名空间。可选：默认为 true。如果设置为 true 或未设置，则 pod 将在宿主机用户命名空间中运行，这在 pod 需要仅宿主机用户命名空间才有的功能时很有用，例如使用 CAP_SYS_MODULE 加载内核模块。如果设置为 false，则会为 pod 创建一个新的 userns。设置为 false 有助于减轻容器逃逸漏洞，即使允许用户以 root 用户身份运行其容器，也不会拥有宿主机上的 root 权限。此字段处于 alpha 级别，只有启用 UserNamespacesSupport 功能的服务器才会考虑它。

hostname

字符串

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

imagePullSecrets

数组

ImagePullSecrets 是对相同命名空间中用于拉取此 PodSpec 使用的任何镜像的密钥的可选引用列表。如果指定，这些密钥将传递给各个拉取程序实现以供其使用。更多信息：https://kubernetes.ac.cn/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod

imagePullSecrets[]

对象

LocalObjectReference 包含足够的信息，使您可以找到相同命名空间中引用的对象。

initContainers

数组

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

initContainers[]

对象

要在 Pod 中运行的单个应用程序容器。

nodeName

字符串

NodeName 是将此 pod 调度到特定节点的请求。如果它非空，调度器只需将此 pod 调度到该节点，假设它符合资源要求。

nodeSelector

对象 (字符串)

NodeSelector 是一个选择器，pod 必须满足该选择器才能适合节点。选择器必须与节点的标签匹配，pod 才能调度到该节点。更多信息：https://kubernetes.ac.cn/docs/concepts/configuration/assign-pod-node/

os

对象

PodOS 定义 pod 的操作系统参数。

overhead

对象 (数量)

Overhead 表示与为给定 RuntimeClass 运行 pod 相关的资源开销。此字段将在准入时由 RuntimeClass 准入控制器自动填充。如果启用 RuntimeClass 准入控制器，则不得在 Pod 创建请求中设置 overhead。RuntimeClass 准入控制器将拒绝已设置 overhead 的 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 的优先级。启用优先级准入控制器后，它会阻止用户设置此字段。准入控制器从 PriorityClassName 填充此字段。值越高，优先级越高。

priorityClassName

字符串

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

readinessGates

数组

如果指定，则将评估所有就绪门以确定 pod 就绪状态。当所有容器都就绪并且就绪门中指定的所有条件的状态都等于“True”时，pod 就绪。更多信息：https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates

readinessGates[]

对象

PodReadinessGate 包含对 pod 条件的引用。

resourceClaims

数组

ResourceClaims 定义了在允许 Pod 启动之前必须分配和保留哪些 ResourceClaims。这些资源将通过名称提供给使用它们的容器。

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

此字段是不可变的。

resourceClaims[]

对象

PodResourceClaim 通过 ClaimSource 精确引用一个 ResourceClaim。它向其中添加一个名称，该名称唯一地标识 Pod 内的 ResourceClaim。需要访问 ResourceClaim 的容器使用此名称引用它。

restartPolicy

字符串

pod 内所有容器的重启策略。Always、OnFailure、Never 之一。在某些情况下，可能只允许使用这些值的一部分。默认为 Always。更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy

可能的枚举值：- `“Always”` - `“Never”` - `“OnFailure”`

runtimeClassName

字符串

RuntimeClassName 指的是 node.k8s.io 组中的 RuntimeClass 对象，应使用该对象来运行此 pod。如果没有 RuntimeClass 资源与指定的类匹配，则不会运行 pod。如果未设置或为空，则将使用“legacy”RuntimeClass，这是一个具有空定义的隐式类，它使用默认运行时处理程序。更多信息：https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class

schedulerName

字符串

如果指定，则 pod 将由指定的调度器调度。如果没有指定，则 pod 将由默认调度器调度。

schedulingGates

数组

SchedulingGates 是一个不透明的值列表，如果指定，则会阻止调度 pod。如果 schedulingGates 不为空，则 pod 将保持在 SchedulingGated 状态，并且调度器将不会尝试调度 pod。

调度网关只能在 Pod 创建时设置，之后才能移除。

schedulingGates[]

对象

PodSchedulingGate 与 Pod 关联，用于保护其调度。

securityContext

对象

PodSecurityContext 包含 Pod 级别的安全属性和公共容器设置。某些字段也存在于 container.securityContext 中。container.securityContext 的字段值优先于 PodSecurityContext 的字段值。

serviceAccount

字符串

DeprecatedServiceAccount 是 ServiceAccountName 的已弃用别名。已弃用：请改用 serviceAccountName。

serviceAccountName

字符串

ServiceAccountName 是用于运行此 Pod 的 ServiceAccount 的名称。更多信息：https://kubernetes.ac.cn/docs/tasks/configure-pod-container/configure-service-account/

setHostnameAsFQDN

布尔值

如果为 true，则 Pod 的主机名将配置为 Pod 的 FQDN，而不是叶子名称（默认值）。在 Linux 容器中，这意味着在内核的主机名字段（struct utsname 的 nodename 字段）中设置 FQDN。在 Windows 容器中，这意味着将注册表键 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters 的主机名注册表值设置为 FQDN。如果 Pod 没有 FQDN，则此设置无效。默认为 false。

shareProcessNamespace

布尔值

在 Pod 中的所有容器之间共享单个进程命名空间。设置此选项后，容器将能够查看和发送信号给同一 Pod 中其他容器的进程，并且每个容器中的第一个进程不会被分配 PID 1。HostPID 和 ShareProcessNamespace 不能同时设置。可选：默认为 false。

subdomain

字符串

如果指定，则完全限定的 Pod 主机名将为“<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>” 。如果没有指定，则 Pod 将根本没有域名。

terminationGracePeriodSeconds

整数

Pod 需要优雅终止的可选持续时间（秒）。可以在删除请求中减少此值。值必须是非负整数。值为零表示通过 kill 信号立即停止（没有关闭的机会）。如果此值为 nil，则将使用默认的宽限期。宽限期是在向 Pod 中运行的进程发送终止信号与使用 kill 信号强制停止进程之间的时间（秒）。将此值设置为长于进程的预期清理时间。默认为 30 秒。

tolerations

数组

如果指定，则为 Pod 的容忍度。

tolerations[]

对象

此容忍度附加到的 Pod 容忍任何与三元组 <key,value,effect> 匹配的污点，使用匹配运算符 <operator>。

topologySpreadConstraints

数组

TopologySpreadConstraints 描述了一组 Pod 如何跨拓扑域分布。调度程序将以遵守这些约束的方式调度 Pod。所有 topologySpreadConstraints 都是 AND 关系。

topologySpreadConstraints[]

对象

TopologySpreadConstraint 指定如何在给定的拓扑中分散匹配的 Pod。

volumes

数组

Pod 中的容器可以挂载的卷列表。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/volumes

volumes[]

对象

Volume 表示 Pod 中的命名卷，Pod 中的任何容器都可以访问它。

nodeAffinity

对象

节点亲和性是一组节点亲和性调度规则。

podAffinity

对象

Pod 亲和性是一组 Pod 间亲和性调度规则。

podAntiAffinity

对象

Pod 反亲和性是一组 Pod 间反亲和性调度规则。

preferredDuringSchedulingIgnoredDuringExecution

数组

调度程序会优先将 Pod 调度到满足此字段指定的亲和性表达式的节点，但它可以选择违反一个或多个表达式的节点。最优选的节点是权重总和最大的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 亲和性表达式等）的每个节点，通过迭代此字段的元素并根据节点是否与相应的 matchExpressions 匹配向总和添加“权重”来计算总和；总和最高的节点(s)是最优选的。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

空的首选调度项与所有具有隐式权重 0 的对象匹配（即它是一个无操作）。空的首选调度项不匹配任何对象（即也是一个无操作）。

requiredDuringSchedulingIgnoredDuringExecution

对象

节点选择器表示对一组节点的一项或多项标签查询结果的并集；也就是说，它表示节点选择器术语表示的选择器的 OR。

preference

对象

空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 AND 关系。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。

weight

整数

与匹配相应的 nodeSelectorTerm 相关的权重，范围为 1-100。

matchExpressions

数组

按节点标签的一组节点选择器要求。

matchExpressions[]

对象

节点选择器要求是一个选择器，其中包含值、键和一个关联键和值的运算符。

matchFields

数组

按节点字段的一组节点选择器要求。

matchFields[]

对象

节点选择器要求是一个选择器，其中包含值、键和一个关联键和值的运算符。

key

字符串

选择器应用到的标签键。

operator

字符串

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

可能的枚举值：- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组 (字符串)

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

可能的枚举值：- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组 (字符串)

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

nodeSelectorTerms

数组

必需。节点选择器术语列表。这些术语是 OR 关系。

nodeSelectorTerms[]

对象

空或空的节点选择器术语不匹配任何对象。它们的 requirement 是 AND 关系。TopologySelectorTerm 类型实现了 NodeSelectorTerm 的一个子集。

matchExpressions

数组

按节点标签的一组节点选择器要求。

matchExpressions[]

对象

节点选择器要求是一个选择器，其中包含值、键和一个关联键和值的运算符。

matchFields

数组

按节点字段的一组节点选择器要求。

matchFields[]

对象

节点选择器要求是一个选择器，其中包含值、键和一个关联键和值的运算符。

key

字符串

选择器应用到的标签键。

operator

字符串

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

可能的枚举值：- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组 (字符串)

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

可能的枚举值：- "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

values

数组 (字符串)

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

preferredDuringSchedulingIgnoredDuringExecution

数组

调度器会优先将 Pod 调度到满足此字段中指定的亲和性表达式的节点上，但它可以选择违反一个或多个表达式的节点。最优选的节点是权重总和最大的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 亲和性表达式等）的每个节点，通过迭代此字段的元素并根据节点上是否拥有匹配相应 podAffinityTerm 的 Pod 向总和添加“权重”来计算总和；总和最高的节点是最优选的节点。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

所有匹配的 WeightedPodAffinityTerm 字段的权重都会按节点相加，以找到最优选的节点。

requiredDuringSchedulingIgnoredDuringExecution

数组

如果调度时未满足此字段指定的亲和性要求，则 Pod 将不会调度到该节点上。如果在 Pod 执行期间的某个时间点不再满足此字段指定的亲和性要求（例如，由于 Pod 标签更新），系统可能会也可能不会尝试最终将 Pod 从其节点逐出。当有多个元素时，将对每个 podAffinityTerm 对应的节点列表进行相交运算，即所有术语都必须满足。

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 Pod（即相对于给定命名空间匹配 labelSelector 的那些 Pod），此 Pod 应该与这些 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 <topologyKey>）与任何节点上的 Pod 的标签值匹配，这些 Pod 属于这组 Pod。

podAffinityTerm

对象

定义一组 Pod（即相对于给定命名空间匹配 labelSelector 的那些 Pod），此 Pod 应该与这些 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 <topologyKey>）与任何节点上的 Pod 的标签值匹配，这些 Pod 属于这组 Pod。

weight

整数

与匹配相应 podAffinityTerm 相关的权重，范围为 1-100。

labelSelector

LabelSelector

对一组资源（在本例中为 Pod）进行标签查询。如果为 null，则此 PodAffinityTerm 不匹配任何 Pod。

matchLabelKeys

数组 (字符串)

MatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 matchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 matchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

mismatchLabelKeys

数组 (字符串)

MismatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key notin (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 mismatchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 mismatchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

namespaceSelector

LabelSelector

对术语适用的命名空间集进行标签查询。该术语应用于此字段选择的命名空间和 namespaces 字段中列出的命名空间的并集。null 选择器和 null 或空的命名空间列表表示“此 Pod 的命名空间”。空选择器 ({}) 匹配所有命名空间。

namespaces

数组 (字符串)

namespaces 指定术语适用的命名空间名称的静态列表。该术语应用于此字段中列出的命名空间和 namespaceSelector 选择的命名空间的并集。null 或空的命名空间列表和 null namespaceSelector 表示“此 Pod 的命名空间”。

topologyKey

字符串

此 Pod 应该与在指定命名空间中与 labelSelector 匹配的 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 topologyKey）与任何节点上的任何选定 Pod 的标签值匹配。不允许使用空的 topologyKey。

labelSelector

LabelSelector

对一组资源（在本例中为 Pod）进行标签查询。如果为 null，则此 PodAffinityTerm 不匹配任何 Pod。

matchLabelKeys

数组 (字符串)

MatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 matchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 matchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

mismatchLabelKeys

数组 (字符串)

MismatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key notin (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 mismatchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 mismatchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

namespaceSelector

LabelSelector

对术语适用的命名空间集进行标签查询。该术语应用于此字段选择的命名空间和 namespaces 字段中列出的命名空间的并集。null 选择器和 null 或空的命名空间列表表示“此 Pod 的命名空间”。空选择器 ({}) 匹配所有命名空间。

namespaces

数组 (字符串)

namespaces 指定术语适用的命名空间名称的静态列表。该术语应用于此字段中列出的命名空间和 namespaceSelector 选择的命名空间的并集。null 或空的命名空间列表和 null namespaceSelector 表示“此 Pod 的命名空间”。

topologyKey

字符串

此 Pod 应该与在指定命名空间中与 labelSelector 匹配的 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 topologyKey）与任何节点上的任何选定 Pod 的标签值匹配。不允许使用空的 topologyKey。

preferredDuringSchedulingIgnoredDuringExecution

数组

调度器会优先将 Pod 调度到满足此字段中指定的反亲和性表达式的节点上，但它可以选择违反一个或多个表达式的节点。最优选的节点是权重总和最大的节点，即对于满足所有调度要求（资源请求、requiredDuringScheduling 反亲和性表达式等）的每个节点，通过迭代此字段的元素并根据节点上是否拥有匹配相应 podAffinityTerm 的 Pod 向总和添加“权重”来计算总和；总和最高的节点是最优选的节点。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

所有匹配的 WeightedPodAffinityTerm 字段的权重都会按节点相加，以找到最优选的节点。

requiredDuringSchedulingIgnoredDuringExecution

数组

如果调度时未满足此字段指定的反亲和性要求，则 Pod 将不会调度到该节点上。如果在 Pod 执行期间的某个时间点不再满足此字段指定的反亲和性要求（例如，由于 Pod 标签更新），系统可能会也可能不会尝试最终将 Pod 从其节点逐出。当有多个元素时，将对每个 podAffinityTerm 对应的节点列表进行相交运算，即所有术语都必须满足。

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 Pod（即相对于给定命名空间匹配 labelSelector 的那些 Pod），此 Pod 应该与这些 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 <topologyKey>）与任何节点上的 Pod 的标签值匹配，这些 Pod 属于这组 Pod。

podAffinityTerm

对象

定义一组 Pod（即相对于给定命名空间匹配 labelSelector 的那些 Pod），此 Pod 应该与这些 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 <topologyKey>）与任何节点上的 Pod 的标签值匹配，这些 Pod 属于这组 Pod。

weight

整数

与匹配相应 podAffinityTerm 相关的权重，范围为 1-100。

labelSelector

LabelSelector

对一组资源（在本例中为 Pod）进行标签查询。如果为 null，则此 PodAffinityTerm 不匹配任何 Pod。

matchLabelKeys

数组 (字符串)

MatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 matchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 matchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

mismatchLabelKeys

数组 (字符串)

MismatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key notin (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 mismatchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 mismatchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

namespaceSelector

LabelSelector

对术语适用的命名空间集进行标签查询。该术语应用于此字段选择的命名空间和 namespaces 字段中列出的命名空间的并集。null 选择器和 null 或空的命名空间列表表示“此 Pod 的命名空间”。空选择器 ({}) 匹配所有命名空间。

namespaces

数组 (字符串)

namespaces 指定术语适用的命名空间名称的静态列表。该术语应用于此字段中列出的命名空间和 namespaceSelector 选择的命名空间的并集。null 或空的命名空间列表和 null namespaceSelector 表示“此 Pod 的命名空间”。

topologyKey

字符串

此 Pod 应该与在指定命名空间中与 labelSelector 匹配的 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 topologyKey）与任何节点上的任何选定 Pod 的标签值匹配。不允许使用空的 topologyKey。

labelSelector

LabelSelector

对一组资源（在本例中为 Pod）进行标签查询。如果为 null，则此 PodAffinityTerm 不匹配任何 Pod。

matchLabelKeys

数组 (字符串)

MatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key in (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 matchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 matchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

mismatchLabelKeys

数组 (字符串)

MismatchLabelKeys 是一组 Pod 标签键，用于选择哪些 Pod 将被考虑在内。这些键用于从传入的 Pod 标签中查找值，这些键值标签与 labelSelector 合并为 key notin (value)，以选择将被考虑用于传入 Pod 的 Pod（反）亲和性的现有 Pod 组。传入 Pod 标签中不存在的键将被忽略。默认值为 null。相同的键不能同时存在于 mismatchLabelKeys 和 labelSelector 中。此外，当 labelSelector 未设置时，不能设置 mismatchLabelKeys。这是一个 alpha 字段，需要启用 MatchLabelKeysInPodAffinity 功能门。

namespaceSelector

LabelSelector

对术语适用的命名空间集进行标签查询。该术语应用于此字段选择的命名空间和 namespaces 字段中列出的命名空间的并集。null 选择器和 null 或空的命名空间列表表示“此 Pod 的命名空间”。空选择器 ({}) 匹配所有命名空间。

namespaces

数组 (字符串)

namespaces 指定术语适用的命名空间名称的静态列表。该术语应用于此字段中列出的命名空间和 namespaceSelector 选择的命名空间的并集。null 或空的命名空间列表和 null namespaceSelector 表示“此 Pod 的命名空间”。

topologyKey

字符串

此 Pod 应该与在指定命名空间中与 labelSelector 匹配的 Pod 共存（亲和性）或不共存（反亲和性），其中共存定义为运行在节点上的 Pod，该节点的标签值（键为 topologyKey）与任何节点上的任何选定 Pod 的标签值匹配。不允许使用空的 topologyKey。

args

数组 (字符串)

入口参数。如果未提供，则使用容器镜像的 CMD。变量引用 $(VAR_NAME) 将使用容器的环境进行扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双美元符号将减少为单个美元符号，这允许转义 $(VAR_NAME) 语法：例如，“$(VAR_NAME)” 将生成字符串字面量 "$(VAR_NAME)"。转义的引用将永远不会被扩展，无论变量是否存在。

命令

数组 (字符串)

入口点数组。不在 shell 中执行。如果未提供，则使用容器镜像的 ENTRYPOINT。变量引用 $(VAR_NAME) 将使用容器的环境进行扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双美元符号将减少为单个美元符号，这允许转义 $(VAR_NAME) 语法：例如，“$(VAR_NAME)” 将生成字符串字面量 "$(VAR_NAME)"。转义的引用将永远不会被扩展，无论变量是否存在。

环境变量

数组

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

env[]

对象

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

环境变量来源

数组

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

envFrom[]

对象

EnvFromSource 表示一组 ConfigMap 的来源。

镜像

字符串

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

镜像拉取策略

字符串

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

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

生命周期

对象

Lifecycle 描述了管理系统应该对容器生命周期事件采取的操作。对于 PostStart 和 PreStop 生命周期处理程序，容器的管理会阻塞直到操作完成，除非容器进程失败，在这种情况下，处理程序将被中止。

存活性探针

对象

Probe 描述了针对容器执行的健康检查，以确定其是否存活或已准备好接收流量。

name

字符串

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

端口

数组

要从容器中暴露的端口列表。此处不指定端口并不会阻止该端口被暴露。容器内侦听默认“0.0.0.0”地址的任何端口都将可从网络访问。使用战略合并补丁修改此数组可能会损坏数据。有关更多信息，请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。

ports[]

对象

ContainerPort 表示单个容器中的网络端口。

就绪探针

对象

Probe 描述了针对容器执行的健康检查，以确定其是否存活或已准备好接收流量。

调整策略

数组

容器的资源调整策略。

resizePolicy[]

对象

ContainerResizePolicy 表示容器的资源调整策略。

资源

对象

ResourceRequirements 描述了计算资源需求。

restartPolicy

字符串

RestartPolicy 定义了 pod 中各个容器的重启行为。此字段可能仅针对 init 容器设置，并且唯一允许的值为“Always”。对于非 init 容器或未指定此字段时，重启行为由 Pod 的重启策略和容器类型定义。将 init 容器的 RestartPolicy 设置为“Always”将产生以下效果：此 init 容器将在退出时持续重启，直到所有常规容器都已终止。一旦所有常规容器都已完成，所有具有 restartPolicy“Always”的 init 容器都将关闭。此生命周期与普通 init 容器不同，通常被称为“sidecar”容器。尽管此 init 容器仍在 init 容器序列中启动，但在继续执行下一个 init 容器之前，它不会等待容器完成。相反，下一个 init 容器在此 init 容器启动后或任何 startupProbe 成功完成之后立即启动。

securityContext

对象

SecurityContext 包含将应用于容器的安全配置。某些字段同时存在于 SecurityContext 和 PodSecurityContext 中。同时设置两者时，SecurityContext 中的值优先。

启动探针

对象

Probe 描述了针对容器执行的健康检查，以确定其是否存活或已准备好接收流量。

标准输入

布尔值

此容器是否应在容器运行时中为标准输入分配缓冲区。如果未设置此项，则容器中来自标准输入的读取将始终导致 EOF。默认为 false。

一次性标准输入

布尔值

容器运行时是否应在单个附加程序打开标准输入通道后关闭它。当 stdin 为 true 时，标准输入流将在多个附加会话中保持打开状态。如果将 stdinOnce 设置为 true，则在容器启动时打开标准输入，在第一个客户端附加到标准输入之前为空，然后保持打开状态并接受数据，直到客户端断开连接，此时标准输入关闭并保持关闭状态，直到容器重新启动。如果此标志为 false，则从标准输入读取的容器进程将永远不会收到 EOF。默认为 false。

终止消息路径

字符串

可选：将容器终止消息写入的文件安装到容器文件系统的路径。写入的消息旨在简短地显示最终状态，例如断言失败消息。如果大于 4096 字节，则节点将对其进行截断。所有容器的总消息长度将限制为 12kb。默认为 /dev/termination-log。无法更新。

终止消息策略

字符串

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

可能的枚举值：- "FallbackToLogsOnError" 当容器以错误退出且 terminationMessagePath 没有内容时，将读取容器日志的最新内容作为容器状态消息。- "File" 是默认行为，当容器退出时，它会将容器状态消息设置为容器 terminationMessagePath 的内容。

TTY

布尔值

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

volumeDevices

数组

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

volumeDevices[]

对象

volumeDevice 描述了容器内原始块设备的映射。

volumeMounts

数组

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

volumeMounts[]

对象

VolumeMount 描述了在容器内挂载卷。

workingDir

字符串

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

name

字符串

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

value

字符串

使用容器中先前定义的环境变量和任何服务环境变量扩展变量引用 $(VAR_NAME)。如果无法解析变量，则输入字符串中的引用将保持不变。双美元符将简化为单个美元符，允许转义 $(VAR_NAME) 语法：即“(VAR_NAME)”将生成字符串字面量“$(VAR_NAME)”。转义的引用将永远不会扩展，无论变量是否存在。

valueFrom

对象

EnvVarSource 表示 EnvVar 值的来源。

configMapKeyRef

对象

从 ConfigMap 中选择一个键。

fieldRef

对象

ObjectFieldSelector 选择对象的 APIVersioned 字段。

resourceFieldRef

对象

ResourceFieldSelector 表示容器资源（cpu，内存）及其输出格式。

secretKeyRef

对象

SecretKeySelector 选择 Secret 的一个键。

key

字符串

要选择的键。

name

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性允许为空。此处值为空的此类型实例几乎肯定是不正确的。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names

optional

布尔值

指定是否必须定义 ConfigMap 或其键。

apiVersion

字符串

FieldPath 以其编写的模式版本，默认为“v1”。

fieldPath

字符串

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

containerName

字符串

容器名称：卷必需，环境变量可选。

divisor

Quantity

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

resource

字符串

必需：要选择的资源。