第 3 章 ClusterServiceVersion [operators.coreos.com/v1alpha1]

annotations

对象（字符串）

annotations 是一个无结构的键值映射，它存储有资源，可通过外部工具存储和检索任意元数据。

apiservicedefinitions

对象

apiservicedefinitions 声明由 ClusterServiceVersion 运行 Operator 管理或所需的所有扩展 apis。

cleanup

对象

cleanup 指定 CSV 被删除时的清理过程

customresourcedefinitions

对象

customresourcedefinitions 声明 ClusterServiceVersion 运行 Operator 管理或所需的所有 CRD。

如果 CRD 存在于 Owned 列表中，则会隐式需要。

description

string

操作器的描述。可以包括 Operator 的功能、限制或用例。

displayName

string

显示格式的 Operator 名称。

icon

数组

此 operator 的图标。

icon[]

对象

install

对象

NamedInstallStrategy 代表指定安装策略的 ClusterServiceVersion 资源的块。

installModes

array

InstallModes 指定支持的安装类型

installModes[]

对象

InstallMode 将 InstallModeType 与 CSV 支持代表的标记相关联

关键字

数组（字符串）

描述操作器的关键字列表。

labels

对象（字符串）

可用于组织和分类（范围和选择）对象的字符串键和值映射。

links

数组

与 Operator 相关的链接列表。

links[]

对象

maintainers

数组

维护 Operator 的机构实体列表。

maintainers[]

对象

成熟度

字符串

minKubeVersion

字符串

nativeAPI

array

nativeAPIs[]

对象

groupversionkind unambiguously 标识 kind。它不匿名包含 GroupVersion 来避免自动协调。它不使用 GroupVersion 来避免自定义 marshalling

provider

object

Operator 后面的发布实体。

relatedImages

array

列出 Operator 执行其功能可能需要的任何相关镜像或其他容器镜像。此列表还应包含操作对象镜像。所有镜像引用都应通过摘要(SHA)而不是标签指定。此字段仅在目录创建期间使用，并且不在集群运行时使用 play。

relatedImages[]

对象

替换

字符串

此替换的 CSV 的名称。应该与旧 CSV 的 metadata.Name 字段匹配。

selector

对象

相关资源的标签选择器。

skips

数组（字符串）

升级图中应该跳过的一个或多个 CSV 的名称。应该与应跳过的 CSV 的 metadata.Name 字段匹配。此字段仅在目录创建期间使用，并且不在集群运行时使用 play。

version

string

webhookdefinitions

array

webhookdefinitions[]

对象

WebhookDescription 提供有关所需 webhook 的 OLM 的详情

拥有的

array

owned[]

对象

APIServiceDescription 提供有关通过聚合提供的 apis 的 OLM 的详细信息

required

array

required[]

对象

APIServiceDescription 提供有关通过聚合提供的 apis 的 OLM 的详细信息

actionDescriptors

array

actionDescriptors[]

对象

ActionDescriptor 描述了一个声明操作，可在自定义资源实例上执行

containerPort

整数

deploymentName

字符串

description

字符串

displayName

字符串

group

字符串

kind

字符串

name

字符串

资源

array

resources[]

object

APIResourceReference 是引用者使用的 Kubernetes 资源类型的引用。

specDescriptors

array

specDescriptors[]

对象

specDescriptor 描述 CRD 的 spec 块中的字段，以便 OLM 可以使用它

statusDescriptors

array

statusDescriptors[]

对象

StatusDescriptor 描述 CRD 状态块中的一个字段，以便 OLM 可以使用它

version

字符串

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

kind

string

所引用资源类型的类型。

名称

string

所引用资源类型的复数名称(CustomResourceDefinition.Spec.Names[].Plural)。如果引用的资源类型不是自定义资源，则空字符串。

version

string

所引用资源类型的 API 版本。

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

actionDescriptors

array

actionDescriptors[]

对象

ActionDescriptor 描述了一个声明操作，可在自定义资源实例上执行

containerPort

整数

deploymentName

字符串

description

字符串

displayName

字符串

group

字符串

kind

字符串

name

字符串

资源

array

resources[]

object

APIResourceReference 是引用者使用的 Kubernetes 资源类型的引用。

specDescriptors

array

specDescriptors[]

对象

specDescriptor 描述 CRD 的 spec 块中的字段，以便 OLM 可以使用它

statusDescriptors

array

statusDescriptors[]

对象

StatusDescriptor 描述 CRD 状态块中的一个字段，以便 OLM 可以使用它

