28.3. PodTemplate [v1]

metadata

ObjectMeta

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

spec

对象

PodSpec 是 pod 的描述。

activeDeadlineSeconds

整数

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

关联性

对象

关联性是一组关联性调度规则。

automountServiceAccountToken

布尔值

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

containers

array

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

containers[]

对象

要在 pod 中运行的单一应用程序容器。

dnsConfig

对象

PodDNSConfig 定义 pod 的 DNS 参数，除了从 DNSPolicy 生成的外。

dnsPolicy

字符串

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

enableServiceLinks

布尔值

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

ephemeralContainers

array

在此 pod 中运行临时容器的列表。临时容器可能在现有 pod 中运行，以执行用户发起的操作，如调试。此列表无法在创建 pod 时指定，无法通过更新 pod 规格来修改它。要将临时容器添加到现有 pod 中，请使用 pod 的 ephemeralcontainers 子资源。此字段是 alpha-level，仅由启用 EphemeralContainers 功能的服务器实现。

ephemeralContainers[]

对象

EphemeralContainer 是一个容器，可以临时添加到现有 pod 中，以进行用户发起的活动，如调试。临时容器没有资源或调度保证，在退出或 pod 被删除或重启时不会重启它们。如果临时容器导致 pod 超过其资源分配，则 pod 可能会被驱除。可能不会通过直接更新 pod 规格来添加临时容器。它们必须通过 pod 的 ephemeralcontainers 子资源添加，并在添加后出现在 pod 规格中。这是 EphemeralContainers 功能标记启用的 alpha 功能。

hostAliases

array

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

hostAliases[]

对象

HostAlias 包含 IP 和主机名之间的映射，这些映射将在 pod 的主机文件中作为条目注入。

hostIPC

布尔值

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

hostNetwork

布尔值

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

hostPID

布尔值

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

主机名

字符串

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

imagePullSecrets

array

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

imagePullSecrets[]

对象

LocalObjectReference 包含足够信息，供您在同一命名空间中查找引用的对象。

initContainers

array

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

initContainers[]

对象

要在 pod 中运行的单一应用程序容器。

nodeName

字符串

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

nodeSelector

对象（字符串）

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

开销

对象(Quantity)

开销代表了与为给定 RuntimeClass 运行 pod 相关的资源开销。这个字段将被 RuntimeClass 准入控制器在准入时自动填充。如果启用了 RuntimeClass 准入控制器，则必须在 Pod 创建请求中设置开销。RuntimeClass 准入控制器将拒绝 Pod 创建已设置了开销的请求。如果在 PodSpec 中配置并选择了 RuntimeClass，则 Overhead 将被设置为相应 RuntimeClass 中定义的值，否则它将保持未设置并被视为零。更多信息：从 Kubernetes v1.18 开始 ，https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md 此字段为 beta 级别，且仅由启用 PodOverhead 功能的服务器实现。

preemptionPolicy

字符串

preemptionPolicy 是抢占优先级较低的 pod 的策略。Never 之一，PreemptLowerPriority 之一。如果未设置，则默认为 PreemptLowerPriority。此字段是 beta 级别，由 NonPreemptingPriority 功能提示。

priority

整数

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

priorityClassName

字符串

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

readinessGates

array

如果指定，则会评估所有就绪度探测，以进行 pod 就绪。当所有容器都就绪，且就绪度探测中指定的所有条件都等于 "True" More info 时，pod 已就绪： https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates

readinessGates[]

对象

PodReadinessGate 包含对 pod 条件的引用

restartPolicy

字符串

为 pod 中所有容器重启策略。Always, OnFailure, Never 之一。默认值为 Always。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy

runtimeClassName

字符串

runtimeClassName 指的是 node.k8s.io 组中的 RuntimeClass 对象，它应该用于运行此 pod。如果没有 RuntimeClass 资源与命名类匹配，则不会运行 pod。如果未设置或为空，则使用"传统" RuntimeClass，它是一个隐式类，它带有一个空定义，该定义使用默认运行时处理程序。更多信息： https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class 从 Kubernetes v1.14 开始是一个 beta 功能。

