Pod

Pod 是可以在主机上运行的容器集合。

apiVersion: v1

import "k8s.io/api/core/v1"

Pod

Pod 是可以在主机上运行的容器集合。此资源由客户端创建并调度到主机上。


PodSpec

PodSpec 是 Pod 的描述。


容器

  • containers ([]Container), 必需

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

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

  • initContainers ([]Container)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

    属于 Pod 的初始化容器列表。初始化容器在普通容器启动之前按顺序执行。如果任何初始化容器失败,Pod 将被视为失败,并根据其 restartPolicy 进行处理。初始化容器或普通容器的名称在所有容器中必须是唯一的。初始化容器可能没有 Lifecycle 动作、Readiness 探针、Liveness 探针或 Startup 探针。初始化容器的 resourceRequirements 在调度时会被考虑,通过查找每种资源类型的最高请求/限制,然后使用该值或普通容器总和的最大值。限制以类似方式应用于初始化容器。初始化容器目前无法添加或删除。无法更新。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/init-containers/

  • ephemeralContainers ([]EphemeralContainer)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

    此 Pod 中运行的临时容器列表。临时容器可以在现有 Pod 中运行,以执行用户发起的调试等操作。创建 Pod 时不能指定此列表,也不能通过更新 Pod Spec 来修改。要向现有 Pod 添加临时容器,请使用 Pod 的 ephemeralcontainers 子资源。

  • imagePullSecrets ([]LocalObjectReference)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

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

  • enableServiceLinks (boolean)

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

  • os (PodOS)

    指定 Pod 中容器的操作系统。如果设置了此字段,则某些 Pod 和容器字段会受到限制。

    如果 OS 字段设置为 linux,则以下字段必须未设置: -securityContext.windowsOptions

    如果 OS 字段设置为 windows,则以下字段必须未设置: - spec.hostPID - spec.hostIPC - spec.hostUsers - spec.resources - spec.securityContext.appArmorProfile - spec.securityContext.seLinuxOptions - spec.securityContext.seccompProfile - spec.securityContext.fsGroup - spec.securityContext.fsGroupChangePolicy - spec.securityContext.sysctls - spec.shareProcessNamespace - spec.securityContext.runAsUser - spec.securityContext.runAsGroup - spec.securityContext.supplementalGroups - spec.securityContext.supplementalGroupsPolicy - spec.containers[].securityContext.appArmorProfile - spec.containers[].securityContext.seLinuxOptions - spec.containers[].securityContext.seccompProfile - spec.containers[].securityContext.capabilities - spec.containers[].securityContext.readOnlyRootFilesystem - spec.containers[].securityContext.privileged - spec.containers[].securityContext.allowPrivilegeEscalation - spec.containers[].securityContext.procMount - spec.containers[].securityContext.runAsUser - spec.containers[].securityContext.runAsGroup

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

调度

  • nodeSelector (map[string]string)

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

  • nodeName (string)

    NodeName 指示 Pod 调度到哪个节点。如果为空,则此 Pod 是由 schedulerName 中定义的调度器调度的候选 Pod。一旦设置此字段,该节点的 kubelet 将负责此 Pod 的生命周期。此字段不应用于表示希望将 Pod 调度到特定节点。https://kubernetes.ac.cn/docs/concepts/scheduling-eviction/assign-pod-node/#nodename

  • affinity (Affinity)

    如果指定,则为 Pod 的调度约束

    Affinity 是一组亲和性调度规则。

    • affinity.nodeAffinity (NodeAffinity)

      描述 Pod 的节点亲和性调度规则。

    • affinity.podAffinity (PodAffinity)

      描述 Pod 亲和性调度规则(例如,将此 Pod 与其他 Pod 调度到同一节点、区域等)。

    • affinity.podAntiAffinity (PodAntiAffinity)

      描述 Pod 反亲和性调度规则(例如,避免将此 Pod 与其他 Pod 调度到同一节点、区域等)。

  • tolerations ([]Toleration)

    原子性:在合并期间将被替换

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

    此 Toleration 所附加的 Pod 容忍所有与三重 <key,value,effect> 使用匹配运算符 匹配的污点。

    • tolerations.key (string)

      Key 是容忍度适用的污点键。空表示匹配所有污点键。如果键为空,则运算符必须为 Exists;此组合表示匹配所有值和所有键。

    • tolerations.operator (string)

      Operator 表示键与值之间的关系。有效运算符是 Exists 和 Equal。默认为 Equal。Exists 等同于值的通配符,因此 Pod 可以容忍特定类别的所有污点。

    • tolerations.value (string)

      Value 是容忍度匹配的污点值。如果运算符是 Exists,则值应为空,否则只是一个普通字符串。

    • tolerations.effect (string)

      Effect 指示要匹配的污点效果。空表示匹配所有污点效果。如果指定,允许的值是 NoSchedule、PreferNoSchedule 和 NoExecute。

    • tolerations.tolerationSeconds (int64)

      TolerationSeconds 表示容忍度(必须是 NoExecute 效果,否则此字段将被忽略)容忍污点的时间段。默认情况下,不设置此字段,这意味着永远容忍污点(不驱逐)。零和负值将被系统视为 0(立即驱逐)。

  • schedulerName (string)

    如果指定,Pod 将由指定的调度器调度。如果未指定,Pod 将由默认调度器调度。

  • runtimeClassName (string)

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

  • priorityClassName (string)

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

  • priority (int32)

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

  • preemptionPolicy (string)

    PreemptionPolicy 是抢占低优先级 Pod 的策略。可以是 Never、PreemptLowerPriority 之一。如果未设置,默认为 PreemptLowerPriority。

  • topologySpreadConstraints ([]TopologySpreadConstraint)

    补丁策略:按键 topologyKey 合并

    映射:在合并过程中将保留键 topologyKey, whenUnsatisfiable 上的唯一值

    TopologySpreadConstraints 描述了一组 Pod 如何跨拓扑域进行分布。调度器将以遵守约束的方式调度 Pod。所有 topologySpreadConstraints 都通过 AND 逻辑组合。

    TopologySpreadConstraint 指定了如何将匹配的 Pod 分布到给定的拓扑中。

    • topologySpreadConstraints.maxSkew (int32), 必需

      MaxSkew 描述了 Pod 不均匀分布的程度。当 whenUnsatisfiable=DoNotSchedule 时,它是目标拓扑中匹配 Pod 数量与全局最小值之间的最大允许差异。全局最小值是符合条件的域中匹配 Pod 的最小数量,如果符合条件的域数量少于 MinDomains,则为零。例如,在 3 区集群中,MaxSkew 设置为 1,具有相同 labelSelector 的 Pod 分布为 2/2/1:在此情况下,全局最小值为 1。 | zone1 | zone2 | zone3 | | P P | P P | P | - 如果 MaxSkew 为 1,传入 Pod 只能调度到 zone3 才能变为 2/2/2;将其调度到 zone1(zone2) 将使 zone1(zone2) 上的 ActualSkew(3-1) 违反 MaxSkew(1)。 - 如果 MaxSkew 为 2,传入 Pod 可以调度到任何区域。当 whenUnsatisfiable=ScheduleAnyway 时,它用于赋予满足它的拓扑更高的优先级。这是一个必需字段。默认值为 1,不允许为 0。

    • topologySpreadConstraints.topologyKey (string), 必需

      TopologyKey 是节点标签的键。具有此键和相同值的标签的节点被视为处于同一拓扑中。我们将每个 <键,值> 视为一个“桶”,并尝试将均衡数量的 Pod 放入每个桶中。我们将域定义为拓扑的特定实例。此外,我们将符合条件的域定义为其节点满足 nodeAffinityPolicy 和 nodeTaintsPolicy 要求的域。例如,如果 TopologyKey 是“kubernetes.io/hostname”,则每个节点都是该拓扑的一个域。如果 TopologyKey 是“topology.kubernetes.io/zone”,则每个区域都是该拓扑的一个域。这是一个必需字段。

    • topologySpreadConstraints.whenUnsatisfiable (string), 必需

      WhenUnsatisfiable 指示如果 Pod 不满足传播约束,应如何处理。 - DoNotSchedule (默认) 告诉调度器不要调度它。 - ScheduleAnyway 告诉调度器在任何位置调度 Pod,但对有助于减少偏差的拓扑赋予更高优先级。如果 Pod 的每个可能的节点分配都会违反某个拓扑上的“MaxSkew”,则该约束对于传入 Pod 被认为是“不可满足”的。例如,在 3 区集群中,MaxSkew 设置为 1,具有相同 labelSelector 的 Pod 分布为 3/1/1: | zone1 | zone2 | zone3 | | P P P | P | P | 如果 WhenUnsatisfiable 设置为 DoNotSchedule,传入 Pod 只能调度到 zone2(zone3) 才能变为 3/2/1(3/1/2),因为 zone2(zone3) 上的 ActualSkew(2-1) 满足 MaxSkew(1)。换句话说,集群仍然可能不平衡,但调度器不会使其变得*更*不平衡。这是一个必需字段。

    • topologySpreadConstraints.labelSelector (LabelSelector)

      LabelSelector 用于查找匹配的 Pod。匹配此标签选择器的 Pod 将被计数,以确定其相应拓扑域中的 Pod 数量。

    • topologySpreadConstraints.matchLabelKeys ([]string)

      原子性:在合并期间将被替换

      MatchLabelKeys 是一组 Pod 标签键,用于选择将计算传播的 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 进行 AND 运算,以选择将为传入 Pod 计算传播的现有 Pod 组。禁止在 MatchLabelKeys 和 LabelSelector 中存在相同的键。当 LabelSelector 未设置时,不能设置 MatchLabelKeys。传入 Pod 标签中不存在的键将被忽略。空或空列表表示仅与 labelSelector 匹配。

      这是一个测试版字段,需要启用 MatchLabelKeysInPodTopologySpread 功能门(默认启用)。

    • topologySpreadConstraints.minDomains (int32)

      MinDomains 表示符合条件的域的最小数量。当具有匹配拓扑键的符合条件的域的数量小于 minDomains 时,Pod 拓扑分布将“全局最小值”视为 0,然后执行 Skew 的计算。当具有匹配拓扑键的符合条件的域的数量等于或大于 minDomains 时,此值对调度没有影响。因此,当符合条件的域的数量小于 minDomains 时,调度器不会将超过 maxSkew 的 Pod 调度到这些域。如果值为 nil,则约束的行为如同 MinDomains 等于 1。有效值是大于 0 的整数。当值不为 nil 时,WhenUnsatisfiable 必须为 DoNotSchedule。

      例如,在 3 区集群中,MaxSkew 设置为 2,MinDomains 设置为 5,并且具有相同 labelSelector 的 Pod 分布为 2/2/2: | zone1 | zone2 | zone3 | | P P | P P | P P | 域的数量小于 5(MinDomains),因此“全局最小值”被视为 0。在这种情况下,具有相同 labelSelector 的新 Pod 无法调度,因为如果新 Pod 调度到三个区域中的任何一个,计算出的偏差将为 3(3 - 0),这将违反 MaxSkew。

    • topologySpreadConstraints.nodeAffinityPolicy (string)

      NodeAffinityPolicy 指示在计算 Pod 拓扑分布偏差时如何处理 Pod 的 nodeAffinity/nodeSelector。选项包括: - Honor:只有匹配 nodeAffinity/nodeSelector 的节点才包含在计算中。 - Ignore:nodeAffinity/nodeSelector 被忽略。所有节点都包含在计算中。

      如果此值为 nil,则行为等同于 Honor 策略。

    • topologySpreadConstraints.nodeTaintsPolicy (string)

      NodeTaintsPolicy 指示在计算 Pod 拓扑分布偏差时如何处理节点污点。选项包括: - Honor:包含没有污点的节点,以及传入 Pod 具有容忍度的污点节点。 - Ignore:节点污点被忽略。所有节点都包含在计算中。

      如果此值为 nil,则行为等同于 Ignore 策略。

  • overhead (map[string]Quantity)

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

生命周期

  • restartPolicy (string)

    Pod 中所有容器的重启策略。可以是 Always、OnFailure、Never 之一。在某些上下文中,可能只允许这些值的一个子集。默认为 Always。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy

  • terminationGracePeriodSeconds (int64)

    Pod 优雅终止所需的秒数,可选。在删除请求中可能会减少。值必须是非负整数。零值表示通过终止信号立即停止(没有机会关闭)。如果此值为 nil,将使用默认宽限期。宽限期是指 Pod 中运行的进程收到终止信号后到进程被终止信号强制停止之间的时间(以秒为单位)。将此值设置得比进程的预期清理时间更长。默认为 30 秒。

  • activeDeadlineSeconds (int64)

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

  • readinessGates ([]PodReadinessGate)

    原子性:在合并期间将被替换

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

    PodReadinessGate 包含对 Pod 条件的引用

    • readinessGates.conditionType (string), 必需

      ConditionType 指的是 Pod 条件列表中具有匹配类型的条件。

主机名和名称解析

  • hostname (string)

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

  • hostnameOverride (string)

    HostnameOverride 指定了 Pod 自身感知的主机名的显式覆盖。此字段仅指定 Pod 的主机名,不影响其 DNS 记录。当此字段设置为非空字符串时: - 它优先于 hostnamesubdomain 中设置的值。 - Pod 的主机名将设置为此值。 - setHostnameAsFQDN 必须为 nil 或设置为 false。 - hostNetwork 必须设置为 false。

    此字段必须是 RFC 1123 中定义的有效 DNS 子域名,且最多包含 64 个字符。需要启用 HostnameOverride 功能门。

  • setHostnameAsFQDN (boolean)

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

  • subdomain (string)

    如果指定,完全限定的 Pod 主机名将是“<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>”。如果未指定,Pod 将完全没有域名。

  • hostAliases ([]HostAlias)

    补丁策略:按键 ip 合并

    映射:在合并过程中将保留键 ip 上的唯一值

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

    HostAlias 包含 IP 和主机名之间的映射,该映射将作为 Pod 的 hosts 文件中的一个条目注入。

    • hostAliases.ip (string), 必需

      主机文件条目的 IP 地址。

    • hostAliases.hostnames ([]string)

      原子性:在合并期间将被替换

      上述 IP 地址的主机名。

  • dnsConfig (PodDNSConfig)

    指定 Pod 的 DNS 参数。此处指定的参数将与基于 DNSPolicy 生成的 DNS 配置合并。

    PodDNSConfig 定义 Pod 的 DNS 参数,以及从 DNSPolicy 生成的参数。

    • dnsConfig.nameservers ([]string)

      原子性:在合并期间将被替换

      DNS 命名服务器 IP 地址列表。此列表将附加到从 DNSPolicy 生成的基本命名服务器之后。重复的命名服务器将被移除。

    • dnsConfig.options ([]PodDNSConfigOption)

      原子性:在合并期间将被替换

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

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

      • dnsConfig.options.name (string)

        Name 是此 DNS 解析器选项的名称。必需。

      • dnsConfig.options.value (string)

        Value 是此 DNS 解析器选项的值。

    • dnsConfig.searches ([]string)

      原子性:在合并期间将被替换

      用于主机名查找的 DNS 搜索域列表。此列表将附加到从 DNSPolicy 生成的基本搜索路径之后。重复的搜索路径将被移除。

  • dnsPolicy (string)

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