version

字符串

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

kind

string

所引用资源类型的类型。

名称

string

所引用资源类型的复数名称(CustomResourceDefinition.Spec.Names[].Plural)。如果引用的资源类型不是自定义资源，则空字符串。

version

string

所引用资源类型的 API 版本。

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

enabled

布尔值

拥有的

array

owned[]

对象

CRDDescription 提供有关 CRD 的 OLM 的详情

required

array

required[]

对象

CRDDescription 提供有关 CRD 的 OLM 的详情

actionDescriptors

array

actionDescriptors[]

对象

ActionDescriptor 描述了一个声明操作，可在自定义资源实例上执行

description

字符串

displayName

字符串

kind

字符串

name

字符串

资源

array

resources[]

object

APIResourceReference 是引用者使用的 Kubernetes 资源类型的引用。

specDescriptors

array

specDescriptors[]

对象

specDescriptor 描述 CRD 的 spec 块中的字段，以便 OLM 可以使用它

statusDescriptors

array

statusDescriptors[]

对象

StatusDescriptor 描述 CRD 状态块中的一个字段，以便 OLM 可以使用它

version

字符串

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

kind

string

所引用资源类型的类型。

名称

string

所引用资源类型的复数名称(CustomResourceDefinition.Spec.Names[].Plural)。如果引用的资源类型不是自定义资源，则空字符串。

version

string

所引用资源类型的 API 版本。

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

actionDescriptors

array

actionDescriptors[]

对象

ActionDescriptor 描述了一个声明操作，可在自定义资源实例上执行

description

字符串

displayName

字符串

kind

字符串

name

字符串

资源

array

resources[]

object

APIResourceReference 是引用者使用的 Kubernetes 资源类型的引用。

specDescriptors

array

specDescriptors[]

对象

specDescriptor 描述 CRD 的 spec 块中的字段，以便 OLM 可以使用它

statusDescriptors

array

statusDescriptors[]

对象

StatusDescriptor 描述 CRD 状态块中的一个字段，以便 OLM 可以使用它

version

字符串

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

kind

string

所引用资源类型的类型。

名称

string

所引用资源类型的复数名称(CustomResourceDefinition.Spec.Names[].Plural)。如果引用的资源类型不是自定义资源，则空字符串。

version

string

所引用资源类型的 API 版本。

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

description

字符串

displayName

字符串

path

字符串

value

字符串

RawMessage 是一个原始编码的 JSON 值。它实现 [Marshaler] 和 [Unmarshaler]，并可用于延迟 JSON 解码或预计算 JSON 编码。

x-descriptors

数组（字符串）

base64data

字符串

MediaType

字符串

spec

对象

StrategyDetailsDeployment 代表 Deployment InstallStrategy 的解析详情。

策略

字符串

clusterPermissions

array

clusterPermissions[]

对象

StrategyDeploymentPermissions 描述安装策略所需的 rbac 规则和服务帐户

部署

array

deployments[]

对象

StrategyDeploymentSpec 包含部署 ALM 应该创建的名称、spec 和标签

权限

array

permissions[]

对象

StrategyDeploymentPermissions 描述安装策略所需的 rbac 规则和服务帐户

rules

array

rules[]

object

PolicyRule 包含描述策略规则的信息，但不包含有关规则应用到谁或规则应用到哪个命名空间的信息。

serviceAccountName

字符串

apiGroups

数组（字符串）

APIGroups 是包含资源的 APIGroup 的名称。如果指定了多个 API 组，则允许针对任何 API 组中的一个枚举资源请求的任何操作。"" 代表核心 API 组，"*"代表所有 API 组。

nonResourceURLs

数组（字符串）

NonResourceURLs 是一组用户应该有权访问的部分 url。OpenShift 被允许，但只作为完整的、最终的步骤在路径 Since 非资源 URL 中不是命名空间，此字段仅适用于从 ClusterRoleBinding 引用的 ClusterRole。规则可以应用到 API 资源（如 "pods" 或 "secrets"）或非资源 URL 路径（如 "/api"），但不能同时应用这两个资源。

resourceNames

数组（字符串）

resourceNames 是一个可选的规则应用到的名称白名单。空集表示所有都会被允许。

resources

数组（字符串）

resources 是此规则应用到的资源列表。'*' 代表所有资源。

verbs

数组（字符串）

verbs 是一个 Verbs 列表，适用于此规则中包含的 all ResourceKinds。'*' 代表所有操作动词。