schedulerName

字符串

如果指定，则 pod 将由指定的调度程序分配。如果没有指定，则默认调度程序将分配 pod。

securityContext

对象

PodSecurityContext 包含 pod 级别的安全属性和通用容器设置。container.securityContext 中也有一些字段。container.securityContext 的字段值优先于 PodSecurityContext 的字段值。

serviceAccount

字符串

DeprecatedServiceAccount 是 ServiceAccountName 的弃用别名。弃用：改为使用 serviceAccountName。

serviceAccountName

字符串

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

setHostnameAsFQDN

布尔值

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

shareProcessNamespace

布尔值

在 pod 中的所有容器间共享一个进程命名空间。当设置容器时，可以从同一 pod 中的其他容器查看和信号进程，并且每个容器中的第一个进程不会被分配 PID 1。主机PID 和 ShareProcessNamespace 不能同时设置。可选：默认为 false。

subdomain

字符串

如果指定，完全限定的 Pod 主机名将是 "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>"。如果没有指定，pod 根本都没有 domainname。

terminationGracePeriodSeconds

整数

pod 需要安全终止的可选持续时间（以秒为单位）。在删除请求中可能会减少。值必须是非负整数。值零表示立即通过 kill 信号停止（无机会关闭）。如果这个值为 nil，则改为使用默认的宽限期。宽限期是 pod 中运行的进程被发送终止信号后的持续时间（以秒为单位），以及进程被强制停止的时间（以秒为单位）。设置这个值的时间超过您的过程的预期清理时间。默认值为 30 秒。

容限（tolerations）

array

如果指定，pod 的容限。

tolerations[]

对象

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

topologySpreadConstraints

array

topologySpreadConstraints 描述了一组 pod ought 如何分散到拓扑域中。调度程序将以约束方式调度 pod。所有 topologySpreadConstraints 都是 ANDed。

topologySpreadConstraints[]

对象

TopologySpreadConstraint 指定如何将匹配的 pod 分散到给定拓扑中。

卷

array

由属于 pod 的容器可挂载的卷列表。更多信息： https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

对象

卷代表 pod 中可以被 pod 中任何容器访问的命名卷。

nodeAffinity

对象

节点关联性是一组节点关联性调度规则。

podAffinity

对象

pod 关联性是一组 pod 关联性调度规则。

podAntiAffinity

对象

Pod 反关联性是一组 pod 反关联性调度规则。

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

对象

节点选择器代表在一组节点上一个或多个标签查询的结果的取消；即，它代表节点选择器术语代表选择器术语的 OR。

preference

对象

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

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[]

对象

空或空节点选择器术语不匹配任何对象。它们的要求是 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 调度到满足此字段指定的关联性表达式的节点，但可以选择违反一个或多个表达式的节点。最首选的节点是，具有最高权重和最高权重的节点，即满足所有调度要求（资源请求、必需DuringScheduling 关联性表达式等）的节点，通过迭代此字段元素并在总和中添加"权重"的总和，如果节点具有与对应 podAffinityTerm 匹配的 pod，以及最高总和最高的节点。

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod （即，这个 pod 应该与运行 pod 的 pod 共存（关联性）或非并置（反关联性）匹配，其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行，其键为 <topologyKey> 匹配。

podAffinityTerm

对象

定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod （即，这个 pod 应该与运行 pod 的 pod 共存（关联性）或非并置（反关联性）匹配，其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行，其键为 <topologyKey> 匹配。

weight

整数

与对应 podAffinityTerm 匹配的权重在 1-100 之间。

labelSelector

labelSelector

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

namespaceSelector

labelSelector

对术语应用到的命名空间集合的标签查询。该术语适用于此字段选择的命名空间的取消，而 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。此字段是 beta 级别，只有在启用了 PodAffinityNamespaceSelector 功能时才遵循。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。该术语适用于此字段中列出的命名空间的取消，由 namespaceSelector. null 或空命名空间列表和 null namespaceSelector 选择的命名空间代表"此 pod 的命名空间"