主机命名空间

  • hostNetwork (boolean)

    为此 Pod 请求主机网络。使用主机的网络命名空间。使用 HostNetwork 时,您应该指定端口,以便调度器知晓。当 hostNetwork 为 true 时,端口定义中指定的 hostPort 字段必须与 containerPort 匹配,并且端口定义中未指定的 hostPort 字段默认为匹配 containerPort。默认为 false。

  • hostPID (boolean)

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

  • hostIPC (boolean)

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

  • shareProcessNamespace (boolean)

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

服务帐户

安全上下文

  • securityContext (PodSecurityContext)

    SecurityContext 包含 Pod 级别的安全属性和常见容器设置。可选:默认为空。请参阅类型描述以了解每个字段的默认值。

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

    • securityContext.appArmorProfile (AppArmorProfile)

      appArmorProfile 是此 Pod 中容器使用的 AppArmor 选项。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      AppArmorProfile 定义 Pod 或容器的 AppArmor 设置。

      • securityContext.appArmorProfile.type (string), 必需

        type 指示将应用哪种 AppArmor 配置文件。有效选项是:Localhost - 节点上预加载的配置文件。RuntimeDefault - 容器运行时的默认配置文件。Unconfined - 不强制执行 AppArmor。

      • securityContext.appArmorProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上加载的配置文件。该配置文件必须预先配置在节点上才能工作。必须与加载的配置文件名称匹配。当且仅当 type 为“Localhost”时必须设置。

    • securityContext.fsGroup (int64)

      适用于 Pod 中所有容器的特殊补充组。某些卷类型允许 Kubelet 更改该卷的所有权,使其归 Pod 所有

      1. 拥有 GID 将是 FSGroup 2。设置了 setgid 位(在卷中创建的新文件将由 FSGroup 拥有) 3。权限位与 rw-rw---- 进行 OR 运算

      如果未设置,Kubelet 将不会修改任何卷的所有权和权限。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.fsGroupChangePolicy (string)

      fsGroupChangePolicy 定义了在 Pod 内部暴露卷之前更改卷所有权和权限的行为。此字段仅适用于支持基于 fsGroup 的所有权(和权限)的卷类型。它对 secret、configmaps 和 emptydir 等临时卷类型没有影响。有效值是“OnRootMismatch”和“Always”。如果未指定,则使用“Always”。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.runAsUser (int64)

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

    • securityContext.runAsNonRoot (boolean)

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

    • securityContext.runAsGroup (int64)

      运行容器进程入口点的 GID。如果未设置,则使用运行时默认值。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值对此容器优先。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.seccompProfile (SeccompProfile)

      此 Pod 中容器使用的 seccomp 选项。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      SeccompProfile 定义 Pod/容器的 seccomp 配置文件设置。只能设置一个配置文件源。

      • securityContext.seccompProfile.type (string), 必需

        type 指示将应用哪种 seccomp 配置文件。有效选项是

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

      • securityContext.seccompProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上文件中定义的配置文件。该配置文件必须预先配置在节点上才能工作。必须是相对 kubelet 配置的 seccomp 配置文件位置的递减路径。当 type 为“Localhost”时必须设置。对于任何其他类型,不得设置。

    • securityContext.seLinuxChangePolicy (string)

      seLinuxChangePolicy 定义了如何将容器的 SELinux 标签应用于 Pod 使用的所有卷。它对不支持 SELinux 的节点或不支持 SELinux 的卷没有影响。有效值是“MountOption”和“Recursive”。

      “Recursive”表示容器运行时对所有 Pod 卷中的所有文件重新标记。这对于大型卷可能很慢,但允许特权和非特权 Pod 在同一节点上共享同一卷。

      “MountOption”使用 -o context 挂载选项挂载所有符合条件的 Pod 卷。这要求共享同一卷的所有 Pod 使用相同的 SELinux 标签。不可能在特权和非特权 Pod 之间共享同一卷。符合条件的卷是树内 FibreChannel 和 iSCSI 卷,以及所有 CSI 驱动程序通过在其 CSIDriver 实例中设置 spec.seLinuxMount: true 来宣布支持 SELinux 的 CSI 卷。其他卷始终递归重新标记。“MountOption”值仅在启用 SELinuxMount 功能门时才允许。

      如果未指定且 SELinuxMount 功能门已启用,则使用“MountOption”。如果未指定且 SELinuxMount 功能门已禁用,则 ReadWriteOncePod 卷使用“MountOption”,所有其他卷使用“Recursive”。

      此字段仅影响设置了 SELinux 标签的 Pod,无论是在 PodSecurityContext 中还是在所有容器的 SecurityContext 中。

      所有使用同一卷的 Pod 都应使用相同的 seLinuxChangePolicy,否则某些 Pod 可能会卡在 ContainerCreating 状态。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.seLinuxOptions (SELinuxOptions)

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

      SELinuxOptions 是要应用于容器的标签

      • securityContext.seLinuxOptions.level (string)

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

      • securityContext.seLinuxOptions.role (string)

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

      • securityContext.seLinuxOptions.type (string)

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

      • securityContext.seLinuxOptions.user (string)

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

    • securityContext.supplementalGroups ([]int64)

      原子性:在合并期间将被替换

      应用于每个容器中运行的第一个进程的组列表,除了容器的主 GID 和 fsGroup(如果指定)。如果 SupplementalGroupsPolicy 功能已启用,则 supplementalGroupsPolicy 字段决定这些组是容器镜像中定义的任何组成员资格的补充还是替代。如果未指定,则不添加额外组,尽管容器镜像中定义的组成员资格仍可能使用,具体取决于 supplementalGroupsPolicy 字段。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.supplementalGroupsPolicy (string)

      定义第一个容器进程的补充组的计算方式。有效值是“Merge”和“Strict”。如果未指定,则使用“Merge”。(Alpha) 使用此字段需要启用 SupplementalGroupsPolicy 功能门,并且容器运行时必须实现对该功能的支持。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.sysctls ([]Sysctl)

      原子性:在合并期间将被替换

      Sysctls 包含 Pod 使用的命名空间 sysctl 列表。具有不支持的 sysctl(由容器运行时)的 Pod 可能无法启动。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      Sysctl 定义要设置的内核参数

      • securityContext.sysctls.name (string), 必需

        要设置的属性名称

      • securityContext.sysctls.value (string), 必需

        要设置的属性值

    • securityContext.windowsOptions (WindowsSecurityContextOptions)

      应用于所有容器的 Windows 特定设置。如果未指定,将使用容器 SecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 linux 时,不能设置此字段。

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

      • securityContext.windowsOptions.gmsaCredentialSpec (string)

        GMSACredentialSpec 是 GMSA 准入 webhook (https://github.com/kubernetes-sigs/windows-gmsa) 内联由 GMSACredentialSpecName 字段命名的 GMSA 凭据规范内容的位置。

      • securityContext.windowsOptions.gmsaCredentialSpecName (string)

        GMSACredentialSpecName 是要使用的 GMSA 凭据规范的名称。

      • securityContext.windowsOptions.hostProcess (boolean)

        HostProcess 决定容器是否应作为“主机进程”容器运行。Pod 的所有容器必须具有相同的有效 HostProcess 值(不允许混合使用 HostProcess 容器和非 HostProcess 容器)。此外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。

      • securityContext.windowsOptions.runAsUserName (string)

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

Alpha 级别

  • hostUsers (boolean)

    使用主机的用户命名空间。可选:默认为 true。如果设置为 true 或不存在,Pod 将在主机用户命名空间中运行,这对于 Pod 需要主机用户命名空间才可用的功能(例如使用 CAP_SYS_MODULE 加载内核模块)非常有用。如果设置为 false,则为 Pod 创建新的 userns。将 false 设置为有助于减轻容器逃逸漏洞,甚至允许用户以 root 身份运行容器,而无需在主机上实际拥有 root 权限。此字段是 alpha 级别,并且仅受启用 UserNamespacesSupport 功能的服务器支持。

  • resources (ResourceRequirements)

    Resources 是 Pod 中所有容器所需的 CPU 和内存资源总量。它仅支持指定“cpu”、“memory”和“hugepages-”资源名称的 Requests 和 Limits。不支持 ResourceClaims。

    此字段可实现对整个 Pod 资源分配的精细控制,允许 Pod 中的容器之间共享资源。

    这是一个 alpha 字段,需要启用 PodLevelResources 功能门。

    ResourceRequirements 描述了计算资源要求。

    • resources.claims ([]ResourceClaim)

      映射:合并时将保留键名上的唯一值

      Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

      此字段依赖于 DynamicResourceAllocation 功能门。

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

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

      • resources.claims.name (string), 必需

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

      • resources.claims.request (string)

        Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

    • resources.limits (map[string]Quantity)

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

    • resources.requests (map[string]Quantity)

      Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

  • resourceClaims ([]PodResourceClaim)

    补丁策略:保留键,按键 name 合并

    映射:合并时将保留键名上的唯一值

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

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

    此字段是不可变的。

    *PodResourceClaim 引用一个且只有一个 ResourceClaim,可以直接引用,也可以通过命名 ResourceClaimTemplate 来引用,然后该模板将转换为 Pod 的 ResourceClaim。

    它为其添加一个名称,以在 Pod 内部唯一标识 ResourceClaim。需要访问 ResourceClaim 的容器使用此名称引用它。*

    • resourceClaims.name (string), 必需

      Name 在 Pod 内部唯一标识此资源声明。这必须是一个 DNS_LABEL。

    • resourceClaims.resourceClaimName (string)

      ResourceClaimName 是与此 Pod 位于同一命名空间中的 ResourceClaim 对象的名称。

      ResourceClaimName 和 ResourceClaimTemplateName 中必须且只能设置一个。

    • resourceClaims.resourceClaimTemplateName (string)

      ResourceClaimTemplateName 是与此 Pod 位于同一命名空间中的 ResourceClaimTemplate 对象的名称。

      该模板将用于创建一个新的 ResourceClaim,该 ResourceClaim 将绑定到此 Pod。当此 Pod 被删除时,ResourceClaim 也会被删除。Pod 名称和资源名称,连同生成的组件,将用于为 ResourceClaim 形成一个唯一的名称,该名称将记录在 pod.status.resourceClaimStatuses 中。

      此字段是不可变的,并且在创建 ResourceClaim 后,控制平面不会对相应的 ResourceClaim 进行任何更改。

      ResourceClaimName 和 ResourceClaimTemplateName 中必须且只能设置一个。

  • schedulingGates ([]PodSchedulingGate)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

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

    SchedulingGates 只能在 Pod 创建时设置,之后才能删除。

    PodSchedulingGate 与 Pod 相关联,以守护其调度。

    • schedulingGates.name (string), 必需

      调度门的名称。每个调度门必须具有唯一的名称字段。

已弃用

  • serviceAccount (string)

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

容器

您希望在 Pod 中运行的单个应用程序容器。


  • name (string),必需

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

镜像

入口点

  • command ([]string)

    原子性:在合并期间将被替换

    入口点数组。不在 shell 中执行。如果未提供,则使用容器镜像的 ENTRYPOINT。变量引用 $(VAR_NAME) 使用容器的环境进行扩展。如果变量无法解析,则输入字符串中的引用将保持不变。双 $$ 减少为单个 $,这允许转义 $(VAR_NAME) 语法:即,“$$(VAR_NAME)”将生成字符串字面值“$(VAR_NAME)”。转义引用永远不会扩展,无论变量是否存在。无法更新。更多信息:https://kubernetes.ac.cn/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

  • args ([]string)

    原子性:在合并期间将被替换

    入口点的参数。如果未提供,则使用容器镜像的 CMD。变量引用 $(VAR_NAME) 使用容器的环境进行扩展。如果变量无法解析,则输入字符串中的引用将保持不变。双 $$ 减少为单个 $,这允许转义 $(VAR_NAME) 语法:即,“$$(VAR_NAME)”将生成字符串字面值“$(VAR_NAME)”。转义引用永远不会扩展,无论变量是否存在。无法更新。更多信息:https://kubernetes.ac.cn/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

  • workingDir (string)

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

端口

  • ports ([]ContainerPort)

    补丁策略:按键 containerPort 合并

    映射:在合并过程中将保留键 containerPort, protocol 上的唯一值

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

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

    • ports.containerPort (int32), 必需

      要在 Pod 的 IP 地址上公开的端口号。这必须是一个有效的端口号,0 < x < 65536。

    • ports.hostIP (string)

      外部端口要绑定的主机 IP。

    • ports.hostPort (int32)

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

    • ports.name (string)

      如果指定,这必须是 IANA_SVC_NAME,并且在 Pod 中是唯一的。Pod 中的每个命名端口必须具有唯一的名称。可由服务引用的端口名称。

    • ports.protocol (string)

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

环境变量

  • env ([]EnvVar)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

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

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

    • env.name (string), 必填

      环境变量的名称。可包含除“=”以外的任何可打印 ASCII 字符。

    • env.value (string)

      变量引用 $(VAR_NAME) 将使用容器中先前定义的环境变量和任何服务环境变量进行扩展。如果变量无法解析,输入字符串中的引用将保持不变。双 $$ 会减少为单个 $,这允许转义 $(VAR_NAME) 语法:即 "$$(VAR_NAME)" 将生成字符串字面值 "$(VAR_NAME)"。无论变量是否存在,转义引用都不会被扩展。默认为 ""。

    • env.valueFrom (EnvVarSource)

      环境变量值的来源。如果值不为空,则不能使用。

      EnvVarSource 表示 EnvVar 值的来源。

      • env.valueFrom.configMapKeyRef (ConfigMapKeySelector)

        选择 ConfigMap 的键。

        从 ConfigMap 中选择一个键。

        • env.valueFrom.configMapKeyRef.key (string), 必填

          要选择的键。

        • env.valueFrom.configMapKeyRef.name (string)

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

        • env.valueFrom.configMapKeyRef.optional (boolean)

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

      • env.valueFrom.fieldRef (ObjectFieldSelector)

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

      • env.valueFrom.fileKeyRef (FileKeySelector)

        FileKeyRef 选择 env 文件的键。需要启用 EnvFiles 功能门。

        FileKeySelector 选择 env 文件的键。

        • env.valueFrom.fileKeyRef.key (string), 必填

          env 文件中的键。无效的键将阻止 pod 启动。源中定义的键可以由除“=”之外的任何可打印 ASCII 字符组成。在 EnvFiles 功能门的 Alpha 阶段,键大小限制为 128 个字符。

        • env.valueFrom.fileKeyRef.path (string), 必填

          卷中用于选择文件的路径。必须是相对路径,不能包含“..”路径或以“..”开头。

        • env.valueFrom.fileKeyRef.volumeName (string), 必填

          包含 env 文件的卷挂载的名称。

        • env.valueFrom.fileKeyRef.optional (boolean)

          指定文件或其键是否必须定义。如果文件或键不存在,则不发布环境变量。如果 optional 设置为 true 且指定的键不存在,则不会在 Pod 的容器中设置环境变量。

          如果 optional 设置为 false 且指定的键不存在,则在 Pod 创建期间将返回错误。

      • env.valueFrom.resourceFieldRef (ResourceFieldSelector)

        选择容器的资源:目前仅支持资源限制和请求(limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory 和 requests.ephemeral-storage)。

      • env.valueFrom.secretKeyRef (SecretKeySelector)

        选择 pod 命名空间中 Secret 的键。

        SecretKeySelector 选择 Secret 的键。

        • env.valueFrom.secretKeyRef.key (string), 必填

          要从 Secret 中选择的键。必须是有效的 Secret 键。

        • env.valueFrom.secretKeyRef.name (string)

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

        • env.valueFrom.secretKeyRef.optional (boolean)

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

  • envFrom ([]EnvFromSource)

    原子性:在合并期间将被替换

    用于在容器中填充环境变量的源列表。源中定义的键可以由除“=”之外的任何可打印 ASCII 字符组成。当键存在于多个源中时,与最后一个源关联的值将优先。由具有重复键的 Env 定义的值将优先。无法更新。

    EnvFromSource 表示一组 ConfigMap 或 Secret 的源。

    • envFrom.configMapRef (ConfigMapEnvSource)

      要从中选择的 ConfigMap。

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

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

    • envFrom.prefix (string)

      可选文本,添加到每个环境变量名称的前面。可包含除“=”以外的任何可打印 ASCII 字符。

    • envFrom.secretRef (SecretEnvSource)

      要从中选择的 Secret。

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

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

  • volumeMounts ([]VolumeMount)

    补丁策略:按键 mountPath 合并

    映射:合并时将保留 mountPath 键上的唯一值

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

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

    • volumeMounts.mountPath (string), 必填

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

    • volumeMounts.name (string), 必填

      这必须与 Volume 的名称匹配。

    • volumeMounts.mountPropagation (string)

      mountPropagation 决定了挂载如何从主机传播到容器以及反向传播。未设置时,使用 MountPropagationNone。此字段在 1.10 中是 Beta 版。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时,MountPropagation 必须为 None 或未指定(默认为 None)。

    • volumeMounts.readOnly (boolean)

      如果为 true,则挂载为只读;否则(false 或未指定)为读写。默认为 false。

    • volumeMounts.recursiveReadOnly (string)

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

      如果 ReadOnly 为 false,此字段无意义且必须未指定。

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

      如果此字段设置为 IfPossible 或 Enabled,MountPropagation 必须设置为 None(或未指定,默认为 None)。

      如果未指定此字段,则将其视为 Disabled 的等效项。

    • volumeMounts.subPath (string)

      容器卷应从其挂载的卷内路径。默认为 ""(卷的根)。

    • volumeMounts.subPathExpr (string)

      容器卷应从中挂载的卷内的扩展路径。行为类似于 SubPath,但环境变量引用 $(VAR_NAME) 使用容器的环境进行扩展。默认为 ""(卷的根)。SubPathExpr 和 SubPath 互斥。

  • volumeDevices ([]VolumeDevice)

    补丁策略:按键 devicePath 合并

    映射:合并时将保留 devicePath 键上的唯一值

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

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

    • volumeDevices.devicePath (string), 必填

      devicePath 是设备将映射到的容器内的路径。

    • volumeDevices.name (string), 必填

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

资源

  • resources (ResourceRequirements)

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

    ResourceRequirements 描述了计算资源要求。

    • resources.claims ([]ResourceClaim)

      映射:合并时将保留键名上的唯一值

      Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

      此字段依赖于 DynamicResourceAllocation 功能门。

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

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

      • resources.claims.name (string), 必需

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

      • resources.claims.request (string)

        Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

    • resources.limits (map[string]Quantity)

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

    • resources.requests (map[string]Quantity)

      Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

  • resizePolicy ([]ContainerResizePolicy)

    原子性:在合并期间将被替换

    容器的资源调整策略。

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

    • resizePolicy.resourceName (string), 必填

      此资源调整策略适用的资源名称。支持的值:cpu、memory。

    • resizePolicy.restartPolicy (string), 必填

      当指定资源调整大小时应用的重启策略。如果未指定,默认为 NotRequired。

生命周期

  • lifecycle (Lifecycle)

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

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

    • lifecycle.postStart (LifecycleHandler)

      PostStart 在容器创建后立即调用。如果处理程序失败,容器将根据其重启策略终止并重启。容器的其他管理会阻塞,直到钩子完成。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

    • lifecycle.preStop (LifecycleHandler)

      PreStop 在容器因 API 请求或管理事件(例如活性/启动探测失败、抢占、资源争用等)而终止之前立即调用。如果容器崩溃或退出,则不调用处理程序。Pod 的终止宽限期倒计时在 PreStop 钩子执行之前开始。无论处理程序的结果如何,容器最终都将在 Pod 的终止宽限期内终止(除非被终结器延迟)。容器的其他管理会阻塞,直到钩子完成或直到终止宽限期届满。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

    • lifecycle.stopSignal (string)

      StopSignal 定义了当容器停止时将发送到容器的信号。如果未指定,则默认值由所使用的容器运行时定义。StopSignal 只能为 .spec.os.name 不为空的 Pod 设置。

  • terminationMessagePath (string)

    可选:容器终止消息将写入的文件在容器文件系统中的挂载路径。写入的消息旨在简要说明最终状态,例如断言失败消息。如果大于 4096 字节,将被节点截断。所有容器的总消息长度将限制为 12KB。默认为 /dev/termination-log。无法更新。

  • terminationMessagePolicy (string)

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

  • livenessProbe (Probe)

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

  • readinessProbe (Probe)

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

  • startupProbe (Probe)

    StartupProbe 表示 Pod 已成功初始化。如果指定,在成功完成之前不会执行其他探测。如果此探测失败,Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数(此时可能需要很长时间才能加载数据或预热缓存),而不是在稳定状态操作期间。无法更新。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#container-probes

  • restartPolicy (string)

    RestartPolicy 定义了 Pod 中单个容器的重启行为。这将覆盖 Pod 级别的重启策略。当未指定此字段时,重启行为由 Pod 的重启策略和容器类型定义。此外,将 init 容器的 RestartPolicy 设置为 "Always" 将产生以下效果:此 init 容器将不断重启,直到所有常规容器终止。一旦所有常规容器完成,所有具有 restartPolicy "Always" 的 init 容器都将被关闭。此生命周期与普通 init 容器不同,通常被称为“边车”容器。尽管此 init 容器仍按 init 容器顺序启动,但它不会等待容器完成,然后才继续下一个 init 容器。相反,下一个 init 容器在此 init 容器启动后立即开始,或者在任何 startupProbe 成功完成后立即开始。

  • restartPolicyRules ([]ContainerRestartRule)

    原子性:在合并期间将被替换

    表示用于确定容器退出时是否应重启的规则列表。规则按顺序评估。一旦某个规则匹配容器退出条件,其余规则将被忽略。如果没有规则匹配容器退出条件,则由容器级别的重启策略决定容器是否重启。规则的约束: - 最多允许 20 条规则。 - 规则可以有相同的操作。 - 验证中不禁止相同的规则。指定规则时,容器必须显式设置 RestartPolicy,即使它与 Pod 的 RestartPolicy 匹配。

    ContainerRestartRule 描述了如何处理容器退出。

    • restartPolicyRules.action (string), 必填

      指定如果满足要求,容器退出时采取的操作。唯一可能的值是“Restart”以重启容器。

    • restartPolicyRules.exitCodes (ContainerRestartRuleOnExitCodes)

      表示容器退出时要检查的退出代码。

      ContainerRestartRuleOnExitCodes 描述了根据容器退出代码处理退出容器的条件。

      • restartPolicyRules.exitCodes.operator (string), 必填

        表示容器退出代码与指定值之间的关系。可能的值为: - In:如果容器退出代码在指定值集中,则满足要求。

        • NotIn:如果容器退出代码不在指定值集中,则满足要求。
      • restartPolicyRules.exitCodes.values ([]int32)

        Set: 合并时将保留唯一值

        指定要检查容器退出代码的值集。最多允许 255 个元素。

安全上下文

  • securityContext (SecurityContext)

    SecurityContext 定义了容器应运行的安全选项。如果设置,SecurityContext 的字段将覆盖 PodSecurityContext 的等效字段。更多信息:https://kubernetes.ac.cn/docs/tasks/configure-pod-container/security-context/

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

    • securityContext.allowPrivilegeEscalation (boolean)

      AllowPrivilegeEscalation 控制进程是否可以获得比其父进程更多的权限。此布尔值直接控制是否在容器进程上设置 no_new_privs 标志。当容器满足以下条件时,AllowPrivilegeEscalation 始终为 true: 1) 以特权模式运行 2) 具有 CAP_SYS_ADMIN 请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.appArmorProfile (AppArmorProfile)

      appArmorProfile 是此容器要使用的 AppArmor 选项。如果设置,此配置文件将覆盖 Pod 的 appArmorProfile。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      AppArmorProfile 定义 Pod 或容器的 AppArmor 设置。

      • securityContext.appArmorProfile.type (string), 必需

        type 指示将应用哪种 AppArmor 配置文件。有效选项是:Localhost - 节点上预加载的配置文件。RuntimeDefault - 容器运行时的默认配置文件。Unconfined - 不强制执行 AppArmor。

      • securityContext.appArmorProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上加载的配置文件。该配置文件必须预先配置在节点上才能工作。必须与加载的配置文件名称匹配。当且仅当 type 为“Localhost”时必须设置。

    • securityContext.capabilities (Capabilities)

      运行容器时要添加/删除的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

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

      • securityContext.capabilities.add ([]string)

        原子性:在合并期间将被替换

        添加的功能

      • securityContext.capabilities.drop ([]string)

        原子性:在合并期间将被替换

        删除的功能

    • securityContext.procMount (string)

      procMount 表示容器要使用的 proc 挂载类型。默认值为 Default,它使用容器运行时默认的只读路径和掩码路径。这需要启用 ProcMountType 功能标志。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.privileged (boolean)

      以特权模式运行容器。特权容器中的进程本质上与主机上的 root 等效。默认为 false。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.readOnlyRootFilesystem (boolean)

      此容器是否具有只读根文件系统。默认值为 false。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.runAsUser (int64)

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

    • securityContext.runAsNonRoot (boolean)

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

    • securityContext.runAsGroup (int64)

      运行容器进程入口点的 GID。如果未设置,则使用运行时默认值。也可在 PodSecurityContext 中设置。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.seLinuxOptions (SELinuxOptions)

      应用于容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机的 SELinux 上下文。也可在 PodSecurityContext 中设置。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      SELinuxOptions 是要应用于容器的标签

      • securityContext.seLinuxOptions.level (string)

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

      • securityContext.seLinuxOptions.role (string)

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

      • securityContext.seLinuxOptions.type (string)

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

      • securityContext.seLinuxOptions.user (string)

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

    • securityContext.seccompProfile (SeccompProfile)

      此容器要使用的 seccomp 选项。如果在 Pod 和容器级别都提供了 seccomp 选项,则容器选项将覆盖 Pod 选项。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      SeccompProfile 定义 Pod/容器的 seccomp 配置文件设置。只能设置一个配置文件源。

      • securityContext.seccompProfile.type (string), 必需

        type 指示将应用哪种 seccomp 配置文件。有效选项是

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

      • securityContext.seccompProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上文件中定义的配置文件。该配置文件必须预先配置在节点上才能工作。必须是相对 kubelet 配置的 seccomp 配置文件位置的递减路径。当 type 为“Localhost”时必须设置。对于任何其他类型,不得设置。

    • securityContext.windowsOptions (WindowsSecurityContextOptions)

      应用于所有容器的 Windows 特定设置。如果未指定,将使用 PodSecurityContext 中的选项。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 linux 时,不能设置此字段。

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

      • securityContext.windowsOptions.gmsaCredentialSpec (string)

        GMSACredentialSpec 是 GMSA 准入 webhook (https://github.com/kubernetes-sigs/windows-gmsa) 内联由 GMSACredentialSpecName 字段命名的 GMSA 凭据规范内容的位置。

      • securityContext.windowsOptions.gmsaCredentialSpecName (string)

        GMSACredentialSpecName 是要使用的 GMSA 凭据规范的名称。

      • securityContext.windowsOptions.hostProcess (boolean)

        HostProcess 决定容器是否应作为“主机进程”容器运行。Pod 的所有容器必须具有相同的有效 HostProcess 值(不允许混合使用 HostProcess 容器和非 HostProcess 容器)。此外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。

      • securityContext.windowsOptions.runAsUserName (string)

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

调试

  • stdin (boolean)

    此容器是否应在容器运行时中为 stdin 分配缓冲区。如果未设置此项,容器中对 stdin 的读取将始终导致 EOF。默认为 false。

  • stdinOnce (boolean)

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

  • tty (boolean)

    此容器是否应为自己分配 TTY,也需要将“stdin”设置为 true。默认为 false。

临时容器

EphemeralContainer 是一种临时容器,您可以将其添加到现有 Pod 中以进行用户启动的活动,例如调试。临时容器没有资源或调度保证,当它们退出或 Pod 被移除或重启时,它们不会被重启。如果临时容器导致 Pod 超出其资源分配,kubelet 可能会驱逐 Pod。

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


  • name (string),必需

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

  • targetContainerName (string)

    如果设置,此临时容器所针对的 PodSpec 中容器的名称。临时容器将在此容器的命名空间(IPC、PID 等)中运行。如果未设置,则临时容器使用 Pod 规范中配置的命名空间。

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

镜像

入口点

  • command ([]string)

    原子性:在合并期间将被替换

    入口点数组。不在 shell 中执行。如果未提供,则使用镜像的 ENTRYPOINT。变量引用 $(VAR_NAME) 使用容器的环境进行扩展。如果变量无法解析,输入字符串中的引用将保持不变。双 $$ 会减少为单个 $,这允许转义 $(VAR_NAME) 语法:即 "$$(VAR_NAME)" 将生成字符串字面值 "$(VAR_NAME)"。无论变量是否存在,转义引用都不会被扩展。无法更新。更多信息:https://kubernetes.ac.cn/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

  • args ([]string)

    原子性:在合并期间将被替换

    入口点的参数。如果未提供,则使用镜像的 CMD。变量引用 $(VAR_NAME) 使用容器的环境进行扩展。如果变量无法解析,输入字符串中的引用将保持不变。双 $$ 会减少为单个 $,这允许转义 $(VAR_NAME) 语法:即 "$$(VAR_NAME)" 将生成字符串字面值 "$(VAR_NAME)"。无论变量是否存在,转义引用都不会被扩展。无法更新。更多信息:https://kubernetes.ac.cn/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

  • workingDir (string)

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

环境变量

  • env ([]EnvVar)

    补丁策略:在键 name 上合并

    映射:合并时将保留键名上的唯一值

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

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

    • env.name (string), 必填

      环境变量的名称。可包含除“=”以外的任何可打印 ASCII 字符。

    • env.value (string)

      变量引用 $(VAR_NAME) 将使用容器中先前定义的环境变量和任何服务环境变量进行扩展。如果变量无法解析,输入字符串中的引用将保持不变。双 $$ 会减少为单个 $,这允许转义 $(VAR_NAME) 语法:即 "$$(VAR_NAME)" 将生成字符串字面值 "$(VAR_NAME)"。无论变量是否存在,转义引用都不会被扩展。默认为 ""。

    • env.valueFrom (EnvVarSource)

      环境变量值的来源。如果值不为空,则不能使用。

      EnvVarSource 表示 EnvVar 值的来源。

      • env.valueFrom.configMapKeyRef (ConfigMapKeySelector)

        选择 ConfigMap 的键。

        从 ConfigMap 中选择一个键。

        • env.valueFrom.configMapKeyRef.key (string), 必填

          要选择的键。

        • env.valueFrom.configMapKeyRef.name (string)

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

        • env.valueFrom.configMapKeyRef.optional (boolean)

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

      • env.valueFrom.fieldRef (ObjectFieldSelector)

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

      • env.valueFrom.fileKeyRef (FileKeySelector)

        FileKeyRef 选择 env 文件的键。需要启用 EnvFiles 功能门。

        FileKeySelector 选择 env 文件的键。

        • env.valueFrom.fileKeyRef.key (string), 必填

          env 文件中的键。无效的键将阻止 pod 启动。源中定义的键可以由除“=”之外的任何可打印 ASCII 字符组成。在 EnvFiles 功能门的 Alpha 阶段,键大小限制为 128 个字符。

        • env.valueFrom.fileKeyRef.path (string), 必填

          卷中用于选择文件的路径。必须是相对路径,不能包含“..”路径或以“..”开头。

        • env.valueFrom.fileKeyRef.volumeName (string), 必填

          包含 env 文件的卷挂载的名称。

        • env.valueFrom.fileKeyRef.optional (boolean)

          指定文件或其键是否必须定义。如果文件或键不存在,则不发布环境变量。如果 optional 设置为 true 且指定的键不存在,则不会在 Pod 的容器中设置环境变量。

          如果 optional 设置为 false 且指定的键不存在,则在 Pod 创建期间将返回错误。

      • env.valueFrom.resourceFieldRef (ResourceFieldSelector)

        选择容器的资源:目前仅支持资源限制和请求(limits.cpu、limits.memory、limits.ephemeral-storage、requests.cpu、requests.memory 和 requests.ephemeral-storage)。

      • env.valueFrom.secretKeyRef (SecretKeySelector)

        选择 pod 命名空间中 Secret 的键。

        SecretKeySelector 选择 Secret 的键。

        • env.valueFrom.secretKeyRef.key (string), 必填

          要从 Secret 中选择的键。必须是有效的 Secret 键。

        • env.valueFrom.secretKeyRef.name (string)

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

        • env.valueFrom.secretKeyRef.optional (boolean)

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

  • envFrom ([]EnvFromSource)

    原子性:在合并期间将被替换

    用于在容器中填充环境变量的源列表。源中定义的键可以由除“=”之外的任何可打印 ASCII 字符组成。当键存在于多个源中时,与最后一个源关联的值将优先。由具有重复键的 Env 定义的值将优先。无法更新。

    EnvFromSource 表示一组 ConfigMap 或 Secret 的源。

    • envFrom.configMapRef (ConfigMapEnvSource)

      要从中选择的 ConfigMap。

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

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

    • envFrom.prefix (string)

      可选文本,添加到每个环境变量名称的前面。可包含除“=”以外的任何可打印 ASCII 字符。

    • envFrom.secretRef (SecretEnvSource)

      要从中选择的 Secret。

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

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

  • volumeMounts ([]VolumeMount)

    补丁策略:按键 mountPath 合并

    映射:合并时将保留 mountPath 键上的唯一值

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

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

    • volumeMounts.mountPath (string), 必填

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

    • volumeMounts.name (string), 必填

      这必须与 Volume 的名称匹配。

    • volumeMounts.mountPropagation (string)

      mountPropagation 决定了挂载如何从主机传播到容器以及反向传播。未设置时,使用 MountPropagationNone。此字段在 1.10 中是 Beta 版。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时,MountPropagation 必须为 None 或未指定(默认为 None)。

    • volumeMounts.readOnly (boolean)

      如果为 true,则挂载为只读;否则(false 或未指定)为读写。默认为 false。

    • volumeMounts.recursiveReadOnly (string)

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

      如果 ReadOnly 为 false,此字段无意义且必须未指定。

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

      如果此字段设置为 IfPossible 或 Enabled,MountPropagation 必须设置为 None(或未指定,默认为 None)。

      如果未指定此字段,则将其视为 Disabled 的等效项。

    • volumeMounts.subPath (string)

      容器卷应从其挂载的卷内路径。默认为 ""(卷的根)。

    • volumeMounts.subPathExpr (string)

      容器卷应从中挂载的卷内的扩展路径。行为类似于 SubPath,但环境变量引用 $(VAR_NAME) 使用容器的环境进行扩展。默认为 ""(卷的根)。SubPathExpr 和 SubPath 互斥。

  • volumeDevices ([]VolumeDevice)

    补丁策略:按键 devicePath 合并

    映射:合并时将保留 devicePath 键上的唯一值

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

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

    • volumeDevices.devicePath (string), 必填

      devicePath 是设备将映射到的容器内的路径。

    • volumeDevices.name (string), 必填

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

资源

  • resizePolicy ([]ContainerResizePolicy)

    原子性:在合并期间将被替换

    容器的资源调整策略。

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

    • resizePolicy.resourceName (string), 必填

      此资源调整策略适用的资源名称。支持的值:cpu、memory。

    • resizePolicy.restartPolicy (string), 必填

      当指定资源调整大小时应用的重启策略。如果未指定,默认为 NotRequired。

生命周期

  • terminationMessagePath (string)

    可选:容器终止消息将写入的文件在容器文件系统中的挂载路径。写入的消息旨在简要说明最终状态,例如断言失败消息。如果大于 4096 字节,将被节点截断。所有容器的总消息长度将限制为 12KB。默认为 /dev/termination-log。无法更新。

  • terminationMessagePolicy (string)

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

  • restartPolicy (string)

    容器的重启策略,用于管理 Pod 中每个容器的重启行为。您不能在临时容器上设置此字段。

  • restartPolicyRules ([]ContainerRestartRule)

    原子性:在合并期间将被替换

    表示用于确定容器退出时是否应重启的规则列表。您不能在临时容器上设置此字段。

    ContainerRestartRule 描述了如何处理容器退出。

    • restartPolicyRules.action (string), 必填

      指定如果满足要求,容器退出时采取的操作。唯一可能的值是“Restart”以重启容器。

    • restartPolicyRules.exitCodes (ContainerRestartRuleOnExitCodes)

      表示容器退出时要检查的退出代码。

      ContainerRestartRuleOnExitCodes 描述了根据容器退出代码处理退出容器的条件。

      • restartPolicyRules.exitCodes.operator (string), 必填

        表示容器退出代码与指定值之间的关系。可能的值为: - In:如果容器退出代码在指定值集中,则满足要求。

        • NotIn:如果容器退出代码不在指定值集中,则满足要求。
      • restartPolicyRules.exitCodes.values ([]int32)

        Set: 合并时将保留唯一值

        指定要检查容器退出代码的值集。最多允许 255 个元素。

调试

  • stdin (boolean)

    此容器是否应在容器运行时中为 stdin 分配缓冲区。如果未设置此项,容器中对 stdin 的读取将始终导致 EOF。默认为 false。

  • stdinOnce (boolean)

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

  • tty (boolean)

    此容器是否应为自己分配 TTY,也需要将“stdin”设置为 true。默认为 false。

安全上下文

  • securityContext (SecurityContext)

    可选:SecurityContext 定义了临时容器应运行的安全选项。如果设置,SecurityContext 的字段将覆盖 PodSecurityContext 的等效字段。

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

    • securityContext.allowPrivilegeEscalation (boolean)

      AllowPrivilegeEscalation 控制进程是否可以获得比其父进程更多的权限。此布尔值直接控制是否在容器进程上设置 no_new_privs 标志。当容器满足以下条件时,AllowPrivilegeEscalation 始终为 true: 1) 以特权模式运行 2) 具有 CAP_SYS_ADMIN 请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.appArmorProfile (AppArmorProfile)

      appArmorProfile 是此容器要使用的 AppArmor 选项。如果设置,此配置文件将覆盖 Pod 的 appArmorProfile。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      AppArmorProfile 定义 Pod 或容器的 AppArmor 设置。

      • securityContext.appArmorProfile.type (string), 必需

        type 指示将应用哪种 AppArmor 配置文件。有效选项是:Localhost - 节点上预加载的配置文件。RuntimeDefault - 容器运行时的默认配置文件。Unconfined - 不强制执行 AppArmor。

      • securityContext.appArmorProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上加载的配置文件。该配置文件必须预先配置在节点上才能工作。必须与加载的配置文件名称匹配。当且仅当 type 为“Localhost”时必须设置。

    • securityContext.capabilities (Capabilities)

      运行容器时要添加/删除的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

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

      • securityContext.capabilities.add ([]string)

        原子性:在合并期间将被替换

        添加的功能

      • securityContext.capabilities.drop ([]string)

        原子性:在合并期间将被替换

        删除的功能

    • securityContext.procMount (string)

      procMount 表示容器要使用的 proc 挂载类型。默认值为 Default,它使用容器运行时默认的只读路径和掩码路径。这需要启用 ProcMountType 功能标志。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.privileged (boolean)

      以特权模式运行容器。特权容器中的进程本质上与主机上的 root 等效。默认为 false。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.readOnlyRootFilesystem (boolean)

      此容器是否具有只读根文件系统。默认值为 false。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.runAsUser (int64)

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

    • securityContext.runAsNonRoot (boolean)

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

    • securityContext.runAsGroup (int64)

      运行容器进程入口点的 GID。如果未设置,则使用运行时默认值。也可在 PodSecurityContext 中设置。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

    • securityContext.seLinuxOptions (SELinuxOptions)

      应用于容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机的 SELinux 上下文。也可在 PodSecurityContext 中设置。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      SELinuxOptions 是要应用于容器的标签

      • securityContext.seLinuxOptions.level (string)

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

      • securityContext.seLinuxOptions.role (string)

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

      • securityContext.seLinuxOptions.type (string)

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

      • securityContext.seLinuxOptions.user (string)

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

    • securityContext.seccompProfile (SeccompProfile)

      此容器要使用的 seccomp 选项。如果在 Pod 和容器级别都提供了 seccomp 选项,则容器选项将覆盖 Pod 选项。请注意,当 spec.os.name 为 windows 时,不能设置此字段。

      SeccompProfile 定义 Pod/容器的 seccomp 配置文件设置。只能设置一个配置文件源。

      • securityContext.seccompProfile.type (string), 必需

        type 指示将应用哪种 seccomp 配置文件。有效选项是

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

      • securityContext.seccompProfile.localhostProfile (string)

        localhostProfile 指示应使用节点上文件中定义的配置文件。该配置文件必须预先配置在节点上才能工作。必须是相对 kubelet 配置的 seccomp 配置文件位置的递减路径。当 type 为“Localhost”时必须设置。对于任何其他类型,不得设置。

    • securityContext.windowsOptions (WindowsSecurityContextOptions)

      应用于所有容器的 Windows 特定设置。如果未指定,将使用 PodSecurityContext 中的选项。如果 SecurityContext 和 PodSecurityContext 中都设置,则 SecurityContext 中指定的值优先。请注意,当 spec.os.name 为 linux 时,不能设置此字段。

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

      • securityContext.windowsOptions.gmsaCredentialSpec (string)

        GMSACredentialSpec 是 GMSA 准入 webhook (https://github.com/kubernetes-sigs/windows-gmsa) 内联由 GMSACredentialSpecName 字段命名的 GMSA 凭据规范内容的位置。

      • securityContext.windowsOptions.gmsaCredentialSpecName (string)

        GMSACredentialSpecName 是要使用的 GMSA 凭据规范的名称。

      • securityContext.windowsOptions.hostProcess (boolean)

        HostProcess 决定容器是否应作为“主机进程”容器运行。Pod 的所有容器必须具有相同的有效 HostProcess 值(不允许混合使用 HostProcess 容器和非 HostProcess 容器)。此外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。

      • securityContext.windowsOptions.runAsUserName (string)

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

不允许

  • ports ([]ContainerPort)

    补丁策略:按键 containerPort 合并

    映射:在合并过程中将保留键 containerPort, protocol 上的唯一值

    临时容器不允许端口。

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

    • ports.containerPort (int32), 必需

      要在 Pod 的 IP 地址上公开的端口号。这必须是一个有效的端口号,0 < x < 65536。

    • ports.hostIP (string)

      外部端口要绑定的主机 IP。

    • ports.hostPort (int32)

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

    • ports.name (string)

      如果指定,这必须是 IANA_SVC_NAME,并且在 Pod 中是唯一的。Pod 中的每个命名端口必须具有唯一的名称。可由服务引用的端口名称。

    • ports.protocol (string)

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

  • resources (ResourceRequirements)

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

    ResourceRequirements 描述了计算资源要求。

    • resources.claims ([]ResourceClaim)

      映射:合并时将保留键名上的唯一值

      Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

      此字段依赖于 DynamicResourceAllocation 功能门。

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

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

      • resources.claims.name (string), 必需

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

      • resources.claims.request (string)

        Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

    • resources.limits (map[string]Quantity)

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

    • resources.requests (map[string]Quantity)

      Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

  • lifecycle (Lifecycle)

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

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

    • lifecycle.postStart (LifecycleHandler)

      PostStart 在容器创建后立即调用。如果处理程序失败,容器将根据其重启策略终止并重启。容器的其他管理会阻塞,直到钩子完成。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

    • lifecycle.preStop (LifecycleHandler)

      PreStop 在容器因 API 请求或管理事件(例如活性/启动探测失败、抢占、资源争用等)而终止之前立即调用。如果容器崩溃或退出,则不调用处理程序。Pod 的终止宽限期倒计时在 PreStop 钩子执行之前开始。无论处理程序的结果如何,容器最终都将在 Pod 的终止宽限期内终止(除非被终结器延迟)。容器的其他管理会阻塞,直到钩子完成或直到终止宽限期届满。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

    • lifecycle.stopSignal (string)

      StopSignal 定义了当容器停止时将发送到容器的信号。如果未指定,则默认值由所使用的容器运行时定义。StopSignal 只能为 .spec.os.name 不为空的 Pod 设置。

  • livenessProbe (Probe)

    临时容器不允许探测。

  • readinessProbe (Probe)

    临时容器不允许探测。

  • startupProbe (Probe)

    临时容器不允许探测。

生命周期处理程序

LifecycleHandler 定义了在生命周期钩子中应采取的特定操作。除了 TCPSocket 之外,必须且只能指定其中一个字段。


  • exec (ExecAction)

    Exec 指定要在容器中执行的命令。

    ExecAction 描述了一个“在容器中运行”操作。

    • exec.command ([]string)

      原子性:在合并期间将被替换

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

  • httpGet (HTTPGetAction)

    HTTPGet 指定要执行的 HTTP GET 请求。

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

    • httpGet.port (IntOrString), 必填

      要访问容器上的端口名称或编号。编号必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

      IntOrString 是一种可以包含 int32 或字符串的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。这允许您例如有一个 JSON 字段可以接受名称或数字。

    • httpGet.host (string)

      要连接的主机名,默认为 Pod IP。您可能希望在 httpHeaders 中设置“Host”。

    • httpGet.httpHeaders ([]HTTPHeader)

      原子性:在合并期间将被替换

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

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

      • httpGet.httpHeaders.name (string), 必填

        标头字段名称。这将在输出时规范化,因此大小写不同的名称将被理解为相同的标头。

      • httpGet.httpHeaders.value (string), 必填

        标头字段值。

    • httpGet.path (string)

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

    • httpGet.scheme (string)

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

  • sleep (SleepAction)

    Sleep 表示容器应休眠的持续时间。

    SleepAction 描述了一个“休眠”操作。

    • sleep.seconds (int64), 必填

      Seconds 是要休眠的秒数。

  • tcpSocket (TCPSocketAction)

    已废弃。TCPSocket 不支持作为 LifecycleHandler,并保留用于向后兼容性。此字段没有验证,指定时生命周期钩子将在运行时失败。

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

    • tcpSocket.port (IntOrString), 必填

      要访问容器上的端口编号或名称。编号必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

      IntOrString 是一种可以包含 int32 或字符串的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。这允许您例如有一个 JSON 字段可以接受名称或数字。

    • tcpSocket.host (string)

      可选:要连接的主机名,默认为 Pod IP。

节点亲和性

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


  • preferredDuringSchedulingIgnoredDuringExecution ([]PreferredSchedulingTerm)

    原子性:在合并期间将被替换

    调度器将优先将 Pod 调度到满足此字段指定的亲和性表达式的节点,但它可能会选择一个违反一个或多个表达式的节点。最优先的节点是权重总和最大的节点,即对于满足所有调度要求(资源请求、requiredDuringScheduling 亲和性表达式等)的每个节点,通过遍历此字段的元素并在此节点与相应的 matchExpressions 匹配时将“weight”添加到总和中来计算总和;总和最高的节点是最优先的。

    空的 preferred scheduling term 匹配所有隐式权重为 0 的对象(即,它是一个无操作)。null 的 preferred scheduling term 不匹配任何对象(即,也是一个无操作)。

    • preferredDuringSchedulingIgnoredDuringExecution.preference (NodeSelectorTerm), 必填

      节点选择器项,与相应的权重关联。

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

      • preferredDuringSchedulingIgnoredDuringExecution.preference.matchExpressions ([]NodeSelectorRequirement)

        原子性:在合并期间将被替换

        通过节点标签列出的节点选择器要求列表。

      • preferredDuringSchedulingIgnoredDuringExecution.preference.matchFields ([]NodeSelectorRequirement)

        原子性:在合并期间将被替换

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

    • preferredDuringSchedulingIgnoredDuringExecution.weight (int32), 必填

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

  • requiredDuringSchedulingIgnoredDuringExecution (NodeSelector)

    如果在调度时未满足此字段指定的亲和性要求,则 Pod 将不会调度到该节点。如果此字段指定的亲和性要求在 Pod 执行期间的某个时间点不再满足(例如,由于更新),系统可能会或可能不会尝试最终将 Pod 从其节点驱逐。

    节点选择器表示一个或多个标签查询在一组节点上的结果的并集;也就是说,它表示节点选择器项所表示的选择器的 OR 运算。

    • requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms ([]NodeSelectorTerm), 必填

      原子性:在合并期间将被替换

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

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

      • requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)

        原子性:在合并期间将被替换

        通过节点标签列出的节点选择器要求列表。

      • requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)

        原子性:在合并期间将被替换

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