label

对象（字符串）

set 是 label:value 的映射。它实现了标签。

name

字符串

spec

对象

DeploymentSpec 是 Deployment 所需的行为的规格。

minReadySeconds

整数

新创建的 pod 应该在没有其任何容器崩溃的情况下就绪的最少秒数，以便它被视为可用。默认为 0 (pod 一旦就绪就会被视为可用)

paused

布尔值

表示部署已暂停。

progressDeadlineSeconds

整数

部署在被视为失败前进行进度的最长时间（以秒为单位）。部署控制器将继续处理失败的部署，以及具有 ProgressDeadlineExceed 原因的条件将处于部署状态。请注意，在部署暂停期间不会估算进度。默认值为 600s。

replicas

整数

所需的 pod 数量。这是一个指针，用于区分显式零和未指定的。默认为 1。

revisionHistoryLimit

整数

要保留的旧 ReplicaSet 数量，以允许回滚。这是一个指针，用于区分显式零和未指定的。默认值为 10。

selector

对象

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

策略

对象

用于将现有 pod 替换为新 pod 的部署策略。

模板

对象

Template 描述了要创建的 pod。唯一允许的 template.spec.restartPolicy 值是 "Always"。

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

rollingUpdate

对象

滚动更新配置参数.仅在 DeploymentStrategyType = RollingUpdate. --- TODO: 更新它以遵循我们的 oneOf 的约定，无论我们决定它是什么。

type

字符串

部署类型。可以是 "Recreate" 或 "RollingUpdate"。默认为 RollingUpdate。

maxSurge

integer-or-string

可以在所需 pod 数量之上调度的最大 pod 数量。值可以是绝对数字（例如 5）或所需 pod 的百分比（例如 10%）。如果 MaxUnavailable 为 0，则不能是 0。绝对数量从百分比计算。默认值为 25%。示例：当将其设置为 30% 时，在滚动更新启动时可以立即扩展新的 ReplicaSet，以便旧 pod 的总数不会超过 130%。旧 pod 终止后，可以进一步扩展新的 ReplicaSet，确保更新期间任何时间运行的 pod 总数最多为 130%。

maxUnavailable

integer-or-string

更新期间不可用的 pod 的最大数量。值可以是绝对数字（例如 5）或所需 pod 的百分比（例如 10%）。绝对数量从百分比计算（通过向下舍入）。如果 MaxSurge 为 0，则这不能是 0。默认值为 25%。示例：当将其设置为 30% 时，在滚动更新启动时，可以立即将旧 ReplicaSet 缩减到 70% 的 pod。新 pod 就绪后，可以进一步扩展旧的 ReplicaSet，然后扩展新的 ReplicaSet，确保更新期间可用的 pod 总数至少 70%。

metadata

``

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

spec

对象

Pod 所需的行为规格。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

activeDeadlineSeconds

整数

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

关联性

对象

如果指定，pod 的调度限制

automountServiceAccountToken

布尔值

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

containers

array

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

containers[]

对象

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

dnsConfig

对象

指定 pod 的 DNS 参数。此处指定的参数将根据 DNSPolicy 合并到生成的 DNS 配置中。

dnsPolicy

字符串

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

enableServiceLinks

布尔值

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

ephemeralContainers

array

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

ephemeralContainers[]

object

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

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

hostAliases

array

hostAliases 是主机和 IP 的可选列表，如果指定，将注入到 pod 的主机文件中。

hostAliases[]

对象

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

hostIPC

布尔值

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

hostNetwork

布尔值

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

hostPID

布尔值

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

hostUsers

布尔值

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

hostname

字符串

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

imagePullSecrets

array

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

imagePullSecrets[]

对象

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

initContainers

array

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

initContainers[]

对象

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

nodeName

字符串

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

nodeSelector

对象（字符串）

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

os

object

指定 pod 中容器的操作系统。如果设置了，一些 pod 和容器字段会被限制。

如果 OS 字段设置为 linux，则必须取消设置以下字段： -securityContext.windowsOptions

如果将 OS 字段设置为 windows，则必须取消设置以下字段： - spec.hostPID - spec.hostIPC - spec.hostUsers - spec.securityContext.appArmorProfile - spec.securityContext.seLinuxOptions - spec.securityContext.seccompProfile - spec.securityContext.fsGroup - spec.securityContext.fsGroupChangePolicy - spec.securityContext.sysctls - spec.securityContext.sysctls - spec.securityContext.seccompProfile spec.shareProcessNamespace - spec.securityContext.runAsUser - spec.securityContext.runAsGroup - spec.securityContext.supplementalGroups - 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