topologyKey

字符串

此 pod 应该并置（关联性）或与指定命名空间中的 labelSelector 匹配的 pod 共处（反关联性），其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。

labelSelector

labelSelector

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

namespaceSelector

labelSelector

对术语应用到的命名空间集合的标签查询。该术语适用于此字段选择的命名空间的取消，而 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。此字段是 beta 级别，只有在启用了 PodAffinityNamespaceSelector 功能时才遵循。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。该术语适用于此字段中列出的命名空间的取消，由 namespaceSelector. null 或空命名空间列表和 null namespaceSelector 选择的命名空间代表"此 pod 的命名空间"

topologyKey

字符串

此 pod 应该并置（关联性）或与指定命名空间中的 labelSelector 匹配的 pod 共处（反关联性），其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod （即，这个 pod 应该与运行 pod 的 pod 共存（关联性）或非并置（反关联性）匹配，其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行，其键为 <topologyKey> 匹配。

podAffinityTerm

对象

定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod （即，这个 pod 应该与运行 pod 的 pod 共存（关联性）或非并置（反关联性）匹配，其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行，其键为 <topologyKey> 匹配。

weight

整数

与对应 podAffinityTerm 匹配的权重在 1-100 之间。

labelSelector

labelSelector

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

namespaceSelector

labelSelector

对术语应用到的命名空间集合的标签查询。该术语适用于此字段选择的命名空间的取消，而 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。此字段是 beta 级别，只有在启用了 PodAffinityNamespaceSelector 功能时才遵循。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。该术语适用于此字段中列出的命名空间的取消，由 namespaceSelector. null 或空命名空间列表和 null namespaceSelector 选择的命名空间代表"此 pod 的命名空间"

topologyKey

字符串

此 pod 应该并置（关联性）或与指定命名空间中的 labelSelector 匹配的 pod 共处（反关联性），其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。

labelSelector

labelSelector

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

namespaceSelector

labelSelector

对术语应用到的命名空间集合的标签查询。该术语适用于此字段选择的命名空间的取消，而 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。此字段是 beta 级别，只有在启用了 PodAffinityNamespaceSelector 功能时才遵循。

命名空间

数组（字符串）

namespaces 指定术语应用到的命名空间名称的静态列表。该术语适用于此字段中列出的命名空间的取消，由 namespaceSelector. null 或空命名空间列表和 null namespaceSelector 选择的命名空间代表"此 pod 的命名空间"

topologyKey

字符串

此 pod 应该并置（关联性）或与指定命名空间中的 labelSelector 匹配的 pod 共处（反关联性），其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。

args

数组（字符串）

入口点的参数。如果没有提供，则使用 docker 镜像的 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 中执行。如果没有提供，则使用 docker 镜像的 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

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

字符串

Docker 镜像名称。更多信息： 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

lifecycle

对象

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

livenessProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

name

字符串

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

ports

array

要从容器公开的端口列表。在此处公开端口可让系统有关容器使用的网络连接的额外信息，但主要是信息。在这里不指定端口不阻止公开该端口。任何侦听容器内的默认"0.0.0.0"地址的端口都可从网络访问。无法更新。

ports[]

对象

containerPort 代表单个容器中的网络端口。

readinessProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

资源

对象

ResourceRequirements 描述了计算资源要求。

securityContext

对象

securityContext 包含将应用到容器的安全配置。SecurityContext 和 PodSecurityContext 中都存在一些字段。当同时设置两者时，SecurityContextID 中的值将具有优先权。

startupProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

stdin

布尔值

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

stdinOnce

布尔值

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

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

tty

布尔值

此容器是否应为其自身分配一个 一 个，还需要"stdin"为 true。默认值为 false。

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

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

workingDir

字符串

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

name

字符串

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

value

字符串

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

valueFrom

对象

EnvVarSource 代表 EnvVar 值的源。

configMapKeyRef

对象

从 ConfigMap 中选择一个密钥。

fieldRef

对象

