14.13. PodTemplate [v1]

metadata

ObjectMeta

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

spec

object

PodSpec 是 pod 的描述。

activeDeadlineSeconds

整数

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

关联性

object

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

automountServiceAccountToken

布尔值

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

containers

array

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

containers[]

对象

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

dnsConfig

object

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

dnsPolicy

字符串

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

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

enableServiceLinks

布尔值

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

ephemeralContainers

array

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

ephemeralContainers[]

object

EphemeralContainer 是一个临时容器，您可以为用户发起的活动（如调试）添加到现有 Pod 中。临时容器没有资源或调度保证，在 Pod 退出或重启时不会重启它们。如果临时容器导致 Pod 超过其资源分配，kubelet 可能会驱除 Pod。

要添加临时容器，请使用现有 Pod 的 ephemeralcontainers 子资源。可能无法删除或重启临时容器。

hostAliases

array

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

hostAliases[]

对象

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

hostIPC

布尔值

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

hostNetwork

布尔值

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

hostPID

布尔值

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

hostUsers

布尔值

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

hostname

字符串

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

imagePullSecrets

array

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

imagePullSecrets[]

对象

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

initContainers

array

属于 pod 的初始化容器列表。init 容器在容器启动前先执行。如果任何 init 容器失败，pod 被视为失败，并根据其 restartPolicy 处理。init 容器或普通容器的名称必须在所有容器间唯一。Init 容器可能没有生命周期操作、就绪度探测、存活度探测或启动探测。init 容器的 resourceRequirements 在调度过程中考虑，方法是为每个资源类型找到最高 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/

OS

object

PodOS 定义 pod 的 OS 参数。

开销

对象（数量）

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

preemptionPolicy

字符串

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

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

priority

整数

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

priorityClassName

字符串

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

readinessGates

array

如果指定，则会针对 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[]

object

PodResourceClaim 通过 ClaimSource 准确引用一个 ResourceClaim。它添加一个名称，用于唯一标识 Pod 中的 ResourceClaim。需要访问 ResourceClaim 的容器使用此名称引用它。

restartPolicy

字符串

为 pod 中的所有容器重启策略。Always、OnFailure、Never 之一。在某些上下文中，仅允许这些值的子集。默认值为 Always。更多信息： https://kubernetes.io/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。

SchedulingGates 只能在创建 pod 时设置，之后只能删除。

这是 PodSchedulingReadiness 功能门启用的 beta 功能。

schedulingGates[]

object

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

securityContext

object

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

serviceAccount

字符串

deprecatedServiceAccount 是 ServiceAccountName 的前文别名。deprecated ：改为使用 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。无法同时设置 hostPID 和 ShareProcessNamespace。可选：默认为 false。

subdomain

字符串

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

terminationGracePeriodSeconds

整数

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

容限（tolerations）

array

如果指定，pod 的容限。

tolerations[]

对象

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

topologySpreadConstraints

array

topologySpreadConstraints 描述如何在拓扑域中分散的 pod 组。调度程序将通过约束来调度 pod。所有 topologySpreadConstraints 都是 AND。

topologySpreadConstraints[]

对象

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

卷

array

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

volumes[]

对象

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

nodeAffinity

object

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

podAffinity

object

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

podAntiAffinity

object

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

object

节点选择器表示一个或多个对一组节点的标签查询结果的联合；即，它代表节点选择器术语代表的选择器的 OR。

preference

object

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

weight

整数

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

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

values

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

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

values

数组（字符串）

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

nodeSelectorTerms

array

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

nodeSelectorTerms[]

对象

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

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

values

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

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

values

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 pod （与给定命名空间匹配的 labelSelector 匹配），此 pod 应该与 pod 共存（关联性）或不共存（反关联性）匹配，其中 co-located 定义在带有键 <topologyKey> 标签的节点上运行，其标签的值与运行 pod 的任何节点匹配

podAffinityTerm

object

定义一组 pod （与给定命名空间匹配的 labelSelector 匹配），此 pod 应该与 pod 共存（关联性）或不共存（反关联性）匹配，其中 co-located 定义在带有键 <topologyKey> 标签的节点上运行，其标签的值与运行 pod 的任何节点匹配

weight

整数

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

labelSelector

labelSelector

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

namespaceSelector

labelSelector

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

labelSelector

labelSelector

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

namespaceSelector

labelSelector

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

定义一组 pod （与给定命名空间匹配的 labelSelector 匹配），此 pod 应该与 pod 共存（关联性）或不共存（反关联性）匹配，其中 co-located 定义在带有键 <topologyKey> 标签的节点上运行，其标签的值与运行 pod 的任何节点匹配

podAffinityTerm

object

定义一组 pod （与给定命名空间匹配的 labelSelector 匹配），此 pod 应该与 pod 共存（关联性）或不共存（反关联性）匹配，其中 co-located 定义在带有键 <topologyKey> 标签的节点上运行，其标签的值与运行 pod 的任何节点匹配

weight

整数

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

labelSelector

labelSelector

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

namespaceSelector

labelSelector

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

labelSelector

labelSelector

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