开销

integer-or-string

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

preemptionPolicy

字符串

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

priority

整数

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

priorityClassName

字符串

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

readinessGates

array

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

readinessGates[]

对象

PodReadinessGate 包含对 pod 条件的引用

resourceClaims

数组

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

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

此字段不可变。

resourceClaims[]

object

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

restartPolicy

字符串

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

runtimeClassName

字符串

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

schedulerName

字符串

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

schedulingGates

数组

SchedulingGates 是不透明的值列表，如果指定，它将阻止调度 pod。如果 schedulingGates 不为空，pod 将保持在 SchedulingGated 状态，调度程序不会尝试调度 pod。

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

schedulingGates[]

object

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

securityContext

对象

securityContext 包含 pod 级别的安全属性和通用容器设置。可选：默认为空。有关每个字段的默认值，请参阅类型描述。

serviceAccount

string

DeprecatedServiceAccount 是 ServiceAccountName 的已弃用别名。弃用 ：使用 serviceAccountName 替代。

serviceAccountName

字符串

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

setHostnameAsFQDN

布尔值

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

shareProcessNamespace

布尔值

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

subdomain

字符串

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

terminationGracePeriodSeconds

整数

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

容限（tolerations）

array

如果指定，pod 的容限。

tolerations[]

对象

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

topologySpreadConstraints

array

topologySpreadConstraints 描述了一组如何在拓扑域间分布的 pod。调度程序将按约束来调度 pod。所有 topologySpreadConstraints 都是 AND。

topologySpreadConstraints[]

对象

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

卷

array

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

volumes[]

对象

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

nodeAffinity

对象

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

podAffinity

对象

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

podAntiAffinity

对象

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

对象

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

preference

对象

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

weight

整数

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

nodeSelectorTerms

array

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

nodeSelectorTerms[]

对象

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

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

podAffinityTerm

对象

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

weight

整数

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

labelSelector

对象

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

matchLabelKeys

数组（字符串）

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

mismatchLabelKeys

数组（字符串）

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

labelSelector

对象

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

matchLabelKeys

数组（字符串）

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

mismatchLabelKeys

数组（字符串）

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

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

podAffinityTerm

对象

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

weight

整数

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

labelSelector

对象

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

matchLabelKeys

数组（字符串）

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

mismatchLabelKeys

数组（字符串）

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

labelSelector

对象

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

matchLabelKeys

数组（字符串）

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

mismatchLabelKeys

数组（字符串）

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

args

数组（字符串）

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

命令

数组（字符串）

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

env

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

string

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

imagePullPolicy

字符串

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

生命周期

对象

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

livenessProbe

对象

容器存活度探测.如果探测失败，容器将重启。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

name

字符串

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

ports

array

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

ports[]

对象

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

readinessProbe

对象

容器服务的定期探测到就绪状态。如果探测失败，容器将从服务端点中删除。无法更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

resizePolicy

数组

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

resizePolicy[]

object

ContainerResizePolicy 代表容器的资源重新定义策略。

resources

对象

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

restartPolicy

string

restartPolicy 定义 pod 中单个容器的重启行为。此字段只能为 init 容器设置，唯一允许的值是 "Always"。对于非init 容器或没有指定此字段时，重启行为由 Pod 的重启策略和容器类型定义。将 init 容器的 RestartPolicy 设置为 "Always" 将具有以下效果：此 init 容器将持续重启退出，直到所有常规容器都终止为止。所有常规容器完成后，所有带有 restartPolicy "Always" 的 init 容器都会被关闭。这个生命周期与普通 init 容器不同，通常被称为 "sidecar" 容器。虽然这个 init 容器仍然在 init 容器序列中启动，但它不会等待容器完成，然后才能进入下一个 init 容器。相反，下一个 init 容器会在此 init 容器启动后，或者在任何 startupProbe 成功完成后启动。

securityContext

对象

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

startupProbe

对象

startupProbe 表示 Pod 已成功初始化。如果指定，则不会执行其他探测，直到成功完成为止。如果这个探测失败，则 Pod 将重启，就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数，当可能需要很长时间才能加载数据或温缓存时，而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

stdin

布尔值

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

stdinOnce

布尔值

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

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

tty

布尔值

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

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

VolumeMount 描述了容器内卷挂载。

workingDir

字符串

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

name

字符串

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