ObjectFieldSelector 选择对象的 APIVersioned 字段。

resourceFieldRef

对象

ResourceFieldSelector 代表容器资源(cpu、memory)及其输出格式

secretKeyRef

对象

SecretKeySelector 选择 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

数量

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

resource

字符串

必需：要选择的资源

key

字符串

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

name

字符串

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

optional

布尔值

指定是否必须定义 Secret 还是其密钥

configMapRef

对象

ConfigMapEnvSource 选择一个 ConfigMap 来填充环境变量。

目标 ConfigMap 的 Data 字段的内容将表示键值对作为环境变量。

prefix

字符串

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

secretRef

对象

SecretEnvSource 选择一个 Secret 来填充环境变量。

目标 Secret 的 Data 字段的内容将表示键值对作为环境变量。

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

postStart

对象

处理程序定义应采取的特定操作

preStop

对象

处理程序定义应采取的特定操作

exec

对象

ExecAction 描述了 "run in container" 操作。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

exec

对象

ExecAction 描述了 "run in container" 操作。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

exec

对象

ExecAction 描述了 "run in container" 操作。

failureThreshold

整数

成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

initialDelaySeconds

整数

在启动存活度探测前容器启动后的秒数。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

整数

执行探测的频率（以秒为单位）。默认值为 10 秒。最小值为 1。

successThreshold

整数

在失败后，探测的连续成功才被视为成功。默认值为 1。对于存活度和启动，必须是 1。最小值为 1。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

terminationGracePeriodSeconds

整数

pod 在探测失败时需要安全地终止的可选持续时间（以秒为单位）。宽限期是 pod 中运行的进程被发送终止信号后的持续时间（以秒为单位），以及进程被强制停止的时间（以秒为单位）。设置这个值的时间超过您的过程的预期清理时间。如果这个值为 nil，则使用 pod 的 terminationGracePeriodSeconds。否则，这个值会覆盖 pod 规格提供的值。值必须是非负整数。值零表示立即通过 kill 信号停止（无机会关闭）。这是一个 beta 字段，需要启用 ProbeTerminationGracePeriod 功能门。最小值为 1。如果未设置，则使用 spec.terminationGracePeriodSeconds。

timeoutSeconds

整数

探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

containerPort

整数

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

hostIP

字符串

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

hostPort

整数

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

name

字符串

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

protocol

字符串

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

exec

对象

ExecAction 描述了 "run in container" 操作。

failureThreshold

整数

成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

initialDelaySeconds

整数

在启动存活度探测前容器启动后的秒数。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

整数

执行探测的频率（以秒为单位）。默认值为 10 秒。最小值为 1。

successThreshold

整数

在失败后，探测的连续成功才被视为成功。默认值为 1。对于存活度和启动，必须是 1。最小值为 1。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

terminationGracePeriodSeconds

整数

pod 在探测失败时需要安全地终止的可选持续时间（以秒为单位）。宽限期是 pod 中运行的进程被发送终止信号后的持续时间（以秒为单位），以及进程被强制停止的时间（以秒为单位）。设置这个值的时间超过您的过程的预期清理时间。如果这个值为 nil，则使用 pod 的 terminationGracePeriodSeconds。否则，这个值会覆盖 pod 规格提供的值。值必须是非负整数。值零表示立即通过 kill 信号停止（无机会关闭）。这是一个 beta 字段，需要启用 ProbeTerminationGracePeriod 功能门。最小值为 1。如果未设置，则使用 spec.terminationGracePeriodSeconds。

timeoutSeconds

整数

探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

limits

对象(Quantity)

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

requests

对象(Quantity)

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

allowPrivilegeEscalation

布尔值

allowPrivilegeEscalation 控制进程是否可以获得比父进程更多的特权。此 bool 直接控制是否在容器进程上设置 no_new_privs 标志。当容器为 1 时，allowPrivilegeEscalation 始终为 true，作为 Privileged 2 运行）具有 CAP_SYS_ADMIN

功能

对象

从正在运行的容器中添加和删除 POSIX 功能。

privileged