namespaceSelector

labelSelector

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

args

数组（字符串）

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

命令

数组（字符串）

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

env

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

string

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

imagePullPolicy

字符串

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

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

生命周期

object

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

livenessProbe

object

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

name

字符串

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

ports

array

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

ports[]

对象

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

readinessProbe

object

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

resizePolicy

数组

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

resizePolicy[]

object

ContainerResizePolicy 代表容器的资源大小策略。

resources

对象

ResourceRequirements 描述计算资源要求。

securityContext

object

securityContext 包含将应用到容器的安全配置。SecurityContext 和 PodSecurityContext 中都存在一些字段。当同时设置这两个时，SecurityContext 中的值就会优先使用。

startupProbe

object

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

stdin

布尔值

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

stdinOnce

布尔值

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

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

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

tty

布尔值

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

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

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

workingDir

字符串

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

name

字符串

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

value

字符串

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

valueFrom

object

EnvVarSource 代表 EnvVarar 的值的一个源。

configMapKeyRef

object

从 ConfigMap 中选择一个键。

fieldRef

object

ObjectFieldSelector 选择对象的 APIVersioned 字段。

resourceFieldRef

object

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

secretKeyRef

object

SecretKeySelector 选择 Secret 的密钥。

key

字符串

要选择的密钥。

name

字符串

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

optional

布尔值

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

apiVersion

字符串

FieldPath 用术语编写的 schema 版本，默认为 "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

object

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

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

prefix

字符串

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

secretRef

object

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

目标 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

postStart

object

LifecycleHandler 定义在生命周期 hook 中应执行的特定操作。必须指定其中一个字段，但必须指定 TCPSocket。

preStop

object

LifecycleHandler 定义在生命周期 hook 中应执行的特定操作。必须指定其中一个字段，但必须指定 TCPSocket。

exec

object

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

httpGet

object

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

tcpSocket

object

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

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

exec

object

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

httpGet

object

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

tcpSocket

object

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

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

exec

object

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

failureThreshold

整数

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

grpc

object

GRPC 指定涉及 GRPC 端口的操作。

httpGet

object

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

initialDelaySeconds

整数

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

periodSeconds

整数

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

successThreshold

整数

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

tcpSocket

object

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

terminationGracePeriodSeconds

整数

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

timeoutSeconds

整数

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

命令

数组（字符串）

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

port

整数

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

service

string

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

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

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

字符串

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

protocol

字符串

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

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

exec

object

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

failureThreshold

整数

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

grpc

object

GRPC 指定涉及 GRPC 端口的操作。

httpGet

object

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

initialDelaySeconds

整数

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

periodSeconds

整数

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

successThreshold

整数

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

tcpSocket

object

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

terminationGracePeriodSeconds

整数

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

timeoutSeconds

整数

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

命令

数组（字符串）

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

port

整数

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

service

string

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

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

resourceName

string

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

restartPolicy

string

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

声明

数组

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

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

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

claim[]

object

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

limits

对象（数量）

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

requests

对象（数量）

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

name

string

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

allowPrivilegeEscalation

布尔值

allowPrivilegeEscalation 控制进程是否可以获得比父进程更多的特权。此 bool 直接控制容器进程中是否设置了 no_new_privs 标志。当容器以 Privileged 2 运行为 Privileged 2 时，allowPrivilegeEscalation 为 true 时，当 spec.os.name 为窗口时，无法设置此字段。

功能

object

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

privileged

布尔值

以特权模式运行容器。特权容器中的进程实质上相当于主机上的 root 用户。默认为false。请注意，当 spec.os.name 是窗口时，无法设置此字段。

procMount

字符串

procMount 表示用于容器的 proc 挂载类型。默认为 DefaultProcMount，它对只读路径和屏蔽的路径使用容器运行时默认值。这需要启用 ProcMountType 功能标记。请注意，当 spec.os.name 是窗口时，无法设置此字段。

可能枚举值： - "Default" 将容器运行时默认值用于 /proc 的 readonly 和 masked 路径。大多数容器运行时屏蔽 /proc 中的某些路径，以避免意外暴露特殊设备或信息。- "Unmasked" 绕过容器运行时的默认屏蔽行为，并确保新创建的 /proc 容器在没有修改的情况下保持不变。

readOnlyRootFilesystem

布尔值

此容器是否具有只读根文件系统。默认值为 false。请注意，当 spec.os.name 是窗口时，无法设置此字段。

runAsGroup

整数

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

runAsNonRoot

布尔值

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

runAsUser

整数

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

seLinuxOptions

object

seLinuxOptions 是要应用到容器的标签

seccompProfile

object

SeccompProfile 定义 pod/container 的 seccomp 配置集设置。只能设置一个配置文件源。

windowsOptions

object

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

add

数组（字符串）

添加了功能

drop

数组（字符串）

删除的功能

level

字符串

level 是适用于容器的 SELinux 级别标签。

role

字符串

role 是适用于容器的 SELinux 角色标签。

type

字符串

type 是适用于容器的 SELinux 类型标签。

user

字符串

user 是适用于容器的 SELinux 用户标签。