Pod 亲和性

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


  • preferredDuringSchedulingIgnoredDuringExecution ([]WeightedPodAffinityTerm)

    原子性:在合并期间将被替换

    调度器将优先将 Pod 调度到满足此字段指定的亲和性表达式的节点,但它可能会选择一个违反一个或多个表达式的节点。最优先的节点是权重总和最大的节点,即对于满足所有调度要求(资源请求、requiredDuringScheduling 亲和性表达式等)的每个节点,通过遍历此字段的元素并在该节点包含与相应 podAffinityTerm 匹配的 Pod 时将“weight”添加到总和中来计算总和;总和最高的节点是最优先的。

    所有匹配的 WeightedPodAffinityTerm 字段的权重按节点累加,以找到最优先的节点。

    • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm (PodAffinityTerm), 必填

      必填。一个 Pod 亲和性项,与相应的权重关联。

      定义一组 Pod(即与给定命名空间相关的 labelSelector 匹配的那些 Pod),此 Pod 应与它们共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行该组 Pod 的任何节点上的 label 键为 的值匹配的节点上。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.topologyKey (string), 必填

        此 Pod 应与指定命名空间中匹配 labelSelector 的 Pod 共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行任何选定 Pod 的任何节点上的键为 topologyKey 的标签值匹配的节点上。不允许空的 topologyKey。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector (LabelSelector)

        对一组资源(在此情况下是 Pod)的标签查询。如果为空,此 PodAffinityTerm 不匹配任何 Pod。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.matchLabelKeys ([]string)

        原子性:在合并期间将被替换

        MatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key in (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 matchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 matchLabelKeys。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.mismatchLabelKeys ([]string)

        原子性:在合并期间将被替换

        MismatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key notin (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 mismatchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 mismatchLabelKeys。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector (LabelSelector)

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

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaces ([]string)

        原子性:在合并期间将被替换

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

    • preferredDuringSchedulingIgnoredDuringExecution.weight (int32), 必填

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

  • requiredDuringSchedulingIgnoredDuringExecution ([]PodAffinityTerm)

    原子性:在合并期间将被替换

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

    定义一组 Pod(即与给定命名空间相关的 labelSelector 匹配的那些 Pod),此 Pod 应与它们共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行该组 Pod 的任何节点上的 label 键为 的值匹配的节点上。

    • requiredDuringSchedulingIgnoredDuringExecution.topologyKey (string), 必填

      此 Pod 应与指定命名空间中匹配 labelSelector 的 Pod 共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行任何选定 Pod 的任何节点上的键为 topologyKey 的标签值匹配的节点上。不允许空的 topologyKey。

    • requiredDuringSchedulingIgnoredDuringExecution.labelSelector (LabelSelector)

      对一组资源(在此情况下是 Pod)的标签查询。如果为空,此 PodAffinityTerm 不匹配任何 Pod。

    • requiredDuringSchedulingIgnoredDuringExecution.matchLabelKeys ([]string)

      原子性:在合并期间将被替换

      MatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key in (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 matchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 matchLabelKeys。

    • requiredDuringSchedulingIgnoredDuringExecution.mismatchLabelKeys ([]string)

      原子性:在合并期间将被替换

      MismatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key notin (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 mismatchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 mismatchLabelKeys。

    • requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector (LabelSelector)

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

    • requiredDuringSchedulingIgnoredDuringExecution.namespaces ([]string)

      原子性:在合并期间将被替换

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

Pod 反亲和性

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


  • preferredDuringSchedulingIgnoredDuringExecution ([]WeightedPodAffinityTerm)

    原子性:在合并期间将被替换

    调度器将优先将 Pod 调度到满足此字段指定的反亲和性表达式的节点,但它可能会选择一个违反一个或多个表达式的节点。最优先的节点是权重总和最大的节点,即对于满足所有调度要求(资源请求、requiredDuringScheduling 反亲和性表达式等)的每个节点,通过遍历此字段的元素并在该节点包含与相应 podAffinityTerm 匹配的 Pod 时从总和中减去“weight”来计算总和;总和最高的节点是最优先的。

    所有匹配的 WeightedPodAffinityTerm 字段的权重按节点累加,以找到最优先的节点。

    • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm (PodAffinityTerm), 必填

      必填。一个 Pod 亲和性项,与相应的权重关联。

      定义一组 Pod(即与给定命名空间相关的 labelSelector 匹配的那些 Pod),此 Pod 应与它们共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行该组 Pod 的任何节点上的 label 键为 的值匹配的节点上。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.topologyKey (string), 必填

        此 Pod 应与指定命名空间中匹配 labelSelector 的 Pod 共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行任何选定 Pod 的任何节点上的键为 topologyKey 的标签值匹配的节点上。不允许空的 topologyKey。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.labelSelector (LabelSelector)

        对一组资源(在此情况下是 Pod)的标签查询。如果为空,此 PodAffinityTerm 不匹配任何 Pod。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.matchLabelKeys ([]string)

        原子性:在合并期间将被替换

        MatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key in (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 matchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 matchLabelKeys。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.mismatchLabelKeys ([]string)

        原子性:在合并期间将被替换

        MismatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key notin (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 mismatchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 mismatchLabelKeys。

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaceSelector (LabelSelector)

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

      • preferredDuringSchedulingIgnoredDuringExecution.podAffinityTerm.namespaces ([]string)

        原子性:在合并期间将被替换

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

    • preferredDuringSchedulingIgnoredDuringExecution.weight (int32), 必填

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

  • requiredDuringSchedulingIgnoredDuringExecution ([]PodAffinityTerm)

    原子性:在合并期间将被替换

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

    定义一组 Pod(即与给定命名空间相关的 labelSelector 匹配的那些 Pod),此 Pod 应与它们共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行该组 Pod 的任何节点上的 label 键为 的值匹配的节点上。

    • requiredDuringSchedulingIgnoredDuringExecution.topologyKey (string), 必填

      此 Pod 应与指定命名空间中匹配 labelSelector 的 Pod 共同定位(亲和性)或不共同定位(反亲和性),其中共同定位定义为运行在与运行任何选定 Pod 的任何节点上的键为 topologyKey 的标签值匹配的节点上。不允许空的 topologyKey。

    • requiredDuringSchedulingIgnoredDuringExecution.labelSelector (LabelSelector)

      对一组资源(在此情况下是 Pod)的标签查询。如果为空,此 PodAffinityTerm 不匹配任何 Pod。

    • requiredDuringSchedulingIgnoredDuringExecution.matchLabelKeys ([]string)

      原子性:在合并期间将被替换

      MatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key in (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 matchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 matchLabelKeys。

    • requiredDuringSchedulingIgnoredDuringExecution.mismatchLabelKeys ([]string)

      原子性:在合并期间将被替换

      MismatchLabelKeys 是一组 Pod 标签键,用于选择将考虑哪些 Pod。这些键用于从传入 Pod 标签中查找值,这些键值标签与 labelSelector 合并为 key notin (value),以选择一组现有 Pod,这些 Pod 将被考虑用于传入 Pod 的 Pod (反)亲和性。传入 Pod 标签中不存在的键将被忽略。默认值为空。在 mismatchLabelKeys 和 labelSelector 中禁止存在相同的键。此外,当 labelSelector 未设置时,不能设置 mismatchLabelKeys。

    • requiredDuringSchedulingIgnoredDuringExecution.namespaceSelector (LabelSelector)

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

    • requiredDuringSchedulingIgnoredDuringExecution.namespaces ([]string)

      原子性:在合并期间将被替换

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

探测

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


  • exec (ExecAction)

    Exec 指定要在容器中执行的命令。

    ExecAction 描述了一个“在容器中运行”操作。

    • exec.command ([]string)

      原子性:在合并期间将被替换

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

  • httpGet (HTTPGetAction)

    HTTPGet 指定要执行的 HTTP GET 请求。

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

    • httpGet.port (IntOrString), 必填

      要访问容器上的端口名称或编号。编号必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

      IntOrString 是一种可以包含 int32 或字符串的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。这允许您例如有一个 JSON 字段可以接受名称或数字。

    • httpGet.host (string)

      要连接的主机名,默认为 Pod IP。您可能希望在 httpHeaders 中设置“Host”。

    • httpGet.httpHeaders ([]HTTPHeader)

      原子性:在合并期间将被替换

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

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

      • httpGet.httpHeaders.name (string), 必填

        标头字段名称。这将在输出时规范化,因此大小写不同的名称将被理解为相同的标头。

      • httpGet.httpHeaders.value (string), 必填

        标头字段值。

    • httpGet.path (string)

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

    • httpGet.scheme (string)

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

  • tcpSocket (TCPSocketAction)

    TCPSocket 指定了到 TCP 端口的连接。

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

    • tcpSocket.port (IntOrString), 必填

      要访问容器上的端口编号或名称。编号必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。

      IntOrString 是一种可以包含 int32 或字符串的类型。在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。这允许您例如有一个 JSON 字段可以接受名称或数字。

    • tcpSocket.host (string)

      可选:要连接的主机名,默认为 Pod IP。

  • initialDelaySeconds (int32)

    容器启动后多久(秒)才开始活性探测。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#container-probes

  • terminationGracePeriodSeconds (int64)

    可选的持续时间(秒),表示 Pod 在探测失败时需要优雅终止。宽限期是指 Pod 中运行的进程被发送终止信号后,到进程被杀信号强制停止之间的时间(秒)。将此值设置得长于进程的预期清理时间。如果此值为 nil,将使用 Pod 的 terminationGracePeriodSeconds。否则,此值将覆盖 Pod 规范提供的值。值必须是非负整数。值为零表示通过杀信号立即停止(没有机会关闭)。这是一个 Beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。最小值为 1。如果未设置,则使用 spec.terminationGracePeriodSeconds。

  • periodSeconds (int32)

    执行探测的频率(秒)。默认为 10 秒。最小值为 1。

  • timeoutSeconds (int32)

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

  • failureThreshold (int32)

    探测在成功后被认为是失败所需的最小连续失败次数。默认为 3。最小值为 1。

  • successThreshold (int32)

    探测在失败后被认为是成功所需的最小连续成功次数。默认为 1。对于活性和启动必须为 1。最小值为 1。

  • grpc (GRPCAction)

    GRPC 指定一个 GRPC HealthCheckRequest。

    GRPCAction 指定了涉及 GRPC 服务的操作。

Pod 状态

PodStatus 表示关于 Pod 状态的信息。状态可能会滞后于系统的实际状态,特别是如果托管 Pod 的节点无法联系控制平面。


  • nominatedNodeName (string)

    nominatedNodeName 仅在 Pod 抢占节点上的其他 Pod 时设置,但由于被抢占的 Pod 收到其优雅终止期,因此无法立即调度。此字段不保证 Pod 将调度到此节点。如果其他节点更早可用,调度器可能会决定将 Pod 放置在其他位置。调度器还可能决定将此节点上的资源分配给抢占后创建的更高优先级 Pod。因此,当 Pod 调度时,此字段可能与 PodSpec.nodeName 不同。

  • hostIP (string)

    hostIP 保存分配给 Pod 的主机的 IP 地址。如果 Pod 尚未启动,则为空。Pod 可以分配给 kubelet 存在问题的节点,这意味着即使节点已分配给 Pod,HostIP 也不会更新。

  • hostIPs ([]HostIP)

    补丁策略:按键 ip 合并

    原子性:在合并期间将被替换

    hostIPs 保存分配给主机的 IP 地址。如果指定此字段,第一个条目必须与 hostIP 字段匹配。如果 Pod 尚未启动,此列表为空。Pod 可以分配给 kubelet 存在问题的节点,这意味着即使节点已分配给此 Pod,HostIPs 也不会更新。

    HostIP 表示分配给主机的单个 IP 地址。

    • hostIPs.ip (string), 必填

      IP 是分配给主机的 IP 地址。

  • startTime (Time)

    Kubelet 确认对象时的 RFC 3339 日期和时间。这发生在 Kubelet 为 Pod 拉取容器镜像之前。

    Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

  • phase (string)

    Pod 的阶段是 Pod 在其生命周期中所在位置的简单、高级摘要。条件数组、原因和消息字段以及单个容器状态数组包含有关 Pod 状态的更多详细信息。有五种可能的阶段值。

    Pending:Pod 已被 Kubernetes 系统接受,但一个或多个容器镜像尚未创建。这包括调度前的时间以及通过网络下载镜像所花费的时间,这可能需要一段时间。Running:Pod 已绑定到节点,并且所有容器都已创建。至少一个容器仍在运行,或者正在启动或重启过程中。Succeeded:Pod 中的所有容器都已成功终止,并且不会重启。Failed:Pod 中的所有容器都已终止,并且至少一个容器已终止失败。容器要么以非零状态退出,要么被系统终止。Unknown:由于某种原因无法获取 Pod 的状态,通常是由于与 Pod 主机通信时发生错误。

    更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#pod-phase

  • message (string)

    人类可读的消息,指示 Pod 处于此状态的详细信息。

  • reason (string)

    简短的 CamelCase 消息,指示 Pod 处于此状态的详细信息。例如“Evicted”。

  • podIP (string)

    分配给 Pod 的 podIP 地址。至少在集群内可路由。如果尚未分配,则为空。

  • podIPs ([]PodIP)

    补丁策略:按键 ip 合并

    映射:在合并过程中将保留键 ip 上的唯一值

    podIPs 保存分配给 Pod 的 IP 地址。如果指定此字段,第 0 个条目必须与 podIP 字段匹配。Pod 最多可以为 IPv4 和 IPv6 各分配 1 个值。如果尚未分配 IP,此列表为空。

    PodIP 表示分配给 Pod 的单个 IP 地址。

    • podIPs.ip (string), 必填

      IP 是分配给 Pod 的 IP 地址。

  • conditions ([]PodCondition)

    补丁策略:按键 type 合并

    映射:合并时将保留键类型上的唯一值

    Pod 的当前服务状态。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

    PodCondition 包含此 Pod 当前状态的详细信息。

    • conditions.status (string),必需

      Status 是条件的状况。可以是 True、False、Unknown。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

    • conditions.type (string),必需

      Type 是条件的类型。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

    • conditions.lastProbeTime (Time)

      上次探测条件的时间。

      Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

    • conditions.lastTransitionTime (Time)

      条件上次从一种状态转换到另一种状态的时间。

      Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

    • conditions.message (string)

      人类可读的消息,指示上次转换的详细信息。

    • conditions.observedGeneration (int64)

      如果设置,这表示 Pod 条件基于的 .metadata.generation。这是一个 Alpha 字段。启用 PodObservedGenerationTracking 才能使用此字段。

    • conditions.reason (string)

      条件的上次转换的唯一、一个单词的 CamelCase 原因。

  • qosClass (string)

    根据资源需求分配给 Pod 的服务质量 (QOS) 分类。有关可用 QOS 类别,请参阅 PodQOSClass 类型。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes

  • initContainerStatuses ([]ContainerStatus)

    原子性:在合并期间将被替换

    此 Pod 中 init 容器的状态。最近成功的非重启 init 容器将 ready = true,最近启动的容器将设置 startTime。Pod 中的每个 init 容器在此列表中应最多有一个状态,并且所有状态都应为 Pod 中的容器。但是,这不强制执行。如果列表中存在不存在容器的状态,或者列表具有重复名称,则各种 Kubernetes 组件的行为未定义,并且这些状态可能会被忽略。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status

    ContainerStatus 包含此容器当前状态的详细信息。

    • initContainerStatuses.allocatedResources (map[string]Quantity)

      AllocatedResources 表示节点为此容器分配的计算资源。Kubelet 在成功 Pod 准入和成功准入所需 Pod 大小调整后,将此值设置为 Container.Resources.Requests。

    • initContainerStatuses.allocatedResourcesStatus ([]ResourceStatus)

      补丁策略:在键 name 上合并

      映射:合并时将保留键名上的唯一值

      AllocatedResourcesStatus 表示为此 Pod 分配的各种资源的状态。

      ResourceStatus 表示分配给 Pod 的单个资源的状态。

      • initContainerStatuses.allocatedResourcesStatus.name (string), 必填

        资源名称。在 Pod 中必须是唯一的,如果是非 DRA 资源,则必须与 Pod 规范中的资源之一匹配。对于 DRA 资源,值必须为“claim:<claim_name>/<request>”。当报告此容器状态时,“claim_name”和“request”必须与此容器的声明之一匹配。

      • initContainerStatuses.allocatedResourcesStatus.resources ([]ResourceHealth)

        映射:合并时将保留 resourceID 键上的唯一值

        唯一资源健康列表。列表中的每个元素都包含一个唯一的资源 ID 及其健康状况。至少在 Pod 的生命周期内,资源 ID 必须唯一标识分配给节点上 Pod 的资源。如果同一节点上的其他 Pod 使用相同的资源 ID 报告状态,则它们必须是共享的相同资源。有关在各种用例中它具有的特定格式,请参见 ResourceID 类型定义。

        ResourceHealth 表示资源的健康状况。它具有最新的设备健康信息。这是 KEP https://kep.k8s.io/4680 的一部分。

        • initContainerStatuses.allocatedResourcesStatus.resources.resourceID (string), 必填

          ResourceID 是资源的唯一标识符。有关更多信息,请参阅 ResourceID 类型。

        • initContainerStatuses.allocatedResourcesStatus.resources.health (string)

          资源健康状况。可以是以下之一:

          • Healthy:正常运行。
          • Unhealthy:报告不健康。我们认为这是一个暂时的健康问题,因为我们今天没有机制来区分暂时性和永久性问题。
          • Unknown:状态无法确定。例如,设备插件已注销且此后未重新注册。

          将来我们可能希望引入 PermanentlyUnhealthy 状态。

    • initContainerStatuses.containerID (string)

      ContainerID 是容器的 ID,格式为 '<type>://<container_id>'。其中 type 是容器运行时标识符,从 CRI API 的 Version 调用返回(例如“containerd”)。

    • initContainerStatuses.image (string), 必填

      Image 是容器正在运行的容器镜像的名称。容器镜像可能与 PodSpec 中使用的镜像不匹配,因为它可能已由运行时解析。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/images

    • initContainerStatuses.imageID (string), 必填

      ImageID 是容器镜像的镜像 ID。镜像 ID 可能与 PodSpec 中使用的镜像的镜像 ID 不匹配,因为它可能已由运行时解析。

    • initContainerStatuses.lastState (ContainerState)

      LastTerminationState 包含容器的最后终止状态,以帮助调试容器崩溃和重启。如果容器仍在运行且 RestartCount 为 0,则不填充此字段。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • initContainerStatuses.lastState.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • initContainerStatuses.lastState.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • initContainerStatuses.lastState.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • initContainerStatuses.lastState.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • initContainerStatuses.lastState.terminated.exitCode (int32), 必填

          容器上次终止的退出状态。

        • initContainerStatuses.lastState.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • initContainerStatuses.lastState.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • initContainerStatuses.lastState.terminated.message (string)

          关于容器上次终止的消息。

        • initContainerStatuses.lastState.terminated.reason (string)

          容器上次终止的(简要)原因。

        • initContainerStatuses.lastState.terminated.signal (int32)

          容器上次终止的信号。

      • initContainerStatuses.lastState.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • initContainerStatuses.lastState.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • initContainerStatuses.lastState.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • initContainerStatuses.name (string), 必填

      Name 是一个 DNS_LABEL,表示容器的唯一名称。Pod 中的每个容器在所有容器类型中都必须具有唯一的名称。无法更新。

    • initContainerStatuses.ready (boolean), 必填

      Ready 指定容器当前是否通过其就绪检查。该值将随着就绪探测的持续执行而改变。如果未指定就绪探测,则一旦容器完全启动(参见 Started 字段),此字段默认为 true。

      该值通常用于确定容器是否已准备好接受流量。

    • initContainerStatuses.resources (ResourceRequirements)

      Resources 表示在容器启动或成功调整大小后,已成功作用于运行中容器的计算资源请求和限制。

      ResourceRequirements 描述了计算资源要求。

      • initContainerStatuses.resources.claims ([]ResourceClaim)

        映射:合并时将保留键名上的唯一值

        Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

        此字段依赖于 DynamicResourceAllocation 功能门。

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

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

        • initContainerStatuses.resources.claims.name (string), 必填

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

        • initContainerStatuses.resources.claims.request (string)

          Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

      • initContainerStatuses.resources.limits (map[string]Quantity)

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

      • initContainerStatuses.resources.requests (map[string]Quantity)

        Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

    • initContainerStatuses.restartCount (int32), 必填

      RestartCount 包含容器已重启的次数。Kubelet 努力始终增加该值,但在节点重启时可能会丢失状态,然后该值可能会重置为 0。该值从不为负。

    • initContainerStatuses.started (boolean)

      Started 指示容器是否已完成其 postStart 生命周期钩子并已通过其启动探测。初始为 false,在启动探测被认为是成功后变为 true。当容器重启或 kubelet 暂时失去状态时重置为 false。在这两种情况下,启动探测将再次运行。当未定义启动探测且容器正在运行并已通过 postStart 生命周期钩子时,始终为 true。空值必须与 false 相同处理。

    • initContainerStatuses.state (ContainerState)

      State 包含关于容器当前状况的详细信息。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • initContainerStatuses.state.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • initContainerStatuses.state.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • initContainerStatuses.state.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • initContainerStatuses.state.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • initContainerStatuses.state.terminated.exitCode (int32), 必填

          容器上次终止的退出状态。

        • initContainerStatuses.state.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • initContainerStatuses.state.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • initContainerStatuses.state.terminated.message (string)

          关于容器上次终止的消息。

        • initContainerStatuses.state.terminated.reason (string)

          容器上次终止的(简要)原因。

        • initContainerStatuses.state.terminated.signal (int32)

          容器上次终止的信号。

      • initContainerStatuses.state.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • initContainerStatuses.state.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • initContainerStatuses.state.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • initContainerStatuses.stopSignal (string)

      StopSignal 报告此容器的有效停止信号。

    • initContainerStatuses.user (ContainerUser)

      User 表示最初附加到容器第一个进程的用户身份信息。

      ContainerUser 表示用户身份信息。

      • initContainerStatuses.user.linux (LinuxContainerUser)

        Linux 包含最初附加到 Linux 容器中第一个进程的用户身份信息。请注意,如果进程具有足够的权限,实际运行身份可以更改。

        LinuxContainerUser 表示 Linux 容器中的用户身份信息。

        • initContainerStatuses.user.linux.gid (int64), 必填

          GID 是最初附加到容器中第一个进程的主 GID。

        • initContainerStatuses.user.linux.uid (int64), 必填

          UID 是最初附加到容器中第一个进程的主 UID。

        • initContainerStatuses.user.linux.supplementalGroups ([]int64)

          原子性:在合并期间将被替换

          SupplementalGroups 是最初附加到容器中第一个进程的补充组。

    • initContainerStatuses.volumeMounts ([]VolumeMountStatus)

      补丁策略:按键 mountPath 合并

      映射:合并时将保留 mountPath 键上的唯一值

      卷挂载状态。

      VolumeMountStatus 显示卷挂载的状态。

      • initContainerStatuses.volumeMounts.mountPath (string), 必填

        MountPath 对应于原始 VolumeMount。

      • initContainerStatuses.volumeMounts.name (string), 必填

        Name 对应于原始 VolumeMount 的名称。

      • initContainerStatuses.volumeMounts.readOnly (boolean)

        ReadOnly 对应于原始 VolumeMount。

      • initContainerStatuses.volumeMounts.recursiveReadOnly (string)

        RecursiveReadOnly 必须设置为 Disabled、Enabled 或未指定(对于非只读挂载)。原始 VolumeMount 中的 IfPossible 值必须根据挂载结果转换为 Disabled 或 Enabled。

  • containerStatuses ([]ContainerStatus)

    原子性:在合并期间将被替换

    此 Pod 中容器的状态。Pod 中的每个容器在此列表中应最多有一个状态,并且所有状态都应为 Pod 中的容器。但是,这不强制执行。如果列表中存在不存在容器的状态,或者列表具有重复名称,则各种 Kubernetes 组件的行为未定义,并且这些状态可能会被忽略。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle/#pod-and-container-status

    ContainerStatus 包含此容器当前状态的详细信息。

    • containerStatuses.allocatedResources (map[string]Quantity)

      AllocatedResources 表示节点为此容器分配的计算资源。Kubelet 在成功 Pod 准入和成功准入所需 Pod 大小调整后,将此值设置为 Container.Resources.Requests。

    • containerStatuses.allocatedResourcesStatus ([]ResourceStatus)

      补丁策略:在键 name 上合并

      映射:合并时将保留键名上的唯一值

      AllocatedResourcesStatus 表示为此 Pod 分配的各种资源的状态。

      ResourceStatus 表示分配给 Pod 的单个资源的状态。

      • containerStatuses.allocatedResourcesStatus.name (string), 必填

        资源名称。在 Pod 中必须是唯一的,如果是非 DRA 资源,则必须与 Pod 规范中的资源之一匹配。对于 DRA 资源,值必须为“claim:<claim_name>/<request>”。当报告此容器状态时,“claim_name”和“request”必须与此容器的声明之一匹配。

      • containerStatuses.allocatedResourcesStatus.resources ([]ResourceHealth)

        映射:合并时将保留 resourceID 键上的唯一值

        唯一资源健康列表。列表中的每个元素都包含一个唯一的资源 ID 及其健康状况。至少在 Pod 的生命周期内,资源 ID 必须唯一标识分配给节点上 Pod 的资源。如果同一节点上的其他 Pod 使用相同的资源 ID 报告状态,则它们必须是共享的相同资源。有关在各种用例中它具有的特定格式,请参见 ResourceID 类型定义。

        ResourceHealth 表示资源的健康状况。它具有最新的设备健康信息。这是 KEP https://kep.k8s.io/4680 的一部分。

        • containerStatuses.allocatedResourcesStatus.resources.resourceID (string), 必填

          ResourceID 是资源的唯一标识符。有关更多信息,请参阅 ResourceID 类型。

        • containerStatuses.allocatedResourcesStatus.resources.health (string)

          资源健康状况。可以是以下之一:

          • Healthy:正常运行。
          • Unhealthy:报告不健康。我们认为这是一个暂时的健康问题,因为我们今天没有机制来区分暂时性和永久性问题。
          • Unknown:状态无法确定。例如,设备插件已注销且此后未重新注册。

          将来我们可能希望引入 PermanentlyUnhealthy 状态。

    • containerStatuses.containerID (string)

      ContainerID 是容器的 ID,格式为 '<type>://<container_id>'。其中 type 是容器运行时标识符,从 CRI API 的 Version 调用返回(例如“containerd”)。

    • containerStatuses.image (string), 必填

      Image 是容器正在运行的容器镜像的名称。容器镜像可能与 PodSpec 中使用的镜像不匹配,因为它可能已由运行时解析。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/images

    • containerStatuses.imageID (string), 必填

      ImageID 是容器镜像的镜像 ID。镜像 ID 可能与 PodSpec 中使用的镜像的镜像 ID 不匹配,因为它可能已由运行时解析。

    • containerStatuses.lastState (ContainerState)

      LastTerminationState 包含容器的最后终止状态,以帮助调试容器崩溃和重启。如果容器仍在运行且 RestartCount 为 0,则不填充此字段。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • containerStatuses.lastState.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • containerStatuses.lastState.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • containerStatuses.lastState.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • containerStatuses.lastState.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • containerStatuses.lastState.terminated.exitCode (int32), 必填

          容器上次终止的退出状态。

        • containerStatuses.lastState.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • containerStatuses.lastState.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • containerStatuses.lastState.terminated.message (string)

          关于容器上次终止的消息。

        • containerStatuses.lastState.terminated.reason (string)

          容器上次终止的(简要)原因。

        • containerStatuses.lastState.terminated.signal (int32)

          容器上次终止的信号。

      • containerStatuses.lastState.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • containerStatuses.lastState.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • containerStatuses.lastState.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • containerStatuses.name (string), 必填

      Name 是一个 DNS_LABEL,表示容器的唯一名称。Pod 中的每个容器在所有容器类型中都必须具有唯一的名称。无法更新。

    • containerStatuses.ready (boolean), 必填

      Ready 指定容器当前是否通过其就绪检查。该值将随着就绪探测的持续执行而改变。如果未指定就绪探测,则一旦容器完全启动(参见 Started 字段),此字段默认为 true。

      该值通常用于确定容器是否已准备好接受流量。

    • containerStatuses.resources (ResourceRequirements)

      Resources 表示在容器启动或成功调整大小后,已成功作用于运行中容器的计算资源请求和限制。

      ResourceRequirements 描述了计算资源要求。

      • containerStatuses.resources.claims ([]ResourceClaim)

        映射:合并时将保留键名上的唯一值

        Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

        此字段依赖于 DynamicResourceAllocation 功能门。

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

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

        • containerStatuses.resources.claims.name (string), 必填

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

        • containerStatuses.resources.claims.request (string)

          Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

      • containerStatuses.resources.limits (map[string]Quantity)

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

      • containerStatuses.resources.requests (map[string]Quantity)

        Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

    • containerStatuses.restartCount (int32), 必填

      RestartCount 包含容器已重启的次数。Kubelet 努力始终增加该值,但在节点重启时可能会丢失状态,然后该值可能会重置为 0。该值从不为负。

    • containerStatuses.started (boolean)

      Started 指示容器是否已完成其 postStart 生命周期钩子并已通过其启动探测。初始为 false,在启动探测被认为是成功后变为 true。当容器重启或 kubelet 暂时失去状态时重置为 false。在这两种情况下,启动探测将再次运行。当未定义启动探测且容器正在运行并已通过 postStart 生命周期钩子时,始终为 true。空值必须与 false 相同处理。

    • containerStatuses.state (ContainerState)

      State 包含关于容器当前状况的详细信息。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • containerStatuses.state.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • containerStatuses.state.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • containerStatuses.state.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • containerStatuses.state.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • containerStatuses.state.terminated.exitCode (int32), 必填

          容器上次终止的退出状态。

        • containerStatuses.state.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • containerStatuses.state.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • containerStatuses.state.terminated.message (string)

          关于容器上次终止的消息。

        • containerStatuses.state.terminated.reason (string)

          容器上次终止的(简要)原因。

        • containerStatuses.state.terminated.signal (int32)

          容器上次终止的信号。

      • containerStatuses.state.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • containerStatuses.state.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • containerStatuses.state.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • containerStatuses.stopSignal (string)

      StopSignal 报告此容器的有效停止信号。

    • containerStatuses.user (ContainerUser)

      User 表示最初附加到容器第一个进程的用户身份信息。

      ContainerUser 表示用户身份信息。

      • containerStatuses.user.linux (LinuxContainerUser)

        Linux 包含最初附加到 Linux 容器中第一个进程的用户身份信息。请注意,如果进程具有足够的权限,实际运行身份可以更改。

        LinuxContainerUser 表示 Linux 容器中的用户身份信息。

        • containerStatuses.user.linux.gid (int64), 必需

          GID 是最初附加到容器中第一个进程的主 GID。

        • containerStatuses.user.linux.uid (int64), 必需

          UID 是最初附加到容器中第一个进程的主 UID。

        • containerStatuses.user.linux.supplementalGroups ([]int64)

          原子性:在合并期间将被替换

          SupplementalGroups 是最初附加到容器中第一个进程的补充组。

    • containerStatuses.volumeMounts ([]VolumeMountStatus)

      补丁策略:按键 mountPath 合并

      映射:合并时将保留 mountPath 键上的唯一值

      卷挂载状态。

      VolumeMountStatus 显示卷挂载的状态。

      • containerStatuses.volumeMounts.mountPath (string), 必需

        MountPath 对应于原始 VolumeMount。

      • containerStatuses.volumeMounts.name (string), 必需

        Name 对应于原始 VolumeMount 的名称。

      • containerStatuses.volumeMounts.readOnly (boolean)

        ReadOnly 对应于原始 VolumeMount。

      • containerStatuses.volumeMounts.recursiveReadOnly (string)

        RecursiveReadOnly 必须设置为 Disabled、Enabled 或未指定(对于非只读挂载)。原始 VolumeMount 中的 IfPossible 值必须根据挂载结果转换为 Disabled 或 Enabled。

  • ephemeralContainerStatuses ([]ContainerStatus)

    原子性:在合并期间将被替换

    此 Pod 中运行的任何临时容器的状态。Pod 中的每个临时容器在此列表中最多应有一个状态,并且所有状态都应针对 Pod 中的容器。但此规定不强制执行。如果列表中存在不存在容器的状态,或列表具有重复名称,则各种 Kubernetes 组件的行为未定义,并且这些状态可能会被忽略。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status

    ContainerStatus 包含此容器当前状态的详细信息。

    • ephemeralContainerStatuses.allocatedResources (map[string]Quantity)

      AllocatedResources 表示节点为此容器分配的计算资源。Kubelet 在成功 Pod 准入和成功准入所需 Pod 大小调整后,将此值设置为 Container.Resources.Requests。

    • ephemeralContainerStatuses.allocatedResourcesStatus ([]ResourceStatus)

      补丁策略:在键 name 上合并

      映射:合并时将保留键名上的唯一值

      AllocatedResourcesStatus 表示为此 Pod 分配的各种资源的状态。

      ResourceStatus 表示分配给 Pod 的单个资源的状态。

      • ephemeralContainerStatuses.allocatedResourcesStatus.name (string), 必需

        资源名称。在 Pod 中必须是唯一的,如果是非 DRA 资源,则必须与 Pod 规范中的资源之一匹配。对于 DRA 资源,值必须为“claim:<claim_name>/<request>”。当报告此容器状态时,“claim_name”和“request”必须与此容器的声明之一匹配。

      • ephemeralContainerStatuses.allocatedResourcesStatus.resources ([]ResourceHealth)

        映射:合并时将保留 resourceID 键上的唯一值

        唯一资源健康列表。列表中的每个元素都包含一个唯一的资源 ID 及其健康状况。至少在 Pod 的生命周期内,资源 ID 必须唯一标识分配给节点上 Pod 的资源。如果同一节点上的其他 Pod 使用相同的资源 ID 报告状态,则它们必须是共享的相同资源。有关在各种用例中它具有的特定格式,请参见 ResourceID 类型定义。

        ResourceHealth 表示资源的健康状况。它具有最新的设备健康信息。这是 KEP https://kep.k8s.io/4680 的一部分。

        • ephemeralContainerStatuses.allocatedResourcesStatus.resources.resourceID (string), 必需

          ResourceID 是资源的唯一标识符。有关更多信息,请参阅 ResourceID 类型。

        • ephemeralContainerStatuses.allocatedResourcesStatus.resources.health (string)

          资源健康状况。可以是以下之一:

          • Healthy:正常运行。
          • Unhealthy:报告不健康。我们认为这是一个暂时的健康问题,因为我们今天没有机制来区分暂时性和永久性问题。
          • Unknown:状态无法确定。例如,设备插件已注销且此后未重新注册。

          将来我们可能希望引入 PermanentlyUnhealthy 状态。

    • ephemeralContainerStatuses.containerID (string)

      ContainerID 是容器的 ID,格式为 '<type>://<container_id>'。其中 type 是容器运行时标识符,从 CRI API 的 Version 调用返回(例如“containerd”)。

    • ephemeralContainerStatuses.image (string), 必需

      Image 是容器正在运行的容器镜像的名称。容器镜像可能与 PodSpec 中使用的镜像不匹配,因为它可能已由运行时解析。更多信息:https://kubernetes.ac.cn/docs/concepts/containers/images

    • ephemeralContainerStatuses.imageID (string), 必需

      ImageID 是容器镜像的镜像 ID。镜像 ID 可能与 PodSpec 中使用的镜像的镜像 ID 不匹配,因为它可能已由运行时解析。

    • ephemeralContainerStatuses.lastState (ContainerState)

      LastTerminationState 包含容器的最后终止状态,以帮助调试容器崩溃和重启。如果容器仍在运行且 RestartCount 为 0,则不填充此字段。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • ephemeralContainerStatuses.lastState.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • ephemeralContainerStatuses.lastState.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • ephemeralContainerStatuses.lastState.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • ephemeralContainerStatuses.lastState.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • ephemeralContainerStatuses.lastState.terminated.exitCode (int32), 必需

          容器上次终止的退出状态。

        • ephemeralContainerStatuses.lastState.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • ephemeralContainerStatuses.lastState.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • ephemeralContainerStatuses.lastState.terminated.message (string)

          关于容器上次终止的消息。

        • ephemeralContainerStatuses.lastState.terminated.reason (string)

          容器上次终止的(简要)原因。

        • ephemeralContainerStatuses.lastState.terminated.signal (int32)

          容器上次终止的信号。

      • ephemeralContainerStatuses.lastState.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • ephemeralContainerStatuses.lastState.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • ephemeralContainerStatuses.lastState.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • ephemeralContainerStatuses.name (string), 必需

      Name 是一个 DNS_LABEL,表示容器的唯一名称。Pod 中的每个容器在所有容器类型中都必须具有唯一的名称。无法更新。

    • ephemeralContainerStatuses.ready (boolean), 必需

      Ready 指定容器当前是否通过其就绪检查。该值将随着就绪探测的持续执行而改变。如果未指定就绪探测,则一旦容器完全启动(参见 Started 字段),此字段默认为 true。

      该值通常用于确定容器是否已准备好接受流量。

    • ephemeralContainerStatuses.resources (ResourceRequirements)

      Resources 表示在容器启动或成功调整大小后,已成功作用于运行中容器的计算资源请求和限制。

      ResourceRequirements 描述了计算资源要求。

      • ephemeralContainerStatuses.resources.claims ([]ResourceClaim)

        映射:合并时将保留键名上的唯一值

        Claims 列出了此容器使用的资源名称,这些资源定义在 spec.resourceClaims 中。

        此字段依赖于 DynamicResourceAllocation 功能门。

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

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

        • ephemeralContainerStatuses.resources.claims.name (string), 必需

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

        • ephemeralContainerStatuses.resources.claims.request (string)

          Request 是在引用声明中为请求选择的名称。如果为空,则声明中的所有内容都可用,否则仅此请求的结果可用。

      • ephemeralContainerStatuses.resources.limits (map[string]Quantity)

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

      • ephemeralContainerStatuses.resources.requests (map[string]Quantity)

        Requests 描述了所需的最小计算资源量。如果容器未指定 Requests,则如果明确指定了 Limits,则默认为 Limits,否则默认为实现定义的值。Requests 不能超过 Limits。更多信息:https://kubernetes.ac.cn/docs/concepts/configuration/manage-resources-containers/

    • ephemeralContainerStatuses.restartCount (int32), 必需

      RestartCount 包含容器已重启的次数。Kubelet 努力始终增加该值,但在节点重启时可能会丢失状态,然后该值可能会重置为 0。该值从不为负。

    • ephemeralContainerStatuses.started (boolean)

      Started 指示容器是否已完成其 postStart 生命周期钩子并已通过其启动探测。初始为 false,在启动探测被认为是成功后变为 true。当容器重启或 kubelet 暂时失去状态时重置为 false。在这两种情况下,启动探测将再次运行。当未定义启动探测且容器正在运行并已通过 postStart 生命周期钩子时,始终为 true。空值必须与 false 相同处理。

    • ephemeralContainerStatuses.state (ContainerState)

      State 包含关于容器当前状况的详细信息。

      ContainerState 包含容器可能的状态。只能指定其中一个成员。如果未指定,则默认值为 ContainerStateWaiting。

      • ephemeralContainerStatuses.state.running (ContainerStateRunning)

        关于运行中容器的详细信息

        ContainerStateRunning 是容器的运行状态。

        • ephemeralContainerStatuses.state.running.startedAt (Time)

          容器上次(重新)启动的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

      • ephemeralContainerStatuses.state.terminated (ContainerStateTerminated)

        关于已终止容器的详细信息。

        ContainerStateTerminated 是容器的终止状态。

        • ephemeralContainerStatuses.state.terminated.containerID (string)

          容器的 ID,格式为 '<type>://<container_id>'

        • ephemeralContainerStatuses.state.terminated.exitCode (int32), 必需

          容器上次终止的退出状态。

        • ephemeralContainerStatuses.state.terminated.startedAt (Time)

          容器上次执行的开始时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • ephemeralContainerStatuses.state.terminated.finishedAt (Time)

          容器上次终止的时间。

          Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

        • ephemeralContainerStatuses.state.terminated.message (string)

          关于容器上次终止的消息。

        • ephemeralContainerStatuses.state.terminated.reason (string)

          容器上次终止的(简要)原因。

        • ephemeralContainerStatuses.state.terminated.signal (int32)

          容器上次终止的信号。

      • ephemeralContainerStatuses.state.waiting (ContainerStateWaiting)

        关于等待中容器的详细信息。

        ContainerStateWaiting 是容器的等待状态。

        • ephemeralContainerStatuses.state.waiting.message (string)

          关于容器尚未运行的原因的消息。

        • ephemeralContainerStatuses.state.waiting.reason (string)

          容器尚未运行的(简要)原因。

    • ephemeralContainerStatuses.stopSignal (string)

      StopSignal 报告此容器的有效停止信号。

    • ephemeralContainerStatuses.user (ContainerUser)

      User 表示最初附加到容器第一个进程的用户身份信息。

      ContainerUser 表示用户身份信息。

      • ephemeralContainerStatuses.user.linux (LinuxContainerUser)

        Linux 包含最初附加到 Linux 容器中第一个进程的用户身份信息。请注意,如果进程具有足够的权限,实际运行身份可以更改。

        LinuxContainerUser 表示 Linux 容器中的用户身份信息。

        • ephemeralContainerStatuses.user.linux.gid (int64), 必需

          GID 是最初附加到容器中第一个进程的主 GID。

        • ephemeralContainerStatuses.user.linux.uid (int64), 必需

          UID 是最初附加到容器中第一个进程的主 UID。

        • ephemeralContainerStatuses.user.linux.supplementalGroups ([]int64)

          原子性:在合并期间将被替换

          SupplementalGroups 是最初附加到容器中第一个进程的补充组。

    • ephemeralContainerStatuses.volumeMounts ([]VolumeMountStatus)

      补丁策略:按键 mountPath 合并

      映射:合并时将保留 mountPath 键上的唯一值

      卷挂载状态。

      VolumeMountStatus 显示卷挂载的状态。

      • ephemeralContainerStatuses.volumeMounts.mountPath (string), 必需

        MountPath 对应于原始 VolumeMount。

      • ephemeralContainerStatuses.volumeMounts.name (string), 必需

        Name 对应于原始 VolumeMount 的名称。

      • ephemeralContainerStatuses.volumeMounts.readOnly (boolean)

        ReadOnly 对应于原始 VolumeMount。

      • ephemeralContainerStatuses.volumeMounts.recursiveReadOnly (string)

        RecursiveReadOnly 必须设置为 Disabled、Enabled 或未指定(对于非只读挂载)。原始 VolumeMount 中的 IfPossible 值必须根据挂载结果转换为 Disabled 或 Enabled。

  • resourceClaimStatuses ([]PodResourceClaimStatus)

    补丁策略:保留键,按键 name 合并

    映射:合并时将保留键名上的唯一值

    资源请求状态。

    PodResourceClaimStatus 存储在 Pod 的 PodStatus 中,用于引用 ResourceClaimTemplate 的每个 PodResourceClaim。它存储相应 ResourceClaim 生成的名称。

    • resourceClaimStatuses.name (string), 必需

      名称在 Pod 内唯一标识此资源请求。这必须与 pod.spec.resourceClaims 中的条目名称匹配,这意味着该字符串必须是 DNS_LABEL。

    • resourceClaimStatuses.resourceClaimName (string)

      ResourceClaimName 是为 Pod 在 Pod 命名空间中生成的 ResourceClaim 的名称。如果未设置此项,则无需生成 ResourceClaim。在这种情况下,可以忽略 pod.spec.resourceClaims 条目。

  • extendedResourceClaimStatus (PodExtendedResourceClaimStatus)

    DRA 支持的扩展资源请求的状态。

    PodExtendedResourceClaimStatus 存储在 Pod 的 PodStatus 中,用于 DRA 支持的扩展资源请求。它存储调度器创建的相应特殊 ResourceClaim 的生成名称。

    • extendedResourceClaimStatus.requestMappings ([]ContainerExtendedResourceRequest), 必需

      原子性:在合并期间将被替换

      RequestMappings 标识了 <容器,DRA 支持的扩展资源> 到生成 ResourceClaim 中设备请求的映射。

      ContainerExtendedResourceRequest 具有容器名称、扩展资源名称到设备请求名称的映射。

      • extendedResourceClaimStatus.requestMappings.containerName (string), 必需

        请求资源的容器名称。

      • extendedResourceClaimStatus.requestMappings.requestName (string), 必需

        特殊 ResourceClaim 中与扩展资源对应的请求名称。

      • extendedResourceClaimStatus.requestMappings.resourceName (string), 必需

        该容器中由 DRA 支持的扩展资源的名称。

    • extendedResourceClaimStatus.resourceClaimName (string), 必需

      ResourceClaimName 是为 Pod 在 Pod 命名空间中生成的 ResourceClaim 的名称。

  • resize (string)

    Pod 容器所需的资源大小调整状态。如果没有待处理的资源大小调整,则为空。对容器资源的任何更改都将自动将其设置为“Proposed”。已弃用:大小调整状态已移至两个 Pod 条件 PodResizePending 和 PodResizeInProgress。PodResizePending 将跟踪已调整规范大小但 Kubelet 尚未分配资源的状态。PodResizeInProgress 将跟踪正在进行的大小调整,并且只要分配的资源 != 确认的资源,就应该存在。

  • observedGeneration (int64)

    如果设置,这表示 Pod 状态所基于的 .metadata.generation。这是一个 Alpha 字段。启用 PodObservedGenerationTracking 以便使用此字段。

PodList

PodList 是 Pod 的列表。


操作


get 读取指定的 Pod

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods/{name}

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

401: 未授权

get 读取指定 Pod 的临时容器

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

401: 未授权

get 读取指定 Pod 的日志

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods/{name}/log

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • container (查询参数): string

    要流式传输日志的容器。如果 Pod 中只有一个容器,则默认为该容器。

  • follow (查询参数): boolean

    跟随 Pod 的日志流。默认为 false。

  • insecureSkipTLSVerifyBackend (查询参数): boolean

    insecureSkipTLSVerifyBackend 表示 API 服务器不应确认其正在连接的后端服务证书的有效性。这将使 API 服务器和后端之间的 HTTPS 连接不安全。这意味着 API 服务器无法验证其收到的日志数据是否来自真正的 kubelet。如果 kubelet 配置为验证 API 服务器的 TLS 凭据,则这并不意味着与真实 kubelet 的连接容易受到中间人攻击(例如,攻击者无法拦截来自真实 kubelet 的实际日志数据)。

  • limitBytes (查询参数): integer

    如果设置,表示在终止日志输出之前从服务器读取的字节数。这可能不会显示完整的最后一行日志,并且返回的字节数可能略多于或略少于指定的限制。

  • pretty (在查询中): string

    pretty

  • previous (查询参数): boolean

    返回之前终止的容器日志。默认为 false。

  • sinceSeconds (查询参数): integer

    一个相对于当前时间的秒数,用于显示日志。如果此值在 Pod 启动时间之前,则仅返回 Pod 启动以来的日志。如果此值在未来,则不返回日志。只能指定 sinceSeconds 或 sinceTime 中的一个。

  • stream (查询参数): string

    指定要返回给客户端的容器日志流。可接受的值为 "All"、"Stdout" 和 "Stderr"。如果未指定,则使用 "All",并交错返回 stdout 和 stderr。请注意,当指定 "TailLines" 时,"Stream" 只能设置为 nil 或 "All"。

  • tailLines (查询参数): integer

    如果设置,表示要显示的日志末尾行数。如果未指定,则从容器创建或 sinceSeconds 或 sinceTime 开始显示日志。请注意,当指定 "TailLines" 时,"Stream" 只能设置为 nil 或 "All"。

  • timestamps (查询参数): boolean

    如果为 true,则在每行日志输出的开头添加 RFC3339 或 RFC3339Nano 时间戳。默认为 false。

响应

200 (string): 确定

401: 未授权

get 读取指定 Pod 的大小调整

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods/{name}/resize

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

401: 未授权

get 读取指定 Pod 的状态

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods/{name}/status

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

401: 未授权

list 列出或监视 Pod 类型的对象

HTTP 请求

GET /api/v1/namespaces/{namespace}/pods

参数

响应

200 (PodList): 确定

401: 未授权

list 列出或监视 Pod 类型的对象

HTTP 请求

GET /api/v1/pods

参数

响应

200 (PodList): 确定

401: 未授权

create 创建 Pod

HTTP 请求

POST /api/v1/namespaces/{namespace}/pods

参数

响应

200 (Pod): 确定

201 (Pod): 已创建

202 (Pod): 已接受

401: 未授权

update 替换指定的 Pod

HTTP 请求

PUT /api/v1/namespaces/{namespace}/pods/{name}

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Pod, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

update 替换指定的 Pod 的临时容器

HTTP 请求

PUT /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Pod, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

update 替换指定的 Pod 的大小调整

HTTP 请求

PUT /api/v1/namespaces/{namespace}/pods/{name}/resize

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Pod, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

update 替换指定的 Pod 的状态

HTTP 请求

PUT /api/v1/namespaces/{namespace}/pods/{name}/status

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Pod, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

patch 部分更新指定的 Pod

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/pods/{name}

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Patch,必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

patch 部分更新指定的 Pod 的临时容器

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Patch,必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

patch 部分更新指定的 Pod 的大小调整

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/pods/{name}/resize

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Patch,必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

patch 部分更新指定的 Pod 的状态

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/pods/{name}/status

参数

  • name (在路径中): string,必填

    Pod 的名称

  • namespace (在路径中): string,必填

    命名空间

  • body: Patch,必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (Pod): 确定

201 (Pod): 已创建

401: 未授权

delete 删除 Pod

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/pods/{name}

参数

响应

200 (Pod): 确定

202 (Pod): 已接受

401: 未授权

deletecollection 删除 Pod 集合

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/pods

参数

响应

200 (Status): OK

401: 未授权

本页面是自动生成的。

如果你打算报告此页面存在的问题,请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间:2025 年 9 月 4 日 下午 3:37 PST:更新 v1.34 的 API 资源参考 (3e10e8c195)