布尔值

以特权模式运行容器。特权容器中的进程基本上相当于主机上的 root。默认为false。

procMount

字符串

procMount 表示要用于容器的 proc 挂载类型。默认为 DefaultProcMount，它对只读路径和屏蔽的路径使用容器运行时默认值。这需要启用 ProcMountType 功能标记。

readOnlyRootFilesystem

布尔值

此容器是否具有只读根文件系统。默认值为 false。

runAsGroup

整数

运行容器进程的入口点的 GID。如果未设置，则使用运行时默认值。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则 SecurityContext 的值将具有优先权。

runAsNonRoot

布尔值

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

runAsUser

整数

运行容器进程的入口点的 UID。如果未指定，则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则 SecurityContext 的值将具有优先权。

seLinuxOptions

对象

seLinuxOptions 是要应用到容器的标签

SeccompProfile

对象

SeccompProfile 定义 pod/容器的 seccomp 配置集设置。只能设置一个配置集源。

windowsOptions

对象

WindowsSecurityContextOptions 包含特定于 Windows 的选项和凭证。

add

数组（字符串）

添加了功能

drop

数组（字符串）

删除的功能

level

字符串

level 是应用到容器的 SELinux 级别标签。

role

字符串

Role 是一个适用于容器的 SELinux 角色标签。

type

字符串

type 是应用到容器的 SELinux 类型标签。

user

字符串

用户是应用到容器的 SELinux 用户标签。

localhostProfile

字符串

localhostProfile 表示应使用节点上文件中定义的配置集。该配置集必须预先配置在节点上才能正常工作。必须是相对于 kubelet 配置的 seccomp 配置集位置的降序路径。只有在 type 为 "Localhost" 时，才必须设置。

type

字符串

type 表示要应用哪些 seccomp 配置集类型。有效选项有：

localhost - 应使用节点上文件中定义的配置集。RuntimeDefault - 容器运行时默认配置集。unconfined - 不应该应用任何配置集。

gmsaCredentialSpec

字符串

GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpecName 字段命名的 GMSA 凭证规格的内容。

gmsaCredentialSpecName

字符串

GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。

hostProcess

布尔值

HostProcess 决定容器是否应该作为"主机进程"容器运行。此字段为 alpha-level，仅由启用 WindowsHostProcessContainers 功能标记的组件实现。在没有功能标记的情况下设置此字段会导致验证 Pod 时出现错误。所有 Pod 的容器都必须具有相同的有效的 HostProcess 值（不允许将 HostProcess 容器和非主机Process 容器混合在一起）。另外，如果 HostProcess 为 true，则 HostNetwork 还必须设置为 true。

runAsUserName

字符串

Windows 中的 UserName，用于运行容器进程的入口点。如果未指定，则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置，则 SecurityContext 的值将具有优先权。

exec

对象

ExecAction 描述了 "run in container" 操作。

failureThreshold

整数

成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

initialDelaySeconds

整数

在启动存活度探测前容器启动后的秒数。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

整数

执行探测的频率（以秒为单位）。默认值为 10 秒。最小值为 1。

successThreshold

整数

在失败后，探测的连续成功才被视为成功。默认值为 1。对于存活度和启动，必须是 1。最小值为 1。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

terminationGracePeriodSeconds

整数

pod 在探测失败时需要安全地终止的可选持续时间（以秒为单位）。宽限期是 pod 中运行的进程被发送终止信号后的持续时间（以秒为单位），以及进程被强制停止的时间（以秒为单位）。设置这个值的时间超过您的过程的预期清理时间。如果这个值为 nil，则使用 pod 的 terminationGracePeriodSeconds。否则，这个值会覆盖 pod 规格提供的值。值必须是非负整数。值零表示立即通过 kill 信号停止（无机会关闭）。这是一个 beta 字段，需要启用 ProbeTerminationGracePeriod 功能门。最小值为 1。如果未设置，则使用 spec.terminationGracePeriodSeconds。

timeoutSeconds

整数

探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

devicePath

字符串