localhostProfile

字符串

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

type

字符串

type 表示将应用了哪些 seccomp 配置集。有效选项有：

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

可能枚举值： - "Localhost" 表示应使用节点上文件中定义的配置集。文件相对于 <kubelet-root-dir>/seccomp. - "RuntimeDefault" 代表默认的容器运行时 seccomp 配置集。- "Unconfined" 表示没有应用 seccomp 配置集(A.K.A. unconfined)。

gmsaCredentialSpec

字符串

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

gmsaCredentialSpecName

字符串

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

hostProcess

布尔值

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

runAsUserName

字符串

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

exec

object

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

failureThreshold

整数

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

grpc

object

GRPC 指定涉及 GRPC 端口的操作。

httpGet

object

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

initialDelaySeconds

整数

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

periodSeconds

整数

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

successThreshold

整数

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

tcpSocket

object

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

terminationGracePeriodSeconds

整数

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

timeoutSeconds

整数

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

命令

数组（字符串）

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

port

整数

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

service

string

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

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

devicePath

字符串

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

name

字符串

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

mountPath

字符串

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

mountPropagation

字符串

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

可能枚举值： - "Bidirectional" 表示容器中的卷将从主机或其他容器接收新挂载，并且其自身的挂载将从容器传播到主机或其他容器。请注意，这个模式会递归应用到 Linux 术语中的卷中的所有挂载。- "HostToContainer" 表示容器中的卷将从主机或其他容器中接收新挂载，但挂载到容器中的文件系统不会传播到主机或其他容器。请注意，这个模式会递归应用到卷中的所有挂载("rslave")。- "None" 表示容器中的卷不会从主机或其他容器接收新挂载，以及挂载到容器中的文件系统不会传播到主机或其他容器。请注意，这个模式与 Linux 术语中的"private"对应。

name

字符串

这必须与卷的 Name 匹配。

readOnly

布尔值

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

subPath

字符串

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

subPathExpr

字符串

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

nameservers

数组（字符串）

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

options

array

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

options[]

对象

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

搜索

数组（字符串）

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

name

字符串

必需。

value

string

args

数组（字符串）

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

命令

数组（字符串）

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

env

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

string

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

imagePullPolicy

字符串

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

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

生命周期

object

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

livenessProbe

object

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

name

字符串

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

ports

array

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

ports[]

对象

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

readinessProbe

object

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

resizePolicy

数组

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

resizePolicy[]

object

ContainerResizePolicy 代表容器的资源大小策略。

resources

对象

ResourceRequirements 描述计算资源要求。

securityContext

object

securityContext 包含将应用到容器的安全配置。SecurityContext 和 PodSecurityContext 中都存在一些字段。当同时设置这两个时，SecurityContext 中的值就会优先使用。

startupProbe

object

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

stdin

布尔值

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

stdinOnce

布尔值

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

targetContainerName

字符串

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

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

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

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

tty

布尔值

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

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

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

workingDir

字符串

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

name

字符串

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

value

字符串

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

valueFrom

object

EnvVarSource 代表 EnvVarar 的值的一个源。

configMapKeyRef

object

从 ConfigMap 中选择一个键。

fieldRef

object

ObjectFieldSelector 选择对象的 APIVersioned 字段。

resourceFieldRef

object

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

secretKeyRef

object

SecretKeySelector 选择 Secret 的密钥。

key

字符串

要选择的密钥。

name

字符串

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

optional

布尔值

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

apiVersion

字符串

FieldPath 用术语编写的 schema 版本，默认为 "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

object

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

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

prefix

字符串

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

secretRef

object

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

目标 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

postStart

object

LifecycleHandler 定义在生命周期 hook 中应执行的特定操作。必须指定其中一个字段，但必须指定 TCPSocket。

preStop

object

LifecycleHandler 定义在生命周期 hook 中应执行的特定操作。必须指定其中一个字段，但必须指定 TCPSocket。

exec

object

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

httpGet

object

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

tcpSocket

object

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

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

exec

object

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

httpGet

object

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

tcpSocket

object

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

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port

IntOrString

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

exec

object

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

failureThreshold

整数

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

grpc

object

GRPC 指定涉及 GRPC 端口的操作。

httpGet

object

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

initialDelaySeconds

整数

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

periodSeconds

整数

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

successThreshold

整数

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

tcpSocket

object

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

terminationGracePeriodSeconds

整数

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

timeoutSeconds

整数

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

命令

数组（字符串）

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

port

整数

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

service

string

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

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

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

字符串

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

protocol

字符串

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

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

exec

object

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

failureThreshold

整数

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

grpc

object

GRPC 指定涉及 GRPC 端口的操作。

httpGet

object

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

initialDelaySeconds

整数

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

periodSeconds

整数

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

successThreshold

整数

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

tcpSocket

object

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

terminationGracePeriodSeconds

整数

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

timeoutSeconds

整数

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

命令

数组（字符串）

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

port

整数

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

service

string

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

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

IntOrString

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

scheme

字符串

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

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

name

string

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

value

字符串

标头字段值

主机

字符串

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

port