DevicePath 是设备要映射到的容器内的路径。

name

字符串

名称必须与 pod 中的 persistentVolumeClaim 的名称匹配

mountPath

字符串

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

mountPropagation

字符串

mountPropagation 决定如何将挂载从主机传播到容器，以及传输的其他方式。如果没有设置，则使用 MountPropagationNone。此字段在 1.10 中是 beta。

name

字符串

这必须与卷的名称匹配。

readOnly

布尔值

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

subPath

字符串

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

subPathExpr

字符串

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

nameservers

数组（字符串）

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

options

array

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

options[]

对象

PodDNSConfigOption 定义 pod 的 DNS 解析器选项。

搜索

数组（字符串）

用于主机名称查询的 DNS 搜索域列表。这将附加到 DNSPolicy 生成的基本搜索路径中。重复的搜索路径将被删除。

name

字符串

必需。

value

字符串

args

数组（字符串）

入口点的参数。如果没有提供，则使用 docker 镜像的 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 中执行。如果没有提供，则使用 docker 镜像的 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

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

字符串

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

imagePullPolicy

字符串

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

lifecycle

对象

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

livenessProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

name

字符串

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

ports

array

临时容器不允许端口。

ports[]

对象

containerPort 代表单个容器中的网络端口。

readinessProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

资源

对象

ResourceRequirements 描述了计算资源要求。

securityContext

对象

securityContext 包含将应用到容器的安全配置。SecurityContext 和 PodSecurityContext 中都存在一些字段。当同时设置两者时，SecurityContextID 中的值将具有优先权。

startupProbe

对象

probe 描述了要为容器执行的健康检查，以确定它是否处于活动状态或准备好接收流量。

stdin

布尔值

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

stdinOnce

布尔值

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

targetContainerName

字符串

如果设置，则此临时容器目标的 PodSpec 中的容器名称。临时容器将在此容器的命名空间(IPC、PID 等)中运行。如果没有设置，则临时容器会在 pod 共享的任何命名空间中运行。请注意，容器运行时必须支持此功能。

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

tty

布尔值

此容器是否应为其自身分配一个 一 个，还需要"stdin"为 true。默认值为 false。

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

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

workingDir

字符串

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

name

字符串

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

value

字符串

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

valueFrom

对象

EnvVarSource 代表 EnvVar 值的源。

configMapKeyRef

对象

从 ConfigMap 中选择一个密钥。

fieldRef

对象

ObjectFieldSelector 选择对象的 APIVersioned 字段。

resourceFieldRef

对象

ResourceFieldSelector 代表容器资源(cpu、memory)及其输出格式

secretKeyRef

对象

SecretKeySelector 选择 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

数量

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

resource

字符串

必需：要选择的资源

key

字符串

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

name

字符串

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

optional

布尔值

指定是否必须定义 Secret 还是其密钥

configMapRef

对象

ConfigMapEnvSource 选择一个 ConfigMap 来填充环境变量。

目标 ConfigMap 的 Data 字段的内容将表示键值对作为环境变量。

prefix

字符串

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

secretRef

对象

SecretEnvSource 选择一个 Secret 来填充环境变量。

目标 Secret 的 Data 字段的内容将表示键值对作为环境变量。

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

postStart

对象

处理程序定义应采取的特定操作

preStop

对象

处理程序定义应采取的特定操作

exec

对象

ExecAction 描述了 "run in container" 操作。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

exec

对象

ExecAction 描述了 "run in container" 操作。

httpGet

对象

HTTPGetAction 描述了基于 HTTP Get 请求的操作。

tcpSocket

对象

TCPSocketAction 描述了基于打开套接字的操作

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

HTTPHeader 描述了在 HTTP 探测中使用的自定义标头

path

字符串

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

port

IntOrString

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

scheme

字符串

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

name

字符串

标头字段名称

value

字符串

标头字段值

主机

字符串

可选：要连接到的主机名，默认为 pod IP。

port

IntOrString

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

exec

对象

ExecAction 描述了 "run in container" 操作。

failureThreshold

整数