第 2 章 Alertmanager [monitoring.coreos.com/v1]
- 描述
Alertmanager自定义资源定义(CRD)定义要在 Kubernetes 集群中运行的所需的 [Alertmanager](https://prometheus.io/docs/alerting)设置。它允许指定许多选项,如副本数、持久性存储等。对于每个
Alertmanager资源,Operator 会在同一命名空间中部署StatefulSet。当有两个或更多个配置的副本时,Operator 以高可用性模式运行 Alertmanager 实例。资源通过标签和命名空间选择器定义,
AlertmanagerConfig对象应与部署的 Alertmanager 实例关联。- 类型
-
object - 必填
-
spec
-
2.1. 规格 复制链接链接已复制到粘贴板!
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| Alertmanager 集群所需行为的规格。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
|
|
| Alertmanager 集群的状态最近观察到的状态。只读。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
2.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- Alertmanager 集群所需行为的规格。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| AdditionalArgs 允许为 'Alertmanager' 容器设置附加参数。它旨在激活被专用配置选项不支持的隐藏标志。参数以 as-is 传递给 Alertmanager 容器,如果它们无效或未由给定 Alertmanager 版本支持,则可能会导致问题。 |
|
|
| 参数作为 AdditionalArgs 列表的一部分。 |
|
|
| AdditionalPeers 允许将一组额外的 Alertmanager 注入与 peer 组成一个高可用性集群。 |
|
|
| 如果指定,pod 的调度限制。 |
|
|
| AlertmanagerConfigMatcherStrategy 定义 AlertmanagerConfig 对象如何处理传入的警报。 |
|
|
| 为 AlertmanagerConfig 发现选择的命名空间。如果为 nil,则仅检查自己的命名空间。 |
|
|
| 要选择的 alertmanagerconfigs,用于合并并配置 Alertmanager。 |
|
|
| alertmanagerConfiguration 指定 Alertmanager 的配置。
如果定义,它优先于 这是一个 实验性功能,它可能会以中断的方式改变任何即将推出的版本。 |
|
|
|
AutomountServiceAccountToken 表示服务帐户令牌是否应该自动挂载到 pod 中。如果服务帐户具有 |
|
|
| 用于部署 pod 的基础镜像,没有标签。deprecated: 使用 'image' 替代。 |
|
|
| ClusterAdvertiseAddress 是集群中要公告的显式地址。需要为非 RFC1918 [1] (公共)地址提供。[1] RFC1918: https://tools.ietf.org/html/rfc1918 |
|
|
| 在 gosip 尝试之间间隔。 |
|
|
|
定义唯一标识 Alertmanager 集群的标识符。只有在 Alertmanager 集群包含此 Alertmanager 资源外部的 Alertmanager 实例时,才应设置它。在实践中,外部实例的地址通过 |
|
|
| 集群对等的超时时间。 |
|
|
| 拉取尝试之间的间隔。 |
|
|
| 为 Alertmanager 集群的 gosip 协议配置 mutual TLS 配置。 它需要 Alertmanager >= 0.24.0。 |
|
|
|
ConfigMap 是与 Alertmanager 对象相同的命名空间中的 ConfigMap 列表,该对象应挂载到 Alertmanager Pod 中。每个 ConfigMap 都作为名为 |
|
|
|
ConfigSecret 是与 Alertmanager 对象相同的命名空间中的 Kubernetes Secret 的名称,其中包含此 Alertmanager 实例的配置。如果为空,则默认为
Alertmanager 配置应在
如果缺少 secret 或 |
|
|
|
容器允许注入其他容器。这是允许向 Alertmanager pod 添加身份验证代理。这里描述的容器如果操作器共享相同的名称和修改,则修改通过战略合并补丁来完成。当前容器名称为: |
|
|
| 要在 pod 中运行的单一应用程序容器。 |
|
|
| 定义 pod 的 DNS 配置。 |
|
|
| 定义 pod 的 DNS 策略。 |
|
|
| 启用对 Alertmanager 功能标记的访问。默认情况下,不启用任何功能。启用默认情况下禁用的功能完全超出了维护人员将支持什么范围,通过这样做,您接受的行为可能随时中断,而无需通知。 它需要 Alertmanager >= 0.27.0。 |
|
|
| 指明有关服务的信息是否应该注入 pod 的环境变量中 |
|
|
| Alertmanager 实例将位于的外部 URL。这是生成正确 URL 所必需的。如果 Alertmanager 没有从 DNS 名称的根目录提供,则需要此项。 |
|
|
| ForceEnableClusterMode 可确保 Alertmanager 在使用单个副本运行时不会取消激活集群模式。用例是,例如在 Kubernetes 集群间生成 Alertmanager 集群,每个集群都有单个副本。 |
|
|
| Pod 的 hostAliases 配置 |
|
|
| HostAlias 包含 IP 和主机名之间的映射,这些映射将作为 pod 的主机文件中的条目注入。 |
|
|
| HostUsers 支持 Kubernetes 中的用户空间。 更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/user-namespaces/
这个功能至少需要启用 |
|
|
| 如果指定,则镜像的优先级高于 baseImage、tag 和 sha 组合。仍然需要指定版本以确保 Prometheus Operator 知道要配置 Alertmanager 版本。 |
|
|
| 'alertmanager', 'init-config-reloader' 和 'config-reloader' 容器的镜像拉取策略。详情请查看 https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy。 |
|
|
| 从 registry 中对同一命名空间中的 secret 的引用列表,用于从 registry 中拉取 prometheus 和 alertmanager 镜像,请参阅 https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/ |
|
|
| LocalObjectReference 包含足够信息,供您在同一命名空间中找到引用的对象。 |
|
|
|
initContainers 允许将 initContainers 添加到 pod 定义中。它们可用于从外部来源获取用于注入 Alertmanager 配置的 secret。执行 initContainer 期间的任何错误将导致重启 Pod。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers如果操作器共享相同的名称和修改,则修改 Operator 生成的 init 容器(如果它们通过策略合并补丁完成)。当前 init 容器名称为: |
|
|
| 要在 pod 中运行的单一应用程序容器。 |
|
|
| 定义启动 Alertmanager 时的限制命令行标志。 |
|
|
| ListenLocal 使 Alertmanager 服务器侦听回环,因此它不会绑定 Pod IP。请注意,这只适用于 Alertmanager UI,而不是 gossip 通信。 |
|
|
| 用于配置 Alertmanager 的日志格式。 |
|
|
| 用于配置 Alertmanager 的日志级别。 |
|
|
| 新创建的 pod 应该在不出现任何容器崩溃的情况下变为可用状态的最小秒数。 如果未设置,则 pod 会在就绪后被视为可用。 |
|
|
| 定义 Pod 调度到哪些节点上。 |
|
|
| 如果设置为 true,则不会对底层受管对象的所有操作执行,但 delete 操作除外。 |
|
|
| 字段控制 StatefulSet 生命周期中是否和如何删除 PVC。所有 PVC 的默认行为都会被保留。这是 kubernetes 1.23 的 alpha 字段,直到 1.26 和来自 1.26 的 beta 字段。它需要启用 StatefulSetAutoDeletePVC 功能门。 |
|
|
| podMetadata 配置传播到 Alertmanager pod 的标签和注解。 以下项目会被保留且无法覆盖:* "alertmanager" 标签,设置为 Alertmanager 实例的名称。* "app.kubernetes.io/instance" 标签,设置为 Alertmanager 实例的名称。* "app.kubernetes.io/managed-by" 标签,设置为 "prometheus-operator"。* "app.kubernetes.io/name" 标签,设置为 "alertmanager"。* "app.kubernetes.io/version" 标签,设置为 Alertmanager 版本。* "kubectl.kubernetes.io/default-container" 注解,设置为 "alertmanager"。 |
|
|
|
用于 pod 和监管服务的端口名称。默认为 |
|
|
| 分配给 Pod 的优先级类 |
|
|
| size 是 alertmanager 集群的预期大小。控制器最终将使正在运行的集群的大小等于预期大小。 |
|
|
| 为单个 Pod 定义资源请求和限值。 |
|
|
|
Alertmanager 应该保留数据的时长:默认为 '120h',它必须与正则表达式 |
|
|
|
Alertmanager 为以下情况注册 HTTP 处理程序的路由前缀。这在使用 ExternalURL 和代理时很有用,如果重写请求的 HTTP 路由,并且实际的 ExternalURL 仍为 true,但服务器在不同的路由前缀下提供请求。例如,用于 |
|
|
|
secret 是与 Alertmanager 对象相同的命名空间中的 Secret 列表,它应挂载到 Alertmanager Pod 中。每个 Secret 都作为名为 |
|
|
| securityContext 包含 pod 级别的安全属性和通用容器设置。默认为默认的 PodSecurityContext。 |
|
|
| serviceAccountName 是用于运行 Prometheus Pod 的 ServiceAccount 的名称。 |
|
|
|
底层 StatefulSet 使用的服务名称作为管理服务。如果定义,必须在同一命名空间中的 Alertmanager 资源之前创建 Service,它必须定义一个与 pod 标签匹配的选择器。如果为空,Operator 将创建和管理一个名为 |
|
|
|
要部署的 Alertmanager 容器镜像的 SHA。默认为 |
|
|
| 存储是 Alertmanager 实例如何使用存储的定义。 |
|
|
|
要部署的 Alertmanager 容器镜像标签。默认为 |
|
|
| pod 安全终止所需的可选持续时间(以秒为单位)。值必须是非负整数。值为零表示立即通过终止信号(没有关闭机会)停止,这可能会导致数据崩溃。 默认值为 120 秒。 |
|
|
| 如果指定,pod 的容限。 |
|
|
| 此 Toleration 附加到 pod,以使用匹配的 operator <operator> 容许与 triple <key,value,effect> 匹配的任何污点。 |
|
|
| 如果指定,pod 的拓扑分布限制。 |
|
|
| TopologySpreadConstraint 指定如何在给定的拓扑中分布匹配的 pod。 |
|
|
| 集群应该为 on 的版本。 |
|
|
| volumeMounts 允许在输出 StatefulSet 定义上配置额外的 VolumeMount。指定 volumeMounts 将附加到 alertmanager 容器中的其他 VolumeMount,这些 VolumeMount 会根据 StorageSpec 对象生成的。 |
|
|
| VolumeMount 描述了容器内卷挂载。 |
|
|
| 卷允许在输出 StatefulSet 定义中配置额外的卷。指定的卷将附加到作为 StorageSpec 对象生成的其他卷。 |
|
|
| 卷代表 pod 中的指定卷,可以被 pod 中的任何容器访问。 |
|
|
| 定义启动 Alertmanager 时的 Web 命令行标志。 |
2.1.2. .spec.additionalArgs 复制链接链接已复制到粘贴板!
- 描述
- AdditionalArgs 允许为 'Alertmanager' 容器设置附加参数。它旨在激活被专用配置选项不支持的隐藏标志。参数以 as-is 传递给 Alertmanager 容器,如果它们无效或未由给定 Alertmanager 版本支持,则可能会导致问题。
- 类型
-
数组
2.1.3. .spec.additionalArgs[] 复制链接链接已复制到粘贴板!
- 描述
- 参数作为 AdditionalArgs 列表的一部分。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 参数的名称,如 "scrape.discovery-reload-interval"。 |
|
|
| 参数值,如 30s。对于仅限名称的参数(如 --storage.tsdb.no-lockfile)可以为空。 |
2.1.4. .spec.affinity 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的调度限制。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 描述 pod 的节点关联性调度规则。 |
|
|
| 描述 pod 关联性调度规则(例如,将这个 pod 位于同一个节点、区等)中。 |
|
|
| 描述 pod 反关联性调度规则(例如,避免将此 pod 放置到同一个节点、区等)。 |
2.1.5. .spec.affinity.nodeAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 的节点关联性调度规则。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点,即对于满足所有调度要求(资源请求、必需关联表达式等)的每个节点,计算出一个总和总和总和总和(如果节点与相应的 matchExpressions 匹配),则计算总和最高的节点是最首选的。 |
|
|
| 空白的首选调度术语与带有隐式权重 0 (例如,它的一个 no-op)的所有对象匹配。空首选调度术语不匹配任何对象(例如,也是 no-op)。 |
|
|
| 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足(例如,由于更新),则系统可能或可能无法最终从其节点驱除 pod。 |
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选节点是具有最大权重总和的节点,即对于满足所有调度要求(资源请求、必需关联表达式等)的每个节点,计算出一个总和总和总和总和(如果节点与相应的 matchExpressions 匹配),则计算总和最高的节点是最首选的。
- 类型
-
array
- 描述
- 空白的首选调度术语与带有隐式权重 0 (例如,它的一个 no-op)的所有对象匹配。空首选调度术语不匹配任何对象(例如,也是 no-op)。
- 类型
-
object - 必填
-
preference -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 与对应权重关联的节点选择器术语。 |
|
|
| 与对应 nodeSelectorTerm 关联的权重,范围为 1-100。 |
- 描述
- 与对应权重关联的节点选择器术语。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 按节点标签划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| 按节点字段划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 按节点字段划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足(例如,由于更新),则系统可能或可能无法最终从其节点驱除 pod。
- 类型
-
object - 必填
-
nodeSelectorTerms
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。节点选择器术语列表。术语为 ORed。 |
|
|
| null 或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。 |
- 描述
- 必需。节点选择器术语列表。术语为 ORed。
- 类型
-
array
- 描述
- null 或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 按节点标签划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| 按节点字段划分的节点选择器要求列表。 |
|
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 按节点字段划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择器应用到的标签键。 |
|
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt. |
|
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,它将解释为整数。这个数组会在策略性合并补丁中被替换。 |
2.1.20. .spec.affinity.podAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 关联性调度规则(例如,将这个 pod 位于同一个节点、区等)中。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点(即,对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点,计算并迭代此字段元素,并在节点具有与对应 podAffinityTerm 匹配的 pod 时,将"weight"添加到总和(如果节点具有最高 podAffinityTerm)、具有最高总和最高的节点是首选。 |
|
|
| 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点,以查找最首选节点。 |
|
|
| 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足(例如,由于 pod 标签更新),则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表都会被交集,例如必须满足所有术语。 |
|
|
| 定义一组 pod (即,与给定命名空间相对 labelSelector 匹配的 labelSelector ),该 pod 应该与 pod 共同定位(反关联性)或没有共同定位(反关联性)的节点上运行,其中 co-located 在具有键 <topologyKey> 标签的节点上运行,它与其上运行一组 pod 的 pod 匹配。 |
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点(即,对于满足所有调度要求的节点(resource request、requiredDuringScheduling 关联性表达式等)的每个节点,计算并迭代此字段元素,并在节点具有与对应 podAffinityTerm 匹配的 pod 时,将"weight"添加到总和(如果节点具有最高 podAffinityTerm)、具有最高总和最高的节点是首选。
- 类型
-
array
- 描述
- 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点,以查找最首选节点。
- 类型
-
object - 必填
-
podAffinityTerm -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。与对应权重关联的 pod 关联性术语。 |
|
|
| 与对应的 podAffinityTerm 关联的权重,范围为 1-100。 |
- 描述
- 必需。与对应权重关联的 pod 关联性术语。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。 |
|
|
|
matchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
|
MismatchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union,namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存(反关联性),其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
- 描述
- 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的关联性要求在 pod 执行期间某一点满足(例如,由于 pod 标签更新),则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表都会被交集,例如必须满足所有术语。
- 类型
-
array
- 描述
- 定义一组 pod (即,与给定命名空间相对 labelSelector 匹配的 labelSelector ),该 pod 应该与 pod 共同定位(反关联性)或没有共同定位(反关联性)的节点上运行,其中 co-located 在具有键 <topologyKey> 标签的节点上运行,它与其上运行一组 pod 的 pod 匹配。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。 |
|
|
|
matchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
|
MismatchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union,namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存(反关联性),其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
- 描述
- 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.38. .spec.affinity.podAntiAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 反关联性调度规则(例如,避免将此 pod 放置到同一个节点、区等)。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 调度程序更喜欢将 pod 调度到满足此字段指定的反关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点,即对于满足所有调度要求(资源请求、requiredDuringScheduling 反关联性表达式等)的每个节点,计算通过此字段元素来计算总和总和(如果节点具有与对应的 podAffinityTerm 匹配的 pod)的总和。 |
|
|
| 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点,以查找最首选节点。 |
|
|
| 如果在调度时没有满足此字段指定的反关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的反关联性要求在 Pod 执行期间某一点满足(例如,由于 pod 标签更新),则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表都会被交集,例如必须满足所有术语。 |
|
|
| 定义一组 pod (即,与给定命名空间相对 labelSelector 匹配的 labelSelector ),该 pod 应该与 pod 共同定位(反关联性)或没有共同定位(反关联性)的节点上运行,其中 co-located 在具有键 <topologyKey> 标签的节点上运行,它与其上运行一组 pod 的 pod 匹配。 |
- 描述
- 调度程序更喜欢将 pod 调度到满足此字段指定的反关联性表达式的节点,但可能会选择违反一个或多个表达式的节点。最首选的节点是具有最大权重总和的节点,即对于满足所有调度要求(资源请求、requiredDuringScheduling 反关联性表达式等)的每个节点,计算通过此字段元素来计算总和总和(如果节点具有与对应的 podAffinityTerm 匹配的 pod)的总和。
- 类型
-
array
- 描述
- 所有匹配的 WeightedPodAffinityTerm 字段的权重添加到每个节点,以查找最首选节点。
- 类型
-
object - 必填
-
podAffinityTerm -
weight
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。与对应权重关联的 pod 关联性术语。 |
|
|
| 与对应的 podAffinityTerm 关联的权重,范围为 1-100。 |
- 描述
- 必需。与对应权重关联的 pod 关联性术语。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。 |
|
|
|
matchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
|
MismatchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union,namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存(反关联性),其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
- 描述
- 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的反关联性要求,则 pod 不会被调度到该节点上。如果此字段指定的反关联性要求在 Pod 执行期间某一点满足(例如,由于 pod 标签更新),则系统可能或可能无法最终从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表都会被交集,例如必须满足所有术语。
- 类型
-
array
- 描述
- 定义一组 pod (即,与给定命名空间相对 labelSelector 匹配的 labelSelector ),该 pod 应该与 pod 共同定位(反关联性)或没有共同定位(反关联性)的节点上运行,其中 co-located 在具有键 <topologyKey> 标签的节点上运行,它与其上运行一组 pod 的 pod 匹配。
- 类型
-
object - 必填
-
topologyKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。 |
|
|
|
matchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
|
MismatchLabelKeys 是一组 pod 标签键,用于选择要考虑哪些 pod。键用于从传入的 pod 标签中查找值,这些键值标签与 |
|
|
| 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。 |
|
|
| namespaces 指定术语应用到的命名空间名称的静态列表。术语应用到此字段中列出的命名空间的 union,namespaceSelector 选择的命名空间列表和 null namespaceSelector 表示 " this pod 的命名空间"。 |
|
|
| 此 pod 应该在指定命名空间中与 labelSelector 匹配的 pod 共存(反关联性),其中 co-located 定义为在运行所选 pod 的节点的值为 running 的节点上运行。不允许为空 topologyKey。 |
- 描述
- 对一组资源进行标签查询,本例中为 pod。如果为空,则此 PodAffinityTerm 与任何 Pod 匹配。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 术语适用的命名空间集合上的标签查询。术语应用于此字段选定的命名空间的 union,以及 namespaces 字段中列出的命名空间。null selector 和 null 或空命名空间列表表示"此 pod 的命名空间"。空选择器({})匹配所有命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.56. .spec.alertmanagerConfigMatcherStrategy 复制链接链接已复制到粘贴板!
- 描述
- AlertmanagerConfigMatcherStrategy 定义 AlertmanagerConfig 对象如何处理传入的警报。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| AlertmanagerConfigMatcherStrategyType 定义 AlertmanagerConfig 对象用来匹配路由和禁止规则中的警报的策略。
默认值为 |
2.1.57. .spec.alertmanagerConfigNamespaceSelector 复制链接链接已复制到粘贴板!
- 描述
- 为 AlertmanagerConfig 发现选择的命名空间。如果为 nil,则仅检查自己的命名空间。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.60. .spec.alertmanagerConfigSelector 复制链接链接已复制到粘贴板!
- 描述
- 要选择的 alertmanagerconfigs,用于合并并配置 Alertmanager。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.63. .spec.alertmanagerConfiguration 复制链接链接已复制到粘贴板!
- 描述
alertmanagerConfiguration 指定 Alertmanager 的配置。
如果定义,它优先于
configSecret字段。这是一个 实验性功能,它可能会以中断的方式改变任何即将推出的版本。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 定义 Alertmanager 配置的全局参数。 |
|
|
|
用于生成 Alertmanager 配置的 AlertmanagerConfig 资源的名称。它必须与 Alertmanager 对象在同一个命名空间中定义。Operator 不会为路由和禁止规则强制执行 |
|
|
| 自定义通知模板。 |
|
|
| SecretOrConfigMap 允许将数据指定为 Secret 或 ConfigMap。字段是互斥的。 |
2.1.64. .spec.alertmanagerConfiguration.global 复制链接链接已复制到粘贴板!
- 描述
- 定义 Alertmanager 配置的全局参数。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 客户端配置。 |
|
|
| JIRA 的默认配置。 |
|
|
| 默认 OpsGenie API 密钥。 |
|
|
| 默认 OpsGenie API URL。 |
|
|
| 默认 Pagerduty URL。 |
|
|
| 如果警报不包含 EndsAt,则 ResolveTimeout 是 alertmanager 使用的默认值,在此时间通过后,它可以声明警报作为解析(如果尚未更新)。这不会影响 Prometheus 的警报,因为它们始终包含 EndsAt。 |
|
|
| Rocket Chat 的默认配置。 |
|
|
| 默认 Slack API URL。 |
|
|
| 配置全局 SMTP 参数。 |
|
|
| 默认 Telegram 配置 |
|
|
| VictorOps 的默认配置。 |
|
|
| JIRA 的默认配置。 |
|
|
| 默认的 WeChat 配置 |
- 描述
- HTTP 客户端配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 客户端的授权标头配置。这与 BasicAuth 相互排斥,且只能从 Alertmanager v0.22+ 开始。 |
|
|
| 客户端的 basicAuth。这是与授权相互排斥的。如果定义了这两者,则 BasicAuth 优先。 |
|
|
| 包含客户端用于身份验证的 bearer 令牌的机密密钥。secret 需要与 Alertmanager 对象位于同一个命名空间中,并可以被 Prometheus Operator 访问。 |
|
|
| FollowRedirects 指定客户端是否应该遵循 HTTP 3xx 重定向。 |
|
|
|
它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
| 用于获取目标令牌的 OAuth2 客户端凭据。 |
|
|
| ProxyConnectHeader (可选)指定在 CONNECT 请求期间发送到代理的标头。 它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
| |
|
|
| SecretKeySelector 选择 Secret 的密钥。 |
|
|
| 是否使用由环境变量(HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY)定义的代理配置。 它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
|
|
|
|
| 客户端的 TLS 配置。 |
- 描述
- 客户端的授权标头配置。这与 BasicAuth 相互排斥,且只能从 Alertmanager v0.22+ 开始。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择命名空间中包含用于身份验证的凭证的 Secret 的键。 |
|
|
| 定义身份验证类型。该值不区分大小写。 "Basic" 是不支持的值。 默认:"Bearer" |
- 描述
- 选择命名空间中包含用于身份验证的凭证的 Secret 的键。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 客户端的 basicAuth。这是与授权相互排斥的。如果定义了这两者,则 BasicAuth 优先。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
|
|
|
|
|
- 描述
-
password指定包含用于身份验证的密码的 Secret 的键。 - 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
-
username指定包含用于身份验证的用户名的 Secret 的键。 - 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 包含客户端用于身份验证的 bearer 令牌的机密密钥。secret 需要与 Alertmanager 对象位于同一个命名空间中,并可以被 Prometheus Operator 访问。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 用于获取目标令牌的 OAuth2 客户端凭据。
- 类型
-
object - 必填
-
clientId -
clientSecret -
tokenUrl
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
| ProxyConnectHeader (可选)指定在 CONNECT 请求期间发送到代理的标头。 它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
| |
|
|
| SecretKeySelector 选择 Secret 的密钥。 |
|
|
| 是否使用由环境变量(HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY)定义的代理配置。 它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。 |
|
|
|
|
|
|
|
|
|
|
| 连接到 OAuth2 服务器时要使用的 TLS 配置。它需要 Prometheus >= v2.43.0。 |
|
|
|
|
- 描述
-
clientId指定包含 OAuth2 客户端 ID 的 Secret 或 ConfigMap 的键。 - 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
-
clientSecret指定包含 OAuth2 客户端 secret 的 Secret 的密钥。 - 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
ProxyConnectHeader (可选)指定在 CONNECT 请求期间发送到代理的标头。
它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。
- 类型
-
object
- 描述
- 类型
-
数组
- 描述
- SecretKeySelector 选择 Secret 的密钥。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 连接到 OAuth2 服务器时要使用的 TLS 配置。它需要 Prometheus >= v2.43.0。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 验证服务器证书时使用的证书颁发机构。 |
|
|
| 执行 client-authentication 时要出现的客户端证书。 |
|
|
| 禁用目标证书验证。 |
|
|
| 包含目标客户端密钥文件的 secret。 |
|
|
| 最大可接受的 TLS 版本。 它需要 Prometheus >= v2.41.0 或 Thanos >= v0.31.0。 |
|
|
| 最低可接受的 TLS 版本。 它需要 Prometheus >= v2.35.0 或 Thanos >= v0.28.0。 |
|
|
| 用于验证目标的主机名。 |
- 描述
- 验证服务器证书时使用的证书颁发机构。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 执行 client-authentication 时要出现的客户端证书。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 包含目标客户端密钥文件的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
ProxyConnectHeader (可选)指定在 CONNECT 请求期间发送到代理的标头。
它需要 Prometheus >= v2.43.0、Alertmanager >= v0.25.0 或 Thanos >= v0.32.0。
- 类型
-
object
- 描述
- 类型
-
数组
- 描述
- SecretKeySelector 选择 Secret 的密钥。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 客户端的 TLS 配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 验证服务器证书时使用的证书颁发机构。 |
|
|
| 执行 client-authentication 时要出现的客户端证书。 |
|
|
| 禁用目标证书验证。 |
|
|
| 包含目标客户端密钥文件的 secret。 |
|
|
| 最大可接受的 TLS 版本。 它需要 Prometheus >= v2.41.0 或 Thanos >= v0.31.0。 |
|
|
| 最低可接受的 TLS 版本。 它需要 Prometheus >= v2.35.0 或 Thanos >= v0.28.0。 |
|
|
| 用于验证目标的主机名。 |
- 描述
- 验证服务器证书时使用的证书颁发机构。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 执行 client-authentication 时要出现的客户端证书。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 包含目标客户端密钥文件的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.99. .spec.alertmanagerConfiguration.global.jira 复制链接链接已复制到粘贴板!
- 描述
- JIRA 的默认配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认 Jira API URL。 它需要 Alertmanager >= v0.28.0。 |
- 描述
- 默认 OpsGenie API 密钥。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 默认 OpsGenie API URL。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- Rocket Chat 的默认配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认 Rocket Chat API URL。 它需要 Alertmanager >= v0.28.0。 |
|
|
| 默认 Rocket Chat 令牌。 它需要 Alertmanager >= v0.28.0。 |
|
|
| 默认 Rocket Chat Token ID。 它需要 Alertmanager >= v0.28.0。 |
- 描述
默认 Rocket Chat 令牌。
它需要 Alertmanager >= v0.28.0。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
默认 Rocket Chat Token ID。
它需要 Alertmanager >= v0.28.0。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 默认 Slack API URL。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.106. .spec.alertmanagerConfiguration.global.smtp 复制链接链接已复制到粘贴板!
- 描述
- 配置全局 SMTP 参数。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 使用 PLAIN 的 SMTP Auth |
|
|
| 使用 LOGIN 和 PLAIN 的 SMTP 身份验证. |
|
|
| 使用 CRAM-MD5 的 SMTP 身份验证. |
|
|
| 使用 CRAM-MD5、LOGIN 和 PLAIN 的 SMTP 身份验证.如果为空,Alertmanager 不会向 SMTP 服务器进行身份验证。 |
|
|
| 默认 SMTP From 头字段。 |
|
|
| 要识别到 SMTP 服务器的默认主机名。 |
|
|
| 默认 SMTP TLS 要求。请注意,Go 不支持到远程 SMTP 端点的未加密的连接。 |
|
|
| 用于发送电子邮件的默认 SMTP 智能主机。 |
|
|
| SMTP 接收器的默认 TLS 配置 |
- 描述
- 使用 LOGIN 和 PLAIN 的 SMTP 身份验证.
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 使用 CRAM-MD5 的 SMTP 身份验证.
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 用于发送电子邮件的默认 SMTP 智能主机。
- 类型
-
object - 必填
-
主机 -
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 定义主机的地址,它可以是 DNS 名称或字面 IP 地址。 |
|
|
| 定义主机的端口,可以是字面端口号或端口名称。 |
- 描述
- SMTP 接收器的默认 TLS 配置
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 验证服务器证书时使用的证书颁发机构。 |
|
|
| 执行 client-authentication 时要出现的客户端证书。 |
|
|
| 禁用目标证书验证。 |
|
|
| 包含目标客户端密钥文件的 secret。 |
|
|
| 最大可接受的 TLS 版本。 它需要 Prometheus >= v2.41.0 或 Thanos >= v0.31.0。 |
|
|
| 最低可接受的 TLS 版本。 它需要 Prometheus >= v2.35.0 或 Thanos >= v0.28.0。 |
|
|
| 用于验证目标的主机名。 |
- 描述
- 验证服务器证书时使用的证书颁发机构。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 执行 client-authentication 时要出现的客户端证书。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
- 描述
- 包含目标客户端密钥文件的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.118. .spec.alertmanagerConfiguration.global.telegram 复制链接链接已复制到粘贴板!
- 描述
- 默认 Telegram 配置
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认 Telegram API URL。 它需要 Alertmanager >= v0.24.0。 |
- 描述
- VictorOps 的默认配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认 VictorOps API 密钥。 |
|
|
| 默认 VictorOps API URL。 |
- 描述
- 默认 VictorOps API 密钥。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.121. .spec.alertmanagerConfiguration.global.webex 复制链接链接已复制到粘贴板!
- 描述
- JIRA 的默认配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认 Webex API URL。 它需要 Alertmanager >= v0.25.0。 |
2.1.122. .spec.alertmanagerConfiguration.global.wechat 复制链接链接已复制到粘贴板!
- 描述
- 默认的 WeChat 配置
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 默认的 WeChat API Corporate ID。 |
|
|
| 默认的 WeChat API Secret。 |
|
|
| 默认的 WeChat API URL。默认值为 "https://qyapi.weixin.qq.com/cgi-bin/" |
- 描述
- 默认的 WeChat API Secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.124. .spec.alertmanagerConfiguration.templates 复制链接链接已复制到粘贴板!
- 描述
- 自定义通知模板。
- 类型
-
数组
2.1.125. .spec.alertmanagerConfiguration.templates[] 复制链接链接已复制到粘贴板!
- 描述
- SecretOrConfigMap 允许将数据指定为 Secret 或 ConfigMap。字段是互斥的。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.128. .spec.clusterTLS 复制链接链接已复制到粘贴板!
- 描述
为 Alertmanager 集群的 gosip 协议配置 mutual TLS 配置。
它需要 Alertmanager >= 0.24.0。
- 类型
-
object - 必填
-
client -
server
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| mutual TLS 的客户端配置。 |
|
|
| mutual TLS 的服务器端配置。 |
2.1.129. .spec.clusterTLS.client 复制链接链接已复制到粘贴板!
- 描述
- mutual TLS 的客户端配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 验证服务器证书时使用的证书颁发机构。 |
|
|
| 执行 client-authentication 时要出现的客户端证书。 |
|
|
| 禁用目标证书验证。 |
|
|
| 包含目标客户端密钥文件的 secret。 |
|
|
| 最大可接受的 TLS 版本。 它需要 Prometheus >= v2.41.0 或 Thanos >= v0.31.0。 |
|
|
| 最低可接受的 TLS 版本。 它需要 Prometheus >= v2.35.0 或 Thanos >= v0.28.0。 |
|
|
| 用于验证目标的主机名。 |
2.1.130. .spec.clusterTLS.client.ca 复制链接链接已复制到粘贴板!
- 描述
- 验证服务器证书时使用的证书颁发机构。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.131. .spec.clusterTLS.client.ca.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.132. .spec.clusterTLS.client.ca.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.133. .spec.clusterTLS.client.cert 复制链接链接已复制到粘贴板!
- 描述
- 执行 client-authentication 时要出现的客户端证书。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.134. .spec.clusterTLS.client.cert.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.135. .spec.clusterTLS.client.cert.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.136. .spec.clusterTLS.client.keySecret 复制链接链接已复制到粘贴板!
- 描述
- 包含目标客户端密钥文件的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.137. .spec.clusterTLS.server 复制链接链接已复制到粘贴板!
- 描述
- mutual TLS 的服务器端配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含 web 服务器的 TLS 证书的 secret 或 ConfigMap。
必须定义
它与 |
|
|
| Web 服务器的容器中的 TLS 证书文件的路径。
必须定义
它与证书 |
|
|
| TLS 版本支持的密码套件列表,最高为 TLS 1.2。 如果没有定义,则使用 Go 默认密码套件。可用的密码套件记录在 Go 文档中: https://golang.org/pkg/crypto/tls/#pkg-constants |
|
|
| 客户端 TLS 身份验证的服务器策略。 有关 clientAuth 选项的详情: https://golang.org/pkg/crypto/tls/#ClientAuthType |
|
|
| 服务器客户端证书身份验证的 CA 证书文件的路径。
它与 |
|
|
| 包含服务器客户端证书身份验证的 CA 证书的 secret 或 ConfigMap。
它与 |
|
|
| 按偏好顺序在 ECDHE 握手中使用的 Elliptic curves。 Go 文档中记录了可用的 curves :https://golang.org/pkg/crypto/tls/#CurveID |
|
|
| Web 服务器的容器中的 TLS 私钥文件的路径。
如果定义,则必须定义
它与 |
|
|
| 包含 web 服务器的 TLS 私钥的 secret。
必须定义
它与 |
|
|
| 可接受的最大 TLS 版本。 |
|
|
| 可以接受的最低 TLS 版本。 |
|
|
| 控制服务器是否选择客户端最首选密码套件,或者服务器最首选密码套件。 如果为 true,则使用服务器的首选项,如 cipherSuites 中的元素顺序表示。 |
2.1.138. .spec.clusterTLS.server.cert 复制链接链接已复制到粘贴板!
- 描述
包含 web 服务器的 TLS 证书的 secret 或 ConfigMap。
必须定义
keySecret或keyFile。它与
certFile相互排斥。- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.139. .spec.clusterTLS.server.cert.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.140. .spec.clusterTLS.server.cert.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.141. .spec.clusterTLS.server.client_ca 复制链接链接已复制到粘贴板!
- 描述
包含服务器客户端证书身份验证的 CA 证书的 secret 或 ConfigMap。
它与
clientCAFile相互排斥。- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.142. .spec.clusterTLS.server.client_ca.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.143. .spec.clusterTLS.server.client_ca.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.144. .spec.clusterTLS.server.keySecret 复制链接链接已复制到粘贴板!
- 描述
包含 web 服务器的 TLS 私钥的 secret。
必须定义
cert或certFile。它与
keyFile相互排斥。- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.145. .spec.containers 复制链接链接已复制到粘贴板!
- 描述
-
容器允许注入其他容器。这是允许向 Alertmanager pod 添加身份验证代理。这里描述的容器如果操作器共享相同的名称和修改,则修改通过战略合并补丁来完成。当前容器名称为:
alertmanager和config-reloader。覆盖容器完全超出维护人员将支持什么范围,通过这样做,您可以接受这种行为,而无需通知。 - 类型
-
array
2.1.146. .spec.containers[] 复制链接链接已复制到粘贴板!
- 描述
- 要在 pod 中运行的单一应用程序容器。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 入口点的参数。如果没有提供,则使用容器镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $,它用于转义 $(VAR_NAME)语法:即 " (VAR_NAME) " 将生成字符串 "$(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) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展,无论变量是否存在。无法更新。更多信息: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
|
| 容器中要设置的环境变量列表。无法更新。 |
|
|
| EnvVar 代表容器中存在的环境变量。 |
|
|
| 在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时,所有无效密钥都会被报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。 |
|
|
| EnvFromSource 代表一组 ConfigMap 或 Secret 的源 |
|
|
| 容器镜像名称。更多信息: https://kubernetes.io/docs/concepts/containers/images 此字段是可选的,允许更高级别的配置管理默认或覆盖工作负载控制器(如 Deployments 和 StatefulSets)中的容器镜像。 |
|
|
| 镜像拉取(pull)策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签,则默认为 Always,否则则默认为 IfNotPresent。无法更新。更多信息: https://kubernetes.io/docs/concepts/containers/images#updating-images |
|
|
| 管理系统应采取的操作来响应容器生命周期事件。无法更新。 |
|
|
| 容器存活度探测.如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 指定为 DNS_LABEL 的容器名称。pod 中的每个容器都必须具有唯一的名称(DNS_LABEL)。无法更新。 |
|
|
| 从容器公开的端口列表。这里没有指定端口不会阻止公开该端口。所有正在侦听容器内默认"0.0.0.0"地址的端口均可从网络访问。使用策略合并补丁修改阵列可能会破坏数据。如需更多信息,请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。 |
|
|
| containerPort 代表单个容器中的网络端口。 |
|
|
| 容器服务的定期探测到就绪状态。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 容器的资源重新定义策略。 |
|
|
| ContainerResizePolicy 代表容器的资源重新定义策略。 |
|
|
| 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| restartPolicy 定义 pod 中单个容器的重启行为。此字段只能为 init 容器设置,唯一允许的值是 "Always"。对于非init 容器或没有指定此字段时,重启行为由 Pod 的重启策略和容器类型定义。将 init 容器的 RestartPolicy 设置为 "Always" 将具有以下效果:此 init 容器将持续重启退出,直到所有常规容器都终止为止。所有常规容器完成后,所有带有 restartPolicy "Always" 的 init 容器都会被关闭。这个生命周期与普通 init 容器不同,通常被称为 "sidecar" 容器。虽然这个 init 容器仍然在 init 容器序列中启动,但它不会等待容器完成,然后才能进入下一个 init 容器。相反,下一个 init 容器会在此 init 容器启动后,或者在任何 startupProbe 成功完成后启动。 |
|
|
| securityContext 定义容器应运行的安全选项。如果设置,SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
|
| startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或温缓存时,而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 此容器是否应该在容器运行时中为 stdin 分配缓冲区。如果没有设置,则容器中的 stdin 读取将始终会导致 EOF。默认为 false。 |
|
|
| 容器运行时是否应在由单个附加打开后关闭 stdin 频道。当 stdin 为 true 时,stdin 流将在多个附加会话中保持打开状态。如果 stdinOnce 设为 true,则 stdin 会在容器启动时打开,直到第一个客户端附加到 stdin,然后保持打开并接受数据,直到客户端断开连接,此时 stdin 已关闭并保持关闭,直到容器重启为止。如果此标志为 false,则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false |
|
|
| 可选:将容器终止消息写入的文件的路径挂载到容器的文件系统中。编写的消息应当是最终状态,如断言失败消息。如果超过 4096 字节,节点将截断。所有容器的总消息长度将限制为 12kb。默认为 /dev/termination-log。无法更新。 |
|
|
| 指明应当如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功或失败时填充容器状态消息。如果终止消息文件为空,则 FallbackToLogsOnError 将使用容器日志输出的最后块,并且容器退出并显示错误。日志输出限制为 2048 字节或 80 行,以较小者。默认为 File。无法更新。 |
|
|
| 此容器是否应为自己分配 TTY,也要求 'stdin' 为 true。默认为 false。 |
|
|
| volumeDevices 是容器要使用的块设备列表。 |
|
|
| volumeDevice 描述了容器中原始块设备的映射。 |
|
|
| 要挂载到容器文件系统的 Pod 卷。无法更新。 |
|
|
| VolumeMount 描述了容器内卷挂载。 |
|
|
| 容器的工作目录。如果未指定,则将使用容器运行时的默认值,该默认值可能在容器镜像中配置。无法更新。 |
2.1.147. .spec.containers[].env 复制链接链接已复制到粘贴板!
- 描述
- 容器中要设置的环境变量列表。无法更新。
- 类型
-
array
2.1.148. .spec.containers[].env[] 复制链接链接已复制到粘贴板!
- 描述
- EnvVar 代表容器中存在的环境变量。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 环境变量的名称。必须是 C_IDENTIFIER。 |
|
|
| 变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量,则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $,它用于转义 $(VAR_NAME)语法:即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展,无论变量是否存在。默认为 ""。 |
|
|
| 环境变量的值的源。如果值不为空,则无法使用。 |
2.1.149. .spec.containers[].env[].valueFrom 复制链接链接已复制到粘贴板!
- 描述
- 环境变量的值的源。如果值不为空,则无法使用。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择 ConfigMap 的键。 |
|
|
|
选择 pod 的字段:支持 metadata.name、metadata.namespace、 |
|
|
| 选择容器的资源:当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。 |
|
|
| 在 pod 命名空间中选择 secret 的键 |
- 描述
- 选择 ConfigMap 的键。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.151. .spec.containers[].env[].valueFrom.fieldRef 复制链接链接已复制到粘贴板!
- 描述
-
选择 pod 的字段:支持 metadata.name、metadata.namespace、
metadata.labels['<KEY>'],metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs. - 类型
-
object - 必填
-
fieldPath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 模式的版本是按术语编写的 FieldPath,默认为 "v1"。 |
|
|
| 在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。
- 类型
-
object - 必填
-
resource
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 容器名称:卷需要,对于 env vars是可选的 |
|
|
| 指定公开资源的输出格式,默认为 "1" |
|
|
| 必需:要选择的资源 |
2.1.153. .spec.containers[].env[].valueFrom.secretKeyRef 复制链接链接已复制到粘贴板!
- 描述
- 在 pod 命名空间中选择 secret 的键
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.154. .spec.containers[].envFrom 复制链接链接已复制到粘贴板!
- 描述
- 在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时,所有无效密钥都会被报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。
- 类型
-
array
2.1.155. .spec.containers[].envFrom[] 复制链接链接已复制到粘贴板!
- 描述
- EnvFromSource 代表一组 ConfigMap 或 Secret 的源
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 ConfigMap |
|
|
| 要添加到每个环境变量的名称前的可选文本。必须是 C_IDENTIFIER。 |
|
|
| 要从中选择的 Secret |
2.1.156. .spec.containers[].envFrom[].configMapRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 ConfigMap
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap |
2.1.157. .spec.containers[].envFrom[].secretRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 Secret
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret |
2.1.158. .spec.containers[].lifecycle 复制链接链接已复制到粘贴板!
- 描述
- 管理系统应采取的操作来响应容器生命周期事件。无法更新。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| postStart 在容器被创建后立即调用。如果处理程序失败,则容器将根据其重启策略终止并重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
|
| preStop 在因为 API 请求或管理事件而终止容器前马上调用,如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出,则不会调用处理程序。Pod 的终止宽限期倒计时开始,然后再执行 PreStop hook。无论处理程序的结果是什么,容器最终都会在 Pod 的终止宽限期内终止(除非被终结器造成延迟)。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
|
| StopSignal 定义在容器停止时将哪些信号发送到容器。如果没有指定,则默认值由正在使用的容器运行时定义。StopSignal 只能为带有非空 .spec.os.name 的 Pod 设置 |
2.1.159. .spec.containers[].lifecycle.postStart 复制链接链接已复制到粘贴板!
- 描述
- postStart 在容器被创建后立即调用。如果处理程序失败,则容器将根据其重启策略终止并重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| sleep 代表容器应睡眠的持续时间。 |
|
|
| 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。 |
2.1.160. .spec.containers[].lifecycle.postStart.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.161. .spec.containers[].lifecycle.postStart.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.164. .spec.containers[].lifecycle.postStart.sleep 复制链接链接已复制到粘贴板!
- 描述
- sleep 代表容器应睡眠的持续时间。
- 类型
-
object - 必填
-
seconds
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| seconds 是睡眠的秒数。 |
- 描述
- 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.166. .spec.containers[].lifecycle.preStop 复制链接链接已复制到粘贴板!
- 描述
- preStop 在因为 API 请求或管理事件而终止容器前马上调用,如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出,则不会调用处理程序。Pod 的终止宽限期倒计时开始,然后再执行 PreStop hook。无论处理程序的结果是什么,容器最终都会在 Pod 的终止宽限期内终止(除非被终结器造成延迟)。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| sleep 代表容器应睡眠的持续时间。 |
|
|
| 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。 |
2.1.167. .spec.containers[].lifecycle.preStop.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.168. .spec.containers[].lifecycle.preStop.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.171. .spec.containers[].lifecycle.preStop.sleep 复制链接链接已复制到粘贴板!
- 描述
- sleep 代表容器应睡眠的持续时间。
- 类型
-
object - 必填
-
seconds
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| seconds 是睡眠的秒数。 |
2.1.172. .spec.containers[].lifecycle.preStop.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.173. .spec.containers[].livenessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器存活度探测.如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.174. .spec.containers[].livenessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.175. .spec.containers[].livenessProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.176. .spec.containers[].livenessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.179. .spec.containers[].livenessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.180. .spec.containers[].ports 复制链接链接已复制到粘贴板!
- 描述
- 从容器公开的端口列表。这里没有指定端口不会阻止公开该端口。所有正在侦听容器内默认"0.0.0.0"地址的端口均可从网络访问。使用策略合并补丁修改阵列可能会破坏数据。如需更多信息,请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。
- 类型
-
array
2.1.181. .spec.containers[].ports[] 复制链接链接已复制到粘贴板!
- 描述
- containerPort 代表单个容器中的网络端口。
- 类型
-
object - 必填
-
containerPort
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| pod IP 地址上公开的端口号。这必须是有效的端口号 0 < x < 65536。 |
|
|
| 将外部端口绑定到的主机 IP。 |
|
|
| 主机上公开的端口号。如果指定,这必须是有效的端口号 0 < x < 65536。如果指定了 HostNetwork,它必须与 ContainerPort 匹配。大多数容器都不需要这样做。 |
|
|
| 如果指定,这必须是 IANA_SVC_NAME,在 pod 中唯一。pod 中的每个命名端口都必须具有唯一的名称。服务可以引用的端口的名称。 |
|
|
| 端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。 |
2.1.182. .spec.containers[].readinessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器服务的定期探测到就绪状态。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.183. .spec.containers[].readinessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.184. .spec.containers[].readinessProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.185. .spec.containers[].readinessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.188. .spec.containers[].readinessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.189. .spec.containers[].resizePolicy 复制链接链接已复制到粘贴板!
- 描述
- 容器的资源重新定义策略。
- 类型
-
数组
2.1.190. .spec.containers[].resizePolicy[] 复制链接链接已复制到粘贴板!
- 描述
- ContainerResizePolicy 代表容器的资源重新定义策略。
- 类型
-
object - 必填
-
resourceName -
restartPolicy
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 此资源重新定义策略应用到的资源的名称。支持的值有:cpu、memory。 |
|
|
| 在指定资源调整大小时,重启策略会被应用。如果没有指定,则默认为 NotRequired。 |
2.1.191. .spec.containers[].resources 复制链接链接已复制到粘贴板!
- 描述
- 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。 这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。 此字段不可变。它只能为容器设置。 |
|
|
| ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。 |
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
2.1.192. .spec.containers[].resources.claims 复制链接链接已复制到粘贴板!
- 描述
claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。
这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。
此字段不可变。它只能为容器设置。
- 类型
-
数组
2.1.193. .spec.containers[].resources.claims[] 复制链接链接已复制到粘贴板!
- 描述
- ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。 |
|
|
| 在引用的声明中为请求选择请求的名称。如果为空,则提供声明中的所有内容,否则仅提供此请求的结果。 |
2.1.194. .spec.containers[].securityContext 复制链接链接已复制到粘贴板!
- 描述
- securityContext 定义容器应运行的安全选项。如果设置,SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| allowPrivilegeEscalation 控制进程是否可以比其父进程获得更多特权。此 bool 直接控制容器进程上是否设置了 no_new_privs 标志。当容器是 : 1)作为 CAP_SYS_ADMIN 具有 CAP_SYS_ADMIN 时,allowPrivilegeEscalation 始终为 true,请注意,当 spec.os.name 是 windows 时,不能设置此字段。 |
|
|
| appArmorProfile 是此容器使用的 AppArmor 选项。如果设置,此配置集会覆盖 pod 的 appArmorProfile。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 以特权模式运行容器。特权容器中的进程本质上等同于主机上的 root。默认为false。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| procMount 表示用于容器的 proc 挂载类型。默认值为 Default,它将容器运行时默认值用于只读路径和屏蔽的路径。这要求启用 ProcMountType 功能标记。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 此容器是否具有只读 root 文件系统。默认为 false。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 用于运行容器进程的入口点的 GID。如果未设置,则使用运行时默认。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不作为 UID 0 (root)运行,如果容器这样做,则无法启动容器。如果未设置或 false,则不会执行这样的验证。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
|
|
| 用于运行容器进程的入口点的 UID。如果未指定,则默认为在镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 此容器使用的 seccomp 选项。如果 seccomp 选项同时在 pod 和容器级别上提供,则容器选项会覆盖 pod 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 应用到所有容器的 Windows 特定设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。 |
- 描述
- appArmorProfile 是此容器使用的 AppArmor 选项。如果设置,此配置集会覆盖 pod 的 appArmorProfile。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示节点上载入的配置集。该配置集必须在节点上预先配置才能正常工作。必须与配置文件的加载名称匹配。只在 type 为 "Localhost" 时,才应设置。 |
|
|
| Type 表示将应用哪些类型的 AppArmor 配置集。有效选项包括: Localhost - 节点上的配置文件预加载。RuntimeDefault - 容器运行时的默认配置集。unconfined - 无 AppArmor 强制。 |
2.1.196. .spec.containers[].securityContext.capabilities 复制链接链接已复制到粘贴板!
- 描述
- 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 添加了功能 |
|
|
| 删除的功能 |
- 描述
- 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| level 是适用于容器的 SELinux 级别标签。 |
|
|
| role 是适用于容器的 SELinux 角色标签。 |
|
|
| type 是适用于容器的 SELinux 类型标签。 |
|
|
| user 是适用于容器的 SELinux 用户标签。 |
- 描述
- 此容器使用的 seccomp 选项。如果 seccomp 选项同时在 pod 和容器级别上提供,则容器选项会覆盖 pod 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示应使用节点上文件中定义的配置集。该配置集必须在节点上预先配置才能正常工作。必须是一个降序路径,相对于 kubelet 配置的 seccomp 配置集位置。如果类型为"Localhost",则必须设置。不得为任何其他类型设置。 |
|
|
| Type 表示将应用了哪些 seccomp 配置集。有效选项有: localhost - 应该使用节点上文件中定义的配置文件。RuntimeDefault - 应使用容器运行时默认配置集。unconfined - 不应应用配置集。 |
- 描述
- 应用到所有容器的 Windows 特定设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpec 命名的 GMSA 凭证规格的内容。 |
|
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
|
| HostProcess 确定容器是否应作为"主机进程"容器运行。所有 Pod 的容器都必须具有相同的有效的 HostProcess 值(不允许混合 HostProcess 容器和非主机进程容器)。另外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。 |
|
|
| Windows 中的 UserName,以运行容器进程的入口点。如果未指定,则默认为在镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
2.1.200. .spec.containers[].startupProbe 复制链接链接已复制到粘贴板!
- 描述
- startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或温缓存时,而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.201. .spec.containers[].startupProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.202. .spec.containers[].startupProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.203. .spec.containers[].startupProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.206. .spec.containers[].startupProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.207. .spec.containers[].volumeDevices 复制链接链接已复制到粘贴板!
- 描述
- volumeDevices 是容器要使用的块设备列表。
- 类型
-
array
2.1.208. .spec.containers[].volumeDevices[] 复制链接链接已复制到粘贴板!
- 描述
- volumeDevice 描述了容器中原始块设备的映射。
- 类型
-
object - 必填
-
devicePath -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DevicePath 是该设备要映射到的容器内的路径。 |
|
|
| name 必须与 pod 中 persistentVolumeClaim 的名称匹配 |
2.1.209. .spec.containers[].volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- 要挂载到容器文件系统的 Pod 卷。无法更新。
- 类型
-
array
2.1.210. .spec.containers[].volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷挂载。
- 类型
-
object - 必填
-
mountPath -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 应挂载卷的容器中的路径。不得包含 ':'。 |
|
|
| mountPropagation 决定挂载如何从主机传播到容器以及反向传播。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时,mountPropagation 必须是 None 或未指定(默认为 None)。 |
|
|
| 这必须与卷的 Name 匹配。 |
|
|
| 如果为 true,则以只读方式挂载,否则读写(false 或未指定)。默认为false。 |
|
|
| RecursiveReadOnly 指定是否应递归处理只读挂载。 如果 ReadOnly 为 false,则此字段没有意义,必须未指定。 如果 ReadOnly 为 true,且此字段设置为 Disabled,则不会递归只读挂载。如果将此字段设置为 IfPossible,则挂载将递归只读(如果容器运行时支持)。如果此字段设置为 Enabled,则挂载将在容器运行时支持时递归只读,否则不会启动 pod,并生成错误来指示原因。 如果将此字段设置为 IfPossible 或 Enabled,则 MountPropagation 必须设为 None (或未指定,默认为 None)。 如果没有指定此字段,它将被视为与 Disabled 的等效值。 |
|
|
| 应从中挂载容器卷的卷中的路径。默认为 "" (卷的 root)。 |
|
|
| 在应该挂载容器卷的卷中扩展路径。行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
2.1.211. .spec.dnsConfig 复制链接链接已复制到粘贴板!
- 描述
- 定义 pod 的 DNS 配置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DNS 名称服务器 IP 地址列表。这将附加到从 DNSPolicy 生成的基本名称服务器中。 |
|
|
| DNS 解析器选项列表。这将与 DNSPolicy 生成的基本选项合并。Options 中提供的解析选项将覆盖基本 DNSPolicy 中显示的选项。 |
|
|
| PodDNSConfigOption 定义 pod 的 DNS 解析器选项。 |
|
|
| 用于 host-name 查找的 DNS 搜索域列表。这将附加到从 DNSPolicy 生成的基本搜索路径中。 |
2.1.212. .spec.dnsConfig.options 复制链接链接已复制到粘贴板!
- 描述
- DNS 解析器选项列表。这将与 DNSPolicy 生成的基本选项合并。Options 中提供的解析选项将覆盖基本 DNSPolicy 中显示的选项。
- 类型
-
数组
2.1.213. .spec.dnsConfig.options[] 复制链接链接已复制到粘贴板!
- 描述
- PodDNSConfigOption 定义 pod 的 DNS 解析器选项。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 名称是必需的,且必须是唯一的。 |
|
|
| value 是可选的。 |
2.1.214. .spec.hostAliases 复制链接链接已复制到粘贴板!
- 描述
- Pod 的 hostAliases 配置
- 类型
-
数组
2.1.215. .spec.hostAliases[] 复制链接链接已复制到粘贴板!
- 描述
- HostAlias 包含 IP 和主机名之间的映射,这些映射将作为 pod 的主机文件中的条目注入。
- 类型
-
object - 必填
-
主机名 -
ip
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 以上 IP 地址的主机名。 |
|
|
| 主机文件条目的 IP 地址。 |
2.1.216. .spec.imagePullSecrets 复制链接链接已复制到粘贴板!
- 描述
- 从 registry 中对同一命名空间中的 secret 的引用列表,用于从 registry 中拉取 prometheus 和 alertmanager 镜像,请参阅 https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/
- 类型
-
array
2.1.217. .spec.imagePullSecrets[] 复制链接链接已复制到粘贴板!
- 描述
- LocalObjectReference 包含足够信息,供您在同一命名空间中找到引用的对象。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.218. .spec.initContainers 复制链接链接已复制到粘贴板!
- 描述
-
initContainers 允许将 initContainers 添加到 pod 定义中。它们可用于从外部来源获取用于注入 Alertmanager 配置的 secret。执行 initContainer 期间的任何错误将导致重启 Pod。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers如果操作器共享相同的名称和修改,则修改 Operator 生成的 init 容器(如果它们通过策略合并补丁完成)。当前 init 容器名称为:
init-config-reloader。覆盖 init 容器完全超出维护人员将支持什么范围,通过这样做,您接受的行为可能随时中断,而无需通知。 - 类型
-
array
2.1.219. .spec.initContainers[] 复制链接链接已复制到粘贴板!
- 描述
- 要在 pod 中运行的单一应用程序容器。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 入口点的参数。如果没有提供,则使用容器镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $,它用于转义 $(VAR_NAME)语法:即 " (VAR_NAME) " 将生成字符串 "$(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) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展,无论变量是否存在。无法更新。更多信息: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
|
| 容器中要设置的环境变量列表。无法更新。 |
|
|
| EnvVar 代表容器中存在的环境变量。 |
|
|
| 在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时,所有无效密钥都会被报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。 |
|
|
| EnvFromSource 代表一组 ConfigMap 或 Secret 的源 |
|
|
| 容器镜像名称。更多信息: https://kubernetes.io/docs/concepts/containers/images 此字段是可选的,允许更高级别的配置管理默认或覆盖工作负载控制器(如 Deployments 和 StatefulSets)中的容器镜像。 |
|
|
| 镜像拉取(pull)策略。Always, Never, IfNotPresent 之一。如果指定了 :latest 标签,则默认为 Always,否则则默认为 IfNotPresent。无法更新。更多信息: https://kubernetes.io/docs/concepts/containers/images#updating-images |
|
|
| 管理系统应采取的操作来响应容器生命周期事件。无法更新。 |
|
|
| 容器存活度探测.如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 指定为 DNS_LABEL 的容器名称。pod 中的每个容器都必须具有唯一的名称(DNS_LABEL)。无法更新。 |
|
|
| 从容器公开的端口列表。这里没有指定端口不会阻止公开该端口。所有正在侦听容器内默认"0.0.0.0"地址的端口均可从网络访问。使用策略合并补丁修改阵列可能会破坏数据。如需更多信息,请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。 |
|
|
| containerPort 代表单个容器中的网络端口。 |
|
|
| 容器服务的定期探测到就绪状态。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 容器的资源重新定义策略。 |
|
|
| ContainerResizePolicy 代表容器的资源重新定义策略。 |
|
|
| 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| restartPolicy 定义 pod 中单个容器的重启行为。此字段只能为 init 容器设置,唯一允许的值是 "Always"。对于非init 容器或没有指定此字段时,重启行为由 Pod 的重启策略和容器类型定义。将 init 容器的 RestartPolicy 设置为 "Always" 将具有以下效果:此 init 容器将持续重启退出,直到所有常规容器都终止为止。所有常规容器完成后,所有带有 restartPolicy "Always" 的 init 容器都会被关闭。这个生命周期与普通 init 容器不同,通常被称为 "sidecar" 容器。虽然这个 init 容器仍然在 init 容器序列中启动,但它不会等待容器完成,然后才能进入下一个 init 容器。相反,下一个 init 容器会在此 init 容器启动后,或者在任何 startupProbe 成功完成后启动。 |
|
|
| securityContext 定义容器应运行的安全选项。如果设置,SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
|
| startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或温缓存时,而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 此容器是否应该在容器运行时中为 stdin 分配缓冲区。如果没有设置,则容器中的 stdin 读取将始终会导致 EOF。默认为 false。 |
|
|
| 容器运行时是否应在由单个附加打开后关闭 stdin 频道。当 stdin 为 true 时,stdin 流将在多个附加会话中保持打开状态。如果 stdinOnce 设为 true,则 stdin 会在容器启动时打开,直到第一个客户端附加到 stdin,然后保持打开并接受数据,直到客户端断开连接,此时 stdin 已关闭并保持关闭,直到容器重启为止。如果此标志为 false,则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false |
|
|
| 可选:将容器终止消息写入的文件的路径挂载到容器的文件系统中。编写的消息应当是最终状态,如断言失败消息。如果超过 4096 字节,节点将截断。所有容器的总消息长度将限制为 12kb。默认为 /dev/termination-log。无法更新。 |
|
|
| 指明应当如何填充终止消息。文件将使用 terminationMessagePath 的内容在成功或失败时填充容器状态消息。如果终止消息文件为空,则 FallbackToLogsOnError 将使用容器日志输出的最后块,并且容器退出并显示错误。日志输出限制为 2048 字节或 80 行,以较小者。默认为 File。无法更新。 |
|
|
| 此容器是否应为自己分配 TTY,也要求 'stdin' 为 true。默认为 false。 |
|
|
| volumeDevices 是容器要使用的块设备列表。 |
|
|
| volumeDevice 描述了容器中原始块设备的映射。 |
|
|
| 要挂载到容器文件系统的 Pod 卷。无法更新。 |
|
|
| VolumeMount 描述了容器内卷挂载。 |
|
|
| 容器的工作目录。如果未指定,则将使用容器运行时的默认值,该默认值可能在容器镜像中配置。无法更新。 |
2.1.220. .spec.initContainers[].env 复制链接链接已复制到粘贴板!
- 描述
- 容器中要设置的环境变量列表。无法更新。
- 类型
-
array
2.1.221. .spec.initContainers[].env[] 复制链接链接已复制到粘贴板!
- 描述
- EnvVar 代表容器中存在的环境变量。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 环境变量的名称。必须是 C_IDENTIFIER。 |
|
|
| 变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量,则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $,它用于转义 $(VAR_NAME)语法:即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展,无论变量是否存在。默认为 ""。 |
|
|
| 环境变量的值的源。如果值不为空,则无法使用。 |
2.1.222. .spec.initContainers[].env[].valueFrom 复制链接链接已复制到粘贴板!
- 描述
- 环境变量的值的源。如果值不为空,则无法使用。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择 ConfigMap 的键。 |
|
|
|
选择 pod 的字段:支持 metadata.name、metadata.namespace、 |
|
|
| 选择容器的资源:当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。 |
|
|
| 在 pod 命名空间中选择 secret 的键 |
- 描述
- 选择 ConfigMap 的键。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.224. .spec.initContainers[].env[].valueFrom.fieldRef 复制链接链接已复制到粘贴板!
- 描述
-
选择 pod 的字段:支持 metadata.name、metadata.namespace、
metadata.labels['<KEY>'],metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs. - 类型
-
object - 必填
-
fieldPath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 模式的版本是按术语编写的 FieldPath,默认为 "v1"。 |
|
|
| 在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。
- 类型
-
object - 必填
-
resource
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 容器名称:卷需要,对于 env vars是可选的 |
|
|
| 指定公开资源的输出格式,默认为 "1" |
|
|
| 必需:要选择的资源 |
- 描述
- 在 pod 命名空间中选择 secret 的键
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.227. .spec.initContainers[].envFrom 复制链接链接已复制到粘贴板!
- 描述
- 在容器中填充环境变量的源列表。源中定义的键必须是 C_IDENTIFIER。当容器启动时,所有无效密钥都会被报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。
- 类型
-
array
2.1.228. .spec.initContainers[].envFrom[] 复制链接链接已复制到粘贴板!
- 描述
- EnvFromSource 代表一组 ConfigMap 或 Secret 的源
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 ConfigMap |
|
|
| 要添加到每个环境变量的名称前的可选文本。必须是 C_IDENTIFIER。 |
|
|
| 要从中选择的 Secret |
2.1.229. .spec.initContainers[].envFrom[].configMapRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 ConfigMap
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap |
2.1.230. .spec.initContainers[].envFrom[].secretRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 Secret
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret |
2.1.231. .spec.initContainers[].lifecycle 复制链接链接已复制到粘贴板!
- 描述
- 管理系统应采取的操作来响应容器生命周期事件。无法更新。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| postStart 在容器被创建后立即调用。如果处理程序失败,则容器将根据其重启策略终止并重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
|
| preStop 在因为 API 请求或管理事件而终止容器前马上调用,如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出,则不会调用处理程序。Pod 的终止宽限期倒计时开始,然后再执行 PreStop hook。无论处理程序的结果是什么,容器最终都会在 Pod 的终止宽限期内终止(除非被终结器造成延迟)。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
|
| StopSignal 定义在容器停止时将哪些信号发送到容器。如果没有指定,则默认值由正在使用的容器运行时定义。StopSignal 只能为带有非空 .spec.os.name 的 Pod 设置 |
2.1.232. .spec.initContainers[].lifecycle.postStart 复制链接链接已复制到粘贴板!
- 描述
- postStart 在容器被创建后立即调用。如果处理程序失败,则容器将根据其重启策略终止并重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| sleep 代表容器应睡眠的持续时间。 |
|
|
| 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。 |
2.1.233. .spec.initContainers[].lifecycle.postStart.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
- 描述
- sleep 代表容器应睡眠的持续时间。
- 类型
-
object - 必填
-
seconds
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| seconds 是睡眠的秒数。 |
- 描述
- 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.239. .spec.initContainers[].lifecycle.preStop 复制链接链接已复制到粘贴板!
- 描述
- preStop 在因为 API 请求或管理事件而终止容器前马上调用,如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出,则不会调用处理程序。Pod 的终止宽限期倒计时开始,然后再执行 PreStop hook。无论处理程序的结果是什么,容器最终都会在 Pod 的终止宽限期内终止(除非被终结器造成延迟)。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| sleep 代表容器应睡眠的持续时间。 |
|
|
| 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。 |
2.1.240. .spec.initContainers[].lifecycle.preStop.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.244. .spec.initContainers[].lifecycle.preStop.sleep 复制链接链接已复制到粘贴板!
- 描述
- sleep 代表容器应睡眠的持续时间。
- 类型
-
object - 必填
-
seconds
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| seconds 是睡眠的秒数。 |
- 描述
- 已弃用。tcpSocket 不支持作为 LifecycleHandler,并保持向后兼容性。指定时,没有此字段的验证,生命周期 hook 会在运行时失败。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.246. .spec.initContainers[].livenessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器存活度探测.如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.247. .spec.initContainers[].livenessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.248. .spec.initContainers[].livenessProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.249. .spec.initContainers[].livenessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.252. .spec.initContainers[].livenessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.253. .spec.initContainers[].ports 复制链接链接已复制到粘贴板!
- 描述
- 从容器公开的端口列表。这里没有指定端口不会阻止公开该端口。所有正在侦听容器内默认"0.0.0.0"地址的端口均可从网络访问。使用策略合并补丁修改阵列可能会破坏数据。如需更多信息,请参阅 https://github.com/kubernetes/kubernetes/issues/108255。无法更新。
- 类型
-
array
2.1.254. .spec.initContainers[].ports[] 复制链接链接已复制到粘贴板!
- 描述
- containerPort 代表单个容器中的网络端口。
- 类型
-
object - 必填
-
containerPort
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| pod IP 地址上公开的端口号。这必须是有效的端口号 0 < x < 65536。 |
|
|
| 将外部端口绑定到的主机 IP。 |
|
|
| 主机上公开的端口号。如果指定,这必须是有效的端口号 0 < x < 65536。如果指定了 HostNetwork,它必须与 ContainerPort 匹配。大多数容器都不需要这样做。 |
|
|
| 如果指定,这必须是 IANA_SVC_NAME,在 pod 中唯一。pod 中的每个命名端口都必须具有唯一的名称。服务可以引用的端口的名称。 |
|
|
| 端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。 |
2.1.255. .spec.initContainers[].readinessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器服务的定期探测到就绪状态。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.256. .spec.initContainers[].readinessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.257. .spec.initContainers[].readinessProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.258. .spec.initContainers[].readinessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.261. .spec.initContainers[].readinessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.262. .spec.initContainers[].resizePolicy 复制链接链接已复制到粘贴板!
- 描述
- 容器的资源重新定义策略。
- 类型
-
数组
2.1.263. .spec.initContainers[].resizePolicy[] 复制链接链接已复制到粘贴板!
- 描述
- ContainerResizePolicy 代表容器的资源重新定义策略。
- 类型
-
object - 必填
-
resourceName -
restartPolicy
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 此资源重新定义策略应用到的资源的名称。支持的值有:cpu、memory。 |
|
|
| 在指定资源调整大小时,重启策略会被应用。如果没有指定,则默认为 NotRequired。 |
2.1.264. .spec.initContainers[].resources 复制链接链接已复制到粘贴板!
- 描述
- 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。 这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。 此字段不可变。它只能为容器设置。 |
|
|
| ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。 |
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
2.1.265. .spec.initContainers[].resources.claims 复制链接链接已复制到粘贴板!
- 描述
claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。
这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。
此字段不可变。它只能为容器设置。
- 类型
-
数组
2.1.266. .spec.initContainers[].resources.claims[] 复制链接链接已复制到粘贴板!
- 描述
- ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。 |
|
|
| 在引用的声明中为请求选择请求的名称。如果为空,则提供声明中的所有内容,否则仅提供此请求的结果。 |
2.1.267. .spec.initContainers[].securityContext 复制链接链接已复制到粘贴板!
- 描述
- securityContext 定义容器应运行的安全选项。如果设置,SecurityContext 的字段会覆盖 PodSecurityContext 的等效字段。更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| allowPrivilegeEscalation 控制进程是否可以比其父进程获得更多特权。此 bool 直接控制容器进程上是否设置了 no_new_privs 标志。当容器是 : 1)作为 CAP_SYS_ADMIN 具有 CAP_SYS_ADMIN 时,allowPrivilegeEscalation 始终为 true,请注意,当 spec.os.name 是 windows 时,不能设置此字段。 |
|
|
| appArmorProfile 是此容器使用的 AppArmor 选项。如果设置,此配置集会覆盖 pod 的 appArmorProfile。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 以特权模式运行容器。特权容器中的进程本质上等同于主机上的 root。默认为false。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| procMount 表示用于容器的 proc 挂载类型。默认值为 Default,它将容器运行时默认值用于只读路径和屏蔽的路径。这要求启用 ProcMountType 功能标记。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 此容器是否具有只读 root 文件系统。默认为 false。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 用于运行容器进程的入口点的 GID。如果未设置,则使用运行时默认。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不作为 UID 0 (root)运行,如果容器这样做,则无法启动容器。如果未设置或 false,则不会执行这样的验证。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
|
|
| 用于运行容器进程的入口点的 UID。如果未指定,则默认为在镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 此容器使用的 seccomp 选项。如果 seccomp 选项同时在 pod 和容器级别上提供,则容器选项会覆盖 pod 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 应用到所有容器的 Windows 特定设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。 |
- 描述
- appArmorProfile 是此容器使用的 AppArmor 选项。如果设置,此配置集会覆盖 pod 的 appArmorProfile。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示节点上载入的配置集。该配置集必须在节点上预先配置才能正常工作。必须与配置文件的加载名称匹配。只在 type 为 "Localhost" 时,才应设置。 |
|
|
| Type 表示将应用哪些类型的 AppArmor 配置集。有效选项包括: Localhost - 节点上的配置文件预加载。RuntimeDefault - 容器运行时的默认配置集。unconfined - 无 AppArmor 强制。 |
- 描述
- 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 添加了功能 |
|
|
| 删除的功能 |
- 描述
- 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| level 是适用于容器的 SELinux 级别标签。 |
|
|
| role 是适用于容器的 SELinux 角色标签。 |
|
|
| type 是适用于容器的 SELinux 类型标签。 |
|
|
| user 是适用于容器的 SELinux 用户标签。 |
- 描述
- 此容器使用的 seccomp 选项。如果 seccomp 选项同时在 pod 和容器级别上提供,则容器选项会覆盖 pod 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示应使用节点上文件中定义的配置集。该配置集必须在节点上预先配置才能正常工作。必须是一个降序路径,相对于 kubelet 配置的 seccomp 配置集位置。如果类型为"Localhost",则必须设置。不得为任何其他类型设置。 |
|
|
| Type 表示将应用了哪些 seccomp 配置集。有效选项有: localhost - 应该使用节点上文件中定义的配置文件。RuntimeDefault - 应使用容器运行时默认配置集。unconfined - 不应应用配置集。 |
- 描述
- 应用到所有容器的 Windows 特定设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpec 命名的 GMSA 凭证规格的内容。 |
|
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
|
| HostProcess 确定容器是否应作为"主机进程"容器运行。所有 Pod 的容器都必须具有相同的有效的 HostProcess 值(不允许混合 HostProcess 容器和非主机进程容器)。另外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。 |
|
|
| Windows 中的 UserName,以运行容器进程的入口点。如果未指定,则默认为在镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
2.1.273. .spec.initContainers[].startupProbe 复制链接链接已复制到粘贴板!
- 描述
- startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或温缓存时,而不是在 steady-state 操作过程中提供不同的探测参数。这不能更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| exec 指定要在容器中执行的命令。 |
|
|
| 在成功后,探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
|
| GRPC 指定 GRPC HealthCheckRequest。 |
|
|
| httpGet 指定要执行的 HTTP GET 请求。 |
|
|
| 容器启动存活度探测前的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
|
| 在失败后,探测至少连续成功会被视为成功。默认为 1。对于存活度和启动,必须为 1。最小值为 1。 |
|
|
| tcpSocket 指定到 TCP 端口的连接。 |
|
|
| pod 在探测失败时安全终止所需的可选持续时间(以秒为单位)。宽限期是 pod 中运行的进程发送终止信号和进程被强制停止使用 kill 信号的时间(以秒为单位)。为您的进程设置这个值超过预期清理时间。如果这个值是 nil,则使用 pod 的 terminationGracePeriodSeconds。否则,这个值会覆盖 pod 规格提供的值。值必须是非负整数。值为零表示立即通过终止信号停止(没有关闭的机会)。这是一个 beta 字段,需要启用 ProbeTerminationGracePeriod 功能门。如果未设置,则使用最小值为 1. spec.terminationGracePeriodSeconds。 |
|
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
2.1.274. .spec.initContainers[].startupProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- exec 指定要在容器中执行的命令。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 命令是在容器内执行的命令行,而 命令的工作目录是容器文件系统中的 root ('/')。命令只是 exec'd,它不会在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用该 shell。0 的退出状态被视为 live/healthy,非零不健康。 |
2.1.275. .spec.initContainers[].startupProbe.grpc 复制链接链接已复制到粘贴板!
- 描述
- GRPC 指定 GRPC HealthCheckRequest。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| gRPC 服务的端口号。number 必须在 1 到 65535 之间。 |
|
|
| service 是要放入 gRPC HealthCheckRequest 中的服务名称(请参阅 https://github.com/grpc/grpc/blob/master/doc/health-checking.md)。 如果没有指定,则默认行为由 gRPC 定义。 |
2.1.276. .spec.initContainers[].startupProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 HTTP GET 请求。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要连接到的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置"主机"。 |
|
|
| 在请求中设置的自定义标头。HTTP 允许重复的标头。 |
|
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
|
| 在 HTTP 服务器上访问的路径。 |
|
|
| 用于访问容器的端口的名称或编号。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 在请求中设置的自定义标头。HTTP 允许重复的标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 标头字段名称。这将在输出时规范,因此理解 case-variant 名称与相同的标头一样。 |
|
|
| 标头字段值 |
2.1.279. .spec.initContainers[].startupProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定到 TCP 端口的连接。
- 类型
-
object - 必填
-
port
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
|
| 用于访问容器的端口的编号或名称。number 必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
2.1.280. .spec.initContainers[].volumeDevices 复制链接链接已复制到粘贴板!
- 描述
- volumeDevices 是容器要使用的块设备列表。
- 类型
-
array
2.1.281. .spec.initContainers[].volumeDevices[] 复制链接链接已复制到粘贴板!
- 描述
- volumeDevice 描述了容器中原始块设备的映射。
- 类型
-
object - 必填
-
devicePath -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DevicePath 是该设备要映射到的容器内的路径。 |
|
|
| name 必须与 pod 中 persistentVolumeClaim 的名称匹配 |
2.1.282. .spec.initContainers[].volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- 要挂载到容器文件系统的 Pod 卷。无法更新。
- 类型
-
array
2.1.283. .spec.initContainers[].volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷挂载。
- 类型
-
object - 必填
-
mountPath -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 应挂载卷的容器中的路径。不得包含 ':'。 |
|
|
| mountPropagation 决定挂载如何从主机传播到容器以及反向传播。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时,mountPropagation 必须是 None 或未指定(默认为 None)。 |
|
|
| 这必须与卷的 Name 匹配。 |
|
|
| 如果为 true,则以只读方式挂载,否则读写(false 或未指定)。默认为false。 |
|
|
| RecursiveReadOnly 指定是否应递归处理只读挂载。 如果 ReadOnly 为 false,则此字段没有意义,必须未指定。 如果 ReadOnly 为 true,且此字段设置为 Disabled,则不会递归只读挂载。如果将此字段设置为 IfPossible,则挂载将递归只读(如果容器运行时支持)。如果此字段设置为 Enabled,则挂载将在容器运行时支持时递归只读,否则不会启动 pod,并生成错误来指示原因。 如果将此字段设置为 IfPossible 或 Enabled,则 MountPropagation 必须设为 None (或未指定,默认为 None)。 如果没有指定此字段,它将被视为与 Disabled 的等效值。 |
|
|
| 应从中挂载容器卷的卷中的路径。默认为 "" (卷的 root)。 |
|
|
| 在应该挂载容器卷的卷中扩展路径。行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
2.1.284. .spec.limits 复制链接链接已复制到粘贴板!
- 描述
- 定义启动 Alertmanager 时的限制命令行标志。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
存储在磁盘上单个静默的最大大小。这与 Alertmanager 的- |
|
|
|
活跃和待处理静默的最大数量。这与 Alertmanager 的- |
2.1.285. .spec.persistentVolumeClaimRetentionPolicy 复制链接链接已复制到粘贴板!
- 描述
- 字段控制 StatefulSet 生命周期中是否和如何删除 PVC。所有 PVC 的默认行为都会被保留。这是 kubernetes 1.23 的 alpha 字段,直到 1.26 和来自 1.26 的 beta 字段。它需要启用 StatefulSetAutoDeletePVC 功能门。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
WhenDeleted 指定在 StatefulSet 被删除时从 StatefulSet VolumeClaimTemplates 创建的 PVC 发生的情况。 |
|
|
|
WhenScaled 指定在 StatefulSet 缩减时从 StatefulSet VolumeClaimTemplates 创建的 PVC 发生的情况。 |
2.1.286. .spec.podMetadata 复制链接链接已复制到粘贴板!
- 描述
podMetadata 配置传播到 Alertmanager pod 的标签和注解。
以下项目会被保留且无法覆盖:* "alertmanager" 标签,设置为 Alertmanager 实例的名称。* "app.kubernetes.io/instance" 标签,设置为 Alertmanager 实例的名称。* "app.kubernetes.io/managed-by" 标签,设置为 "prometheus-operator"。* "app.kubernetes.io/name" 标签,设置为 "alertmanager"。* "app.kubernetes.io/version" 标签,设置为 Alertmanager 版本。* "kubectl.kubernetes.io/default-container" 注解,设置为 "alertmanager"。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| annotations 是一个无结构的键值映射,它存储有资源,可通过外部工具存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ |
|
|
| 可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ |
|
|
| 名称在命名空间中必须是唯一的。创建资源时需要一些资源,但有些资源可能会允许客户端自动请求生成适当名称。name 主要用于创建 idempotence 和配置定义。无法更新。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/ |
2.1.287. .spec.resources 复制链接链接已复制到粘贴板!
- 描述
- 为单个 Pod 定义资源请求和限值。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。 这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。 此字段不可变。它只能为容器设置。 |
|
|
| ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。 |
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
2.1.288. .spec.resources.claims 复制链接链接已复制到粘贴板!
- 描述
claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。
这是一个 alpha 字段,需要启用 DynamicResourceAllocation 功能门。
此字段不可变。它只能为容器设置。
- 类型
-
数组
2.1.289. .spec.resources.claims[] 复制链接链接已复制到粘贴板!
- 描述
- ResourceClaim 引用 PodSpec.ResourceClaims 中的一个条目。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。 |
|
|
| 在引用的声明中为请求选择请求的名称。如果为空,则提供声明中的所有内容,否则仅提供此请求的结果。 |
2.1.290. .spec.securityContext 复制链接链接已复制到粘贴板!
- 描述
- securityContext 包含 pod 级别的安全属性和通用容器设置。默认为默认的 PodSecurityContext。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| appArmorProfile 是此 pod 中的容器使用的 AppArmor 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 适用于 pod 中所有容器的特殊补充组。有些卷类型允许 Kubelet 将该卷的所有权更改为由 pod 所有: 1.拥有的 GID 为 FSGroup 2。设置 setgid 位(卷中创建的新文件将归 FSGroup 所有)3。权限位是 OR'd with rw-rw--- 如果未设置,Kubelet 不会修改任何卷的所有权和权限。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| fsGroupChangePolicy 定义在 Pod 内公开卷之前更改卷的所有权和权限的行为。此字段将只适用于支持基于 fsGroup 的所有权(和权限)的卷类型。它对临时卷类型没有影响,如 secret、configmap 和 emptydir。有效值为 "OnRootMismatch" 和 "Always"。如果没有指定,则使用 "Always"。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 用于运行容器进程的入口点的 GID。如果未设置,则使用运行时默认。还可能会在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值优先于该容器。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不作为 UID 0 (root)运行,如果容器这样做,则无法启动容器。如果未设置或 false,则不会执行这样的验证。还可能会在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
|
|
| 用于运行容器进程的入口点的 UID。如果未指定,则默认为在镜像元数据中指定的用户。还可能会在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值优先于该容器。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| seLinuxChangePolicy 定义容器的 SELinux 标签如何应用到 Pod 使用的所有卷。它不会影响不支持 SELinux 或卷的节点不支持 SELinux。有效值为 "MountOption" 和 "Recursive"。 "递归"意味着通过容器运行时重新标记所有 Pod 卷上的所有文件。对于大型卷,这可能会较慢,但允许将特权和非特权 Pod 在同一节点上共享同一卷。
"MountOption"使用 如果没有指定,并且启用了 SELinuxMount 功能门,则使用 "MountOption"。如果没有指定,并且 SELinuxMount 功能门被禁用,则"MountOption"用于 ReadWriteOncePod 卷,对所有其他卷使用 "Recursive"。 此字段仅影响设置了 SELinux 标签的 Pod,可以是 PodSecurityContext 或所有容器的 SecurityContext。 所有使用同一卷的 Pod 都应该使用相同的 seLinuxChangePolicy,否则一些 pod 可能会处于 ContainerCreating 状态。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 要应用到所有容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。还可能会在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值优先于该容器。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 此 pod 中容器使用的 seccomp 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 应用到每个容器的主 GID 和 fsGroup (如果指定)中运行的组的列表。如果启用了 SupplementalGroupsPolicy 功能,supplementalGroupsPolicy 字段决定是否除了容器镜像中定义的组成员资格外。如果未指定,则不会添加任何其他组,但仍可使用容器镜像中定义的组成员资格,具体取决于 supplementalGroupsPolicy 字段。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| 定义如何计算第一个容器进程的补充组。有效值为 "Merge" 和 "Strict"。如果没有指定,则使用 "Merge"。(alpha)使用字段需要启用 SupplementalGroupsPolicy 功能门,且容器运行时必须实现对此功能的支持。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| sysctl 包含用于 pod 的命名空间 sysctl 列表。带有不支持 sysctl (容器运行时)的 Pod 可能无法启动。请注意,当 spec.os.name 是 windows 时无法设置此字段。 |
|
|
| sysctl 定义要设置的内核参数 |
|
|
| 应用到所有容器的 Windows 特定设置。如果未指定,则使用容器的 SecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。 |
2.1.291. .spec.securityContext.appArmorProfile 复制链接链接已复制到粘贴板!
- 描述
- appArmorProfile 是此 pod 中的容器使用的 AppArmor 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示节点上载入的配置集。该配置集必须在节点上预先配置才能正常工作。必须与配置文件的加载名称匹配。只在 type 为 "Localhost" 时,才应设置。 |
|
|
| Type 表示将应用哪些类型的 AppArmor 配置集。有效选项包括: Localhost - 节点上的配置文件预加载。RuntimeDefault - 容器运行时的默认配置集。unconfined - 无 AppArmor 强制。 |
2.1.292. .spec.securityContext.seLinuxOptions 复制链接链接已复制到粘贴板!
- 描述
- 要应用到所有容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。还可能会在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值优先于该容器。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| level 是适用于容器的 SELinux 级别标签。 |
|
|
| role 是适用于容器的 SELinux 角色标签。 |
|
|
| type 是适用于容器的 SELinux 类型标签。 |
|
|
| user 是适用于容器的 SELinux 用户标签。 |
2.1.293. .spec.securityContext.seccompProfile 复制链接链接已复制到粘贴板!
- 描述
- 此 pod 中容器使用的 seccomp 选项。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
object - 必填
-
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| localhostProfile 表示应使用节点上文件中定义的配置集。该配置集必须在节点上预先配置才能正常工作。必须是一个降序路径,相对于 kubelet 配置的 seccomp 配置集位置。如果类型为"Localhost",则必须设置。不得为任何其他类型设置。 |
|
|
| Type 表示将应用了哪些 seccomp 配置集。有效选项有: localhost - 应该使用节点上文件中定义的配置文件。RuntimeDefault - 应使用容器运行时默认配置集。unconfined - 不应应用配置集。 |
2.1.294. .spec.securityContext.sysctls 复制链接链接已复制到粘贴板!
- 描述
- sysctl 包含用于 pod 的命名空间 sysctl 列表。带有不支持 sysctl (容器运行时)的 Pod 可能无法启动。请注意,当 spec.os.name 是 windows 时无法设置此字段。
- 类型
-
array
2.1.295. .spec.securityContext.sysctls[] 复制链接链接已复制到粘贴板!
- 描述
- sysctl 定义要设置的内核参数
- 类型
-
object - 必填
-
name -
value
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要设置的属性的名称 |
|
|
| 要设置的属性值 |
2.1.296. .spec.securityContext.windowsOptions 复制链接链接已复制到粘贴板!
- 描述
- 应用到所有容器的 Windows 特定设置。如果未指定,则使用容器的 SecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。请注意,当 spec.os.name 是 linux 时,不能设置此字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpec 命名的 GMSA 凭证规格的内容。 |
|
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
|
| HostProcess 确定容器是否应作为"主机进程"容器运行。所有 Pod 的容器都必须具有相同的有效的 HostProcess 值(不允许混合 HostProcess 容器和非主机进程容器)。另外,如果 HostProcess 为 true,则 HostNetwork 也必须设置为 true。 |
|
|
| Windows 中的 UserName,以运行容器进程的入口点。如果未指定,则默认为在镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 中指定的值具有优先权。 |
2.1.297. .spec.storage 复制链接链接已复制到粘贴板!
- 描述
- 存储是 Alertmanager 实例如何使用存储的定义。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 弃用: 在以后的发行版本中会删除 subPath 用量。 |
|
|
|
StatefulSet 使用的 EmptyDirVolumeSource。如果指定,它优先于 |
|
|
| StatefulSet 使用的 EphemeralVolumeSource。这是 k8s 1.21 和 1.15 中的 beta 字段。对于较低版本,从 k8s 1.19 开始,它需要启用 GenericEphemeralVolume 功能门。更多信息: https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes |
|
|
| 定义 Prometheus StatefulSets 使用的 PVC spec。使用无法自动置备的卷的最简单方法是使用带有手动创建的 PersistentVolume 的标签选择器。 |
2.1.298. .spec.storage.emptyDir 复制链接链接已复制到粘贴板!
- 描述
-
StatefulSet 使用的 EmptyDirVolumeSource。如果指定,它优先于
ephemeral和volumeClaimTemplate。更多信息: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir - 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Medium 代表存储介质类型应支持这个目录。默认值为 "",这意味着使用节点的默认介质。必须是空字符串(默认)或 Memory。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
|
| sizeLimit 是这个 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存用量的最大使用量为此处指定的 SizeLimit 和 pod 中所有容器的内存限值总和。默认值为 nil,这意味着限制未定义。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
2.1.299. .spec.storage.ephemeral 复制链接链接已复制到粘贴板!
- 描述
- StatefulSet 使用的 EphemeralVolumeSource。这是 k8s 1.21 和 1.15 中的 beta 字段。对于较低版本,从 k8s 1.19 开始,它需要启用 GenericEphemeralVolume 功能门。更多信息: https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,即 PVC 将与 pod 一起删除。PVC 的名称将是 < 具有名称不归 pod 所有的现有 PVC 将不会 用于 pod,以避免错误地使用不相关的卷。然后,启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用这样的预先创建的 PVC,则必须在 pod 存在后使用对 pod 的所有者引用来更新 PVC。通常,这应该不需要,但手动重建一个有问题的集群时可能会很有用。 此字段是只读的,Kubernetes 在创建后不会对 PVC 进行任何更改。 必需,不能是 nil。 |
2.1.300. .spec.storage.ephemeral.volumeClaimTemplate 复制链接链接已复制到粘贴板!
- 描述
将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,即 PVC 将与 pod 一起删除。PVC 的名称将是 <
pod name>-<volume name>,其中<volumename> 是PodSpec.Volumes数组条目中的名称。如果串联的名称对 PVC 无效(例如,太长),pod 验证将拒绝 pod。具有名称不归 pod 所有的现有 PVC 将不会 用于 pod,以避免错误地使用不相关的卷。然后,启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用这样的预先创建的 PVC,则必须在 pod 存在后使用对 pod 的所有者引用来更新 PVC。通常,这应该不需要,但手动重建一个有问题的集群时可能会很有用。
此字段是只读的,Kubernetes 在创建后不会对 PVC 进行任何更改。
必需,不能是 nil。
- 类型
-
object - 必填
-
spec
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可能包含创建 PVC 时将复制到 PVC 的标签和注解。不允许其他字段,并在验证过程中被拒绝。 |
|
|
| PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。 |
- 描述
- 可能包含创建 PVC 时将复制到 PVC 的标签和注解。不允许其他字段,并在验证过程中被拒绝。
- 类型
-
object
- 描述
- PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accessModes 包含卷应具有所需的访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
|
| Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。 |
|
|
| 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
|
|
| resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
|
| selector 是要考虑绑定的卷的标签查询。 |
|
|
| storageClassName 是声明所需的 StorageClass 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
|
| volumeAttributesClassName 可用于设置此声明使用的 VolumeAttributesClass。如果指定,CSI 驱动程序将使用对应的 VolumeAttributesClass 中定义的属性创建或更新卷。这有一个不同于 storageClassName 的目的,可在创建声明后更改。空字符串表示,不会将 VolumeAttributesClass 应用到声明,但不允许在设置后将此字段重置为空字符串。如果未指定,并且 PersistentVolumeClaim 为 unbound,则 persistentvolume 控制器将设置默认的 VolumeAttributesClass (如果存在)。如果 volumeAttributesClass 引用的资源不存在,则这个 PersistentVolumeClaim 将被设置为 Pending 状态,如 modifyVolumeStatus 字段反映,直到资源存在为止。更多信息:https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) 使用此字段需要启用 VolumeAttributesClass 功能门(默认为关闭)。 |
|
|
| volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时,文件系统的值会被表示。 |
|
|
| volumeName 是对此声明支持的 PersistentVolume 的绑定引用。 |
- 描述
- Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
- 描述
- 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
|
|
| 命名空间是被引用的资源的命名空间,请注意,当指定命名空间时,引用命名空间中需要一个 gateway.networking.k8s.io/ReferenceGrant 对象来允许该命名空间的所有者接受引用。详情请查看 ReferenceGrant 文档。(alpha)此字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
- 描述
- resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
- 描述
- selector 是要考虑绑定的卷的标签查询。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
数组
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.309. .spec.storage.volumeClaimTemplate 复制链接链接已复制到粘贴板!
- 描述
- 定义 Prometheus StatefulSets 使用的 PVC spec。使用无法自动置备的卷的最简单方法是使用带有手动创建的 PersistentVolume 的标签选择器。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
| EmbeddedMetadata 包含与 EmbeddedResource 相关的元数据。 |
|
|
| 定义 Pod 作者请求的卷所需的特征。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
|
| deprecated: 此字段永不设置。 |
2.1.310. .spec.storage.volumeClaimTemplate.metadata 复制链接链接已复制到粘贴板!
- 描述
- EmbeddedMetadata 包含与 EmbeddedResource 相关的元数据。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| annotations 是一个无结构的键值映射,它存储有资源,可通过外部工具存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ |
|
|
| 可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ |
|
|
| 名称在命名空间中必须是唯一的。创建资源时需要一些资源,但有些资源可能会允许客户端自动请求生成适当名称。name 主要用于创建 idempotence 和配置定义。无法更新。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/ |
2.1.311. .spec.storage.volumeClaimTemplate.spec 复制链接链接已复制到粘贴板!
- 描述
- 定义 Pod 作者请求的卷所需的特征。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accessModes 包含卷应具有所需的访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
|
| Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。 |
|
|
| 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
|
|
| resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
|
| selector 是要考虑绑定的卷的标签查询。 |
|
|
| storageClassName 是声明所需的 StorageClass 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
|
| volumeAttributesClassName 可用于设置此声明使用的 VolumeAttributesClass。如果指定,CSI 驱动程序将使用对应的 VolumeAttributesClass 中定义的属性创建或更新卷。这有一个不同于 storageClassName 的目的,可在创建声明后更改。空字符串表示,不会将 VolumeAttributesClass 应用到声明,但不允许在设置后将此字段重置为空字符串。如果未指定,并且 PersistentVolumeClaim 为 unbound,则 persistentvolume 控制器将设置默认的 VolumeAttributesClass (如果存在)。如果 volumeAttributesClass 引用的资源不存在,则这个 PersistentVolumeClaim 将被设置为 Pending 状态,如 modifyVolumeStatus 字段反映,直到资源存在为止。更多信息:https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) 使用此字段需要启用 VolumeAttributesClass 功能门(默认为关闭)。 |
|
|
| volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时,文件系统的值会被表示。 |
|
|
| volumeName 是对此声明支持的 PersistentVolume 的绑定引用。 |
- 描述
- Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
- 描述
- 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
|
|
| 命名空间是被引用的资源的命名空间,请注意,当指定命名空间时,引用命名空间中需要一个 gateway.networking.k8s.io/ReferenceGrant 对象来允许该命名空间的所有者接受引用。详情请查看 ReferenceGrant 文档。(alpha)此字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
- 描述
- resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
2.1.315. .spec.storage.volumeClaimTemplate.spec.selector 复制链接链接已复制到粘贴板!
- 描述
- selector 是要考虑绑定的卷的标签查询。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.318. .spec.storage.volumeClaimTemplate.status 复制链接链接已复制到粘贴板!
- 描述
- deprecated: 此字段永不设置。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accessModes 包含 PVC 支持的卷的实际访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
|
| allocatedResourceStatuses 存储给定 PVC 的大小的资源状态。键名称遵循标准 Kubernetes 标签语法。有效值为:* Un-prefixed 键: - storage - 卷的容量。* 自定义资源除了以上值外还必须使用实现的前缀名称,如 "example.com/my-custom-resource" - 没有前缀或具有 kubernetes.io 前缀的键被视为是保留的键,因此可能不能使用它们。 ClaimResourceStatus 可以是以下状态: - ControllerResizeInProgress: 当重新定义 control-plane 大小调整卷大小时设置的状态。- ControllerResizeFailed: 在重新定义控制器大小失败并带有终止性错误时设置的状态。- NodeResizePending: 当重新定义控制器调整卷的大小结束,但节点上需要进一步重新定义卷大小是设置的状态。- NodeResizeInProgress: 当 kubelet 开始重新定义卷的大小时设置的状态。- NodeResizeFailed: 当 kubelet 中调整大小失败并带有终止性错误时设置的状态。临时错误不会设置 NodeResizeFailed。例如:如果为一个 PVC 扩展更多容量 - 此字段可以是以下状态之一: - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress" - pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed"。如果这个字段没有设置,意味着,给定 PVC 没有调整大小的操作。 接收之前未知 resourceName 或 ClaimResourceStatus 的 PVC 更新的控制器应忽略更新,这符合设计的用途。例如 - 仅负责重新定义卷大小调整容量的控制器,应忽略更改与 PVC 相关的其他有效资源的 PVC 更新。 这是一个 alpha 字段,需要启用 RecoverVolumeExpansionFailure 功能。 |
|
|
| allocatedResources 跟踪分配给 PVC 的资源,包括其容量。键名称遵循标准 Kubernetes 标签语法。有效值为:* Un-prefixed 键: - storage - 卷的容量。* 自定义资源除了以上值外还必须使用实现的前缀名称,如 "example.com/my-custom-resource" - 没有前缀或具有 kubernetes.io 前缀的键被视为是保留的键,因此可能不能使用它们。 当请求卷扩展操作时,此处报告的容量可能大于实际容量。对于存储配额,使用来自 allocatedResources 和 PVC.spec.resources 的值。如果没有设置 allocatedResources,则单独使用 PVC.spec.resources 进行配额计算。如果卷扩展容量请求被较低,则只有当没有进行中的扩展操作或当实际卷容量相等或低于请求的容量时,才会降低 allocatedResources。 接收之前未知 resourceName 或 的 PVC 更新的控制器应忽略更新,这符合设计的用途。例如 - 仅负责重新定义卷大小调整容量的控制器,应忽略更改与 PVC 相关的其他有效资源的 PVC 更新。 这是一个 alpha 字段,需要启用 RecoverVolumeExpansionFailure 功能。 |
|
|
| capacity 代表底层卷的实际资源。 |
|
|
| conditions 是持久性卷声明的当前条件。如果底层持久性卷被调整大小,则条件将设置为 'Resizing'。 |
|
|
| PersistentVolumeClaimCondition 包含有关 pvc 状态的详细信息 |
|
|
| currentVolumeAttributesClassName 是 PVC 正在使用的 VolumeAttributesClass 的当前名称。如果未设置时,没有应用到此 PersistentVolumeClaim 的 VolumeAttributeClass。这是一个 beta 字段,需要默认启用 VolumeAttributesClass 功能(默认关闭)。 |
|
|
| ModifyVolumeStatus 代表 ControllerModifyVolume 操作的状态对象。当这未设置时,不会尝试 ModifyVolume 操作。这是一个 beta 字段,需要启用 VolumeAttributesClass 功能(默认关闭)。 |
|
|
| phase 代表 PersistentVolumeClaim 的当前阶段。 |
- 描述
- conditions 是持久性卷声明的当前条件。如果底层持久性卷被调整大小,则条件将设置为 'Resizing'。
- 类型
-
array
- 描述
- PersistentVolumeClaimCondition 包含有关 pvc 状态的详细信息
- 类型
-
object - 必填
-
status -
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| lastProbeTime 是我们探测到条件的时间。 |
|
|
| lastTransitionTime 是条件从一个状态转换到另一个状态的时间。 |
|
|
| Message 是人类可读的消息,指示最后一次转换的详细信息。 |
|
|
| reason 是唯一的,这应该是一个简短的机器理解的字符串,给出了条件最后一次转换的原因。如果报告"Resizing",则表示已调整底层持久性卷的大小。 |
|
|
| status 是条件的状态。可以是 True, False, Unknown。更多信息:https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#:~:text=state%20of%20pvc-,conditions.status,-(string)%2C%20required |
|
|
|
- 描述
- ModifyVolumeStatus 代表 ControllerModifyVolume 操作的状态对象。当这未设置时,不会尝试 ModifyVolume 操作。这是一个 beta 字段,需要启用 VolumeAttributesClass 功能(默认关闭)。
- 类型
-
object - 必填
-
status
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| status 是 ControllerModifyVolume 操作的状态。它可以处于以下任何状态: - Pending Pending 表示因为没有满足的要求(如指定的 VolumeAttributesClass 不存在)PersistentVolumeClaim 不能被修改 - InProgress InProgress 表示卷正在被修改。- Infeasible Infeasible 代表 CSI 驱动程序已拒绝了请求。要解决错误,需要指定一个有效的 VolumeAttributesClass。注:新状态可以在以后添加。消费者应检查未知状态和失败的情况。 |
|
|
| targetVolumeAttributesClassName 是当前被协调的 PVC 的 VolumeAttributesClass 的名称 |
2.1.322. .spec.tolerations 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的容限。
- 类型
-
array
2.1.323. .spec.tolerations[] 复制链接链接已复制到粘贴板!
- 描述
- 此 Toleration 附加到 pod,以使用匹配的 operator <operator> 容许与 triple <key,value,effect> 匹配的任何污点。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后,允许的值为 NoSchedule,PreferNoSchedule 和 NoExecute。 |
|
|
| key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空,则必须存在运算符;组合意味着匹配所有值和所有键。 |
|
|
| Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符,以便 pod 可以容忍特定类别的所有污点。 |
|
|
| tolerationSeconds 代表容限的期间(必须生效 NoExecute,否则此字段将被忽略)可以容忍污点。默认情况下,它不会被设置,这意味着容许任何污点(不要驱除)。零值和负值将被视为 0 (立即删除)。 |
|
|
| value 是容限匹配的污点值。如果运算符是 Exists,则该值应该为空,否则仅是一个常规字符串。 |
2.1.324. .spec.topologySpreadConstraints 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的拓扑分布限制。
- 类型
-
array
2.1.325. .spec.topologySpreadConstraints[] 复制链接链接已复制到粘贴板!
- 描述
- TopologySpreadConstraint 指定如何在给定的拓扑中分布匹配的 pod。
- 类型
-
object - 必填
-
maxSkew -
topologyKey -
whenUnsatisfiable
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算,以确定其对应拓扑域中的 pod 数量。 |
|
|
| matchLabelKeys 是一组 pod 标签键,用于选择要在其中计算分布的 pod。这些键用于从传入的 pod 标签中查找值,这些键值标签由 labelSelector 匹配,以选择现有 pod 的组,用于为传入的 pod 计算。匹配键被禁止在 MatchLabelKeys 和 LabelSelector 中。当 LabelSelector 没有设置时,无法设置 matchLabelKeys。传入的 pod 标签中不存在的键将被忽略。null 或空列表表示仅与 labelSelector 匹配。 这是一个 beta 字段,需要启用 MatchLabelKeysInPodTopologySpread 功能门(默认启用)。 |
|
|
|
maxSkew 描述了 pod 可能没有被均匀分布的程度。当 |
|
|
| MinDomains 表示合格的域数量。当具有匹配拓扑键的合格域数量小于 minDomains 时,Pod Topology Spread 会将"global minimum"视为 0,然后执行 Skew 的计算。当匹配拓扑键等于或大于 minDomains 的合格域数量时,这个值不会影响调度。因此,当有资格的域数量小于 minDomains 时,调度程序不会将超过 maxSkew Pod 的调度到这些域。如果值为 nil,则约束的行为就像 MinDomains 等于 1 一样。有效值为大于 0 的整数。如果值不是 nil,WhenUnsatisfiable 必须是 DoNotSchedule。 例如,在一个 3 个区集群中,MaxSkew 设置为 2,MinDomains 被设置为 5,且带有与 2/2/2: | zone1 | zone2 | zone2 | zone2 | zone3 | P P | P | P P | P P | P P | P P | 数量的域的数量小于 5 (MinDomains),因此"global minimum"被视为 0。在这种情况下,如果新 Pod 调度到任何三个区域,则无法调度具有相同 labelSelector 的新 pod,因为 computed skew 将为 3 (3 - 0),它将违反 MaxSkew。 |
|
|
| NodeAffinityPolicy 表示在计算 pod 拓扑分布偏移时,我们将如何处理 Pod 的 nodeAffinity/nodeSelector。选项为:- Honor:只有与 nodeAffinity/nodeSelector 匹配的节点才会包含在计算中。- Ignore: nodeAffinity/nodeSelector 会被忽略。所有节点都包含在计算中。 如果这个值是 nil,则行为等同于 Honor 策略。 |
|
|
| NodeTaintsPolicy 指示在计算 pod 拓扑分布偏移时如何对待节点污点。选项为:- Honor: 没有污点的节点,以及传入的 pod 具有容限的污点节点。- Ignore: node taint are ignored.所有节点都包括在内。 如果这个值是 nil,则行为等同于 Ignore 策略。 |
|
|
| topologyKey 是节点标签的密钥。带有具有此键和相同值标签的节点被视为在同一拓扑中。我们把每个 <key, value> 视为 "bucket",并尝试将均衡的 pod 数量放在每个存储桶中。我们将域定义为拓扑的特定实例。另外,我们将一个有资格的域定义为节点满足 nodeAffinityPolicy 和 nodeTaintsPolicy 的要求的域。例如,如果 TopologyKey 为 "kubernetes.io/hostname",则每个节点都是该拓扑的域。如果 TopologyKey 是 "topology.kubernetes.io/zone",每个区都是该拓扑的域。这是必填字段。 |
|
|
| whenUnsatisfiable 表示如何在不满足分散约束的情况下处理 pod。- DoNotSchedule (default)告知调度程序不调度它。- ScheduleAnyway 告知调度程序将 pod 调度到任何位置,但为拓扑赋予更高优先级,有助于减少偏差。如果每个可能的节点分配都会在某些拓扑上违反"MaxSkew",则约束被视为"不satisfiable"。例如,在一个 3 区集群中,MaxSkew 设置为 1,而具有与 3/1/1: | zone1 | zone2 | zone2 | zone3 | P P | P | P | P | P | P | P | P | P | WhenUnsatisfiable 设置为 DoNotSchedule 的 pod 只能调度到 zone2 (zone3)要成为 3/2/1 (3/1/2),在 zone2 (zone3)中以 ActualSkew (2-1)满足 MaxSkew (1)。换句话说,集群仍然可以实现平衡,但调度程序不会使其更不平衡。这是必填字段。 |
2.1.326. .spec.topologySpreadConstraints[].labelSelector 复制链接链接已复制到粘贴板!
- 描述
- labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算,以确定其对应拓扑域中的 pod 数量。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.329. .spec.volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- volumeMounts 允许在输出 StatefulSet 定义上配置额外的 VolumeMount。指定 volumeMounts 将附加到 alertmanager 容器中的其他 VolumeMount,这些 VolumeMount 会根据 StorageSpec 对象生成的。
- 类型
-
array
2.1.330. .spec.volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷挂载。
- 类型
-
object - 必填
-
mountPath -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 应挂载卷的容器中的路径。不得包含 ':'。 |
|
|
| mountPropagation 决定挂载如何从主机传播到容器以及反向传播。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。当 RecursiveReadOnly 设置为 IfPossible 或 Enabled 时,mountPropagation 必须是 None 或未指定(默认为 None)。 |
|
|
| 这必须与卷的 Name 匹配。 |
|
|
| 如果为 true,则以只读方式挂载,否则读写(false 或未指定)。默认为false。 |
|
|
| RecursiveReadOnly 指定是否应递归处理只读挂载。 如果 ReadOnly 为 false,则此字段没有意义,必须未指定。 如果 ReadOnly 为 true,且此字段设置为 Disabled,则不会递归只读挂载。如果将此字段设置为 IfPossible,则挂载将递归只读(如果容器运行时支持)。如果此字段设置为 Enabled,则挂载将在容器运行时支持时递归只读,否则不会启动 pod,并生成错误来指示原因。 如果将此字段设置为 IfPossible 或 Enabled,则 MountPropagation 必须设为 None (或未指定,默认为 None)。 如果没有指定此字段,它将被视为与 Disabled 的等效值。 |
|
|
| 应从中挂载容器卷的卷中的路径。默认为 "" (卷的 root)。 |
|
|
| 在应该挂载容器卷的卷中扩展路径。行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
2.1.331. .spec.volumes 复制链接链接已复制到粘贴板!
- 描述
- 卷允许在输出 StatefulSet 定义中配置额外的卷。指定的卷将附加到作为 StorageSpec 对象生成的其他卷。
- 类型
-
array
2.1.332. .spec.volumes[] 复制链接链接已复制到粘贴板!
- 描述
- 卷代表 pod 中的指定卷,可以被 pod 中的任何容器访问。
- 类型
-
object - 必填
-
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| awsElasticBlockStore 代表一个 AWS Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。弃用:AWSElasticBlockStore 已被弃用。in-tree awsElasticBlockStore 类型的所有操作都会重定向到 ebs.csi.aws.com CSI 驱动程序。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
|
| azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。已弃用:AzureDisk 已被弃用。in-tree azureDisk 类型的所有操作都会重定向到 disk.csi.azure.com CSI 驱动程序。 |
|
|
| azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。已弃用:AzureFile 已被弃用。in-tree azureFile 类型的所有操作都会重定向到 file.csi.azure.com CSI 驱动程序。 |
|
|
| CephFS 代表共享 pod 生命周期的主机上的 Ceph FS 挂载。弃用:CephFS 已被弃用,in-tree cephfs 类型不再被支持。 |
|
|
| Cinder 代表附加并挂载到 kubelet 主机机器上的 cinder 卷。已弃用:Cinder 已被弃用。in-tree cinder 类型的所有操作都会重定向到 cinder.csi.openstack.org CSI 驱动程序。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
|
| ConfigMap 代表应填充此卷的 configMap |
|
|
| CSI (Container Storage Interface)代表由某些外部 CSI 驱动程序处理的临时存储。 |
|
|
| downwardAPI 代表应填充此卷的 pod 的 Downward API |
|
|
| emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
|
| ephemeral 代表由集群存储驱动程序处理的卷。卷的生命周期与定义它的 pod 关联 - 将在 pod 启动前创建,并在 pod 被删除时删除。 如果 pod 运行(如需要从快照或容量跟踪中恢复)正常卷时,才需要这个卷。c)通过存储类指定存储驱动程序,以及 d)存储驱动程序支持通过 PersistentVolumeClaim 进行动态卷置备(请参阅 EphemeralVolumeSource 以了解有关这个卷类型和 PersistentVolumeClaim 间的连接的更多信息。 对于保留的时间超过单个 pod 的生命周期,使用 PersistentVolumeClaim 或特定于供应商的 API 之一。 如果使用 CSI 驱动程序,使用 CSI 驱动程序来轻量级本地临时卷 - 如需更多信息,请参阅驱动程序文档。 pod 可以同时使用两种类型的临时卷和持久性卷。 |
|
|
| FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。 |
|
|
| FlexVolume 代表使用基于 exec 的插件置备的/附加的通用卷资源。已弃用:FlexVolume 已被弃用。考虑使用 CSIDriver 替代。 |
|
|
| flocker 代表附加到 kubelet 主机机器的 Flocker 卷。这取决于正在运行的 Flocker 控制服务。已弃用:Flocker 已弃用,in-tree flocker 类型不再被支持。 |
|
|
| gcePersistentDisk 代表一个 GCE Disk 资源,该资源附加到 kubelet 的主机机器,然后公开给 pod。已弃用: GCEPersistentDisk 已被弃用。树内 gcePersistentDisk 类型的所有操作都会重定向到 pd.csi.storage.gke.io CSI 驱动程序。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
| gitRepo 代表特定修订版本中的 git 存储库。deprecated: GitRepo 已被弃用。要使用 git 存储库置备容器,请将 EmptyDir 挂载到使用 git 克隆存储库的 InitContainer 中,然后将 EmptyDir 挂载到 Pod 的容器中。 |
|
|
| GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。已弃用: Glusterfs 已被弃用,in-tree glusterfs 类型不再被支持。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md |
|
|
| hostpath 代表主机机器上直接公开给容器的已存在的文件或目录。这通常用于系统代理或其他允许查看主机机器的特权事情。大多数容器都不需要这样做。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
|
| Image 代表一个 OCI 对象(容器镜像或工件)拉取并挂载到 kubelet 的主机机器上。根据提供 PullPolicy 值,卷会在 pod 启动时解析: - always :kubelet 始终会尝试拉取引用。如果拉取失败,则容器会失败。- Never: kubelet 永不拉取引用,只使用本地镜像或工件。如果引用不存在,则容器创建会失败。- 如果不是Present:kubelet 会拉取(如果磁盘上不存在引用)。如果引用不存在,则容器创建会失败,拉取会失败。 如果 pod 被删除并重新创建,则卷会被重新解析,这意味着新的远程内容将在 pod 重新创建时可用。在 pod 启动期间无法解析或拉取镜像将阻止容器启动,并可能会增加大量延迟。故障将使用正常的卷 backoff 重试,并将报告在 pod 原因和消息上。此卷可以挂载的对象类型由主机机器上的容器运行时实施定义,至少必须包含容器镜像字段支持的所有有效类型。通过合并清单层与容器镜像相同,OCI 对象会被挂载到单个目录中(spec.containers[].volumeMounts.mountPath)。该卷将被挂载为只读(ro)和不可执行的文件(noexec)。在 1.33 之前,不支持容器的子路径挂载(spec.containers[].volumeMounts.subpath)。字段 spec.securityContext.fsGroupChangePolicy 对这个卷类型没有影响。 |
|
|
| iSCSI 代表附加到 kubelet 主机机器的 ISCSI Disk 资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md |
|
|
| 卷的名称。必须是 DNS_LABEL,且必须在 pod 中唯一。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| NFS 代表共享 pod 生命周期更多信息的主机上 NFS 挂载: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
|
| persistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
|
| photonPersistentDisk 代表附加并挂载到 kubelets 主机上的 PhotonController 持久磁盘。弃用: PhotonPersistentDisk 已被弃用,in-tree photonPersistentDisk 类型不再被支持。 |
|
|
| portworxVolume 代表附加并挂载到 kubelets 主机上的 portworx 卷。已弃用:PortworxVolume 已被弃用。当 CSIMigrationPortworx feature-gate 为 on 时,in-tree portworxVolume 类型的所有操作都会被重定向到 pxd.portworx.com CSI 驱动程序。 |
|
|
| 一个资源 secret、configmap 和 Downward API 中所有的项目项目 |
|
|
| quobyte 代表共享 pod 生命周期的主机上执行 Quobyte 挂载。已弃用:Quobyte 已弃用,in-tree Quobyte 类型不再被支持。 |
|
|
| RBD 代表共享 pod 生命周期的主机上 Rados 块设备挂载。已弃用:RBD 已被弃用,in-tree rbd 类型不再被支持。更多信息: https://examples.k8s.io/volumes/rbd/README.md |
|
|
| scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。已弃用:ScaleIO 已被弃用,in-tree scaleIO 类型不再被支持。 |
|
|
| Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret |
|
|
| storageos 代表附加并挂载到 Kubernetes 节点上的 StorageOS 卷。已弃用:StorageOS 已被弃用,in-tree storageos 类型不再被支持。 |
|
|
| vsphereVolume 代表附加并挂载到 kubelets 主机上的 vSphere 卷。已弃用:VsphereVolume 已被弃用。in-tree vsphereVolume 类型的所有操作都会重定向到 csi.vsphere.vmware.com CSI 驱动程序。 |
2.1.333. .spec.volumes[].awsElasticBlockStore 复制链接链接已复制到粘贴板!
- 描述
- awsElasticBlockStore 代表一个 AWS Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。弃用:AWSElasticBlockStore 已被弃用。in-tree awsElasticBlockStore 类型的所有操作都会重定向到 ebs.csi.aws.com CSI 驱动程序。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
- 类型
-
object - 必填
-
volumeID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是您要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为 "ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
|
| partition 是您要挂载的卷中的分区。如果省略,则默认使用卷名称来挂载。示例: 对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷分区是"0" (或者您可以将属性留空)。 |
|
|
| readonly 值 true 将强制 VolumeMount 中的 readOnly 设置。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
|
| VolumeId 是 AWS (Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
2.1.334. .spec.volumes[].azureDisk 复制链接链接已复制到粘贴板!
- 描述
- azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。已弃用:AzureDisk 已被弃用。in-tree azureDisk 类型的所有操作都会重定向到 disk.csi.azure.com CSI 驱动程序。
- 类型
-
object - 必填
-
diskName -
diskURI
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| cachingMode 是主机缓存模式: None、Read Only、Read Write。 |
|
|
| diskname 是 blob 存储中的数据磁盘的 Name |
|
|
| diskURI 是 blob 存储中的数据磁盘的 URI |
|
|
| fstype 是要挂载的 Filesystem 类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".如果未指定,则隐式推断为 "ext4"。 |
|
|
| kind 预期值为 Shared: 每个存储帐户 Dedicated 有多个 blob 磁盘:每个存储帐户 Managed: azure managed data disk (only on managed availability set). 默认为 shared |
|
|
| readonly Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
2.1.335. .spec.volumes[].azureFile 复制链接链接已复制到粘贴板!
- 描述
- azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。已弃用:AzureFile 已被弃用。in-tree azureFile 类型的所有操作都会重定向到 file.csi.azure.com CSI 驱动程序。
- 类型
-
object - 必填
-
secretName -
shareName
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| readonly 默认为 false (读/写)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| secretName 是包含 Azure Storage Account Name 和 Key 的 secret 名称 |
|
|
| sharename 是 azure 共享名称 |
2.1.336. .spec.volumes[].cephfs 复制链接链接已复制到粘贴板!
- 描述
- CephFS 代表共享 pod 生命周期的主机上的 Ceph FS 挂载。弃用:CephFS 已被弃用,in-tree cephfs 类型不再被支持。
- 类型
-
object - 必填
-
monitor
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| monitor 是必需的: monitor 是 Ceph 监视器更多信息的集合: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
| 路径为可选:作为挂载的 root 使用,而不是完整的 Ceph 树,默认为 / |
|
|
| readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
| secretfile 为 Optional: SecretFile 是用户密钥环的路径,默认为 /etc/ceph/user.secret 更多信息 :https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
| secretRef 为 Optional: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
|
| User 是可选的:用户是 rados 用户名,默认为 admin 更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
2.1.337. .spec.volumes[].cephfs.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 为 Optional: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.338. .spec.volumes[].cinder 复制链接链接已复制到粘贴板!
- 描述
- Cinder 代表附加并挂载到 kubelet 主机机器上的 cinder 卷。已弃用:Cinder 已被弃用。in-tree cinder 类型的所有操作都会重定向到 cinder.csi.openstack.org CSI 驱动程序。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md
- 类型
-
object - 必填
-
volumeID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为 "ext4"。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
|
| readonly 默认为 false (读/写)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
|
| secretRef 是可选的:指向包含用于连接到 OpenStack 的参数的 secret 对象。 |
|
|
| 用于识别 cinder 中的卷的 VolumeId。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
2.1.339. .spec.volumes[].cinder.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 是可选的:指向包含用于连接到 OpenStack 的参数的 secret 对象。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.340. .spec.volumes[].configMap 复制链接链接已复制到粘贴板!
- 描述
- ConfigMap 代表应填充此卷的 configMap
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| defaultMode 是可选的:默认用于在创建的文件上设置权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。默认值为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| 如果未指定,则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键,则卷设置将失败,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。 |
|
|
| 将字符串键映射到卷中的路径。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| (可选)指定是否必须定义 ConfigMap 或其键 |
2.1.341. .spec.volumes[].configMap.items 复制链接链接已复制到粘贴板!
- 描述
- 如果未指定,则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键,则卷设置将失败,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。
- 类型
-
array
2.1.342. .spec.volumes[].configMap.items[] 复制链接链接已复制到粘贴板!
- 描述
- 将字符串键映射到卷中的路径。
- 类型
-
object - 必填
-
key -
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是项目的关键。 |
|
|
| 模式为可选:用于设置此文件权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| path 是将键映射到的文件的相对路径。可能不是绝对路径。不得包含路径元素 '..'。不得以字符串 '..' 开头。 |
2.1.343. .spec.volumes[].csi 复制链接链接已复制到粘贴板!
- 描述
- CSI (Container Storage Interface)代表由某些外部 CSI 驱动程序处理的临时存储。
- 类型
-
object - 必填
-
driver
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| driver 是处理此卷的 CSI 驱动程序的名称。请联系您的 admin,了解集群中注册的正确名称。 |
|
|
| 要挂载的 fstype。例如,"ext4", "xfs", "ntfs".如果没有提供,则会将空值传递给关联的 CSI 驱动程序,该驱动程序将决定要应用的默认文件系统。 |
|
|
| nodePublishSecretRef 是包含敏感信息的 secret 对象的引用,以传递给 CSI 驱动程序,以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果不需要 secret,则可能会为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。 |
|
|
| readOnly 将卷指定为只读。默认为 false (读/写)。 |
|
|
| volumeAttributes 存储传递给 CSI 驱动程序的驱动程序特定属性。有关支持的值,请参阅驱动程序的文档。 |
2.1.344. .spec.volumes[].csi.nodePublishSecretRef 复制链接链接已复制到粘贴板!
- 描述
- nodePublishSecretRef 是包含敏感信息的 secret 对象的引用,以传递给 CSI 驱动程序,以完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果不需要 secret,则可能会为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.345. .spec.volumes[].downwardAPI 复制链接链接已复制到粘贴板!
- 描述
- downwardAPI 代表应填充此卷的 pod 的 Downward API
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可选:默认在创建的文件上使用模式位。必须是 Optional: 模式位,用于默认对创建的文件设置权限。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。默认值为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| items 是 Downward API 卷文件的列表 |
|
|
| DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息 |
2.1.346. .spec.volumes[].downwardAPI.items 复制链接链接已复制到粘贴板!
- 描述
- items 是 Downward API 卷文件的列表
- 类型
-
array
2.1.347. .spec.volumes[].downwardAPI.items[] 复制链接链接已复制到粘贴板!
- 描述
- DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
- 类型
-
object - 必填
-
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需:支持选择 pod 的字段:只支持注解、标签、名称、命名空间和 uid。 |
|
|
| 可选:用于设置此文件权限的模式位,必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| 必需:Path 是要创建的文件的相对路径名称。不能是绝对的,也不能包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不能以 '..' 开头。 |
|
|
| 选择容器的资源:目前只支持资源限值和请求(limits.cpu、limits.memory、requests.cpu 和 requests.memory)。 |
2.1.348. .spec.volumes[].downwardAPI.items[].fieldRef 复制链接链接已复制到粘贴板!
- 描述
- 必需:支持选择 pod 的字段:只支持注解、标签、名称、命名空间和 uid。
- 类型
-
object - 必填
-
fieldPath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 模式的版本是按术语编写的 FieldPath,默认为 "v1"。 |
|
|
| 在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:目前只支持资源限值和请求(limits.cpu、limits.memory、requests.cpu 和 requests.memory)。
- 类型
-
object - 必填
-
resource
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 容器名称:卷需要,对于 env vars是可选的 |
|
|
| 指定公开资源的输出格式,默认为 "1" |
|
|
| 必需:要选择的资源 |
2.1.350. .spec.volumes[].emptyDir 复制链接链接已复制到粘贴板!
- 描述
- emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Medium 代表存储介质类型应支持这个目录。默认值为 "",这意味着使用节点的默认介质。必须是空字符串(默认)或 Memory。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
|
| sizeLimit 是这个 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存用量的最大使用量为此处指定的 SizeLimit 和 pod 中所有容器的内存限值总和。默认值为 nil,这意味着限制未定义。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
2.1.351. .spec.volumes[].ephemeral 复制链接链接已复制到粘贴板!
- 描述
ephemeral 代表由集群存储驱动程序处理的卷。卷的生命周期与定义它的 pod 关联 - 将在 pod 启动前创建,并在 pod 被删除时删除。
如果 pod 运行(如需要从快照或容量跟踪中恢复)正常卷时,才需要这个卷。c)通过存储类指定存储驱动程序,以及 d)存储驱动程序支持通过 PersistentVolumeClaim 进行动态卷置备(请参阅 EphemeralVolumeSource 以了解有关这个卷类型和 PersistentVolumeClaim 间的连接的更多信息。
对于保留的时间超过单个 pod 的生命周期,使用 PersistentVolumeClaim 或特定于供应商的 API 之一。
如果使用 CSI 驱动程序,使用 CSI 驱动程序来轻量级本地临时卷 - 如需更多信息,请参阅驱动程序文档。
pod 可以同时使用两种类型的临时卷和持久性卷。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,即 PVC 将与 pod 一起删除。PVC 的名称将是 < 具有名称不归 pod 所有的现有 PVC 将不会 用于 pod,以避免错误地使用不相关的卷。然后,启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用这样的预先创建的 PVC,则必须在 pod 存在后使用对 pod 的所有者引用来更新 PVC。通常,这应该不需要,但手动重建一个有问题的集群时可能会很有用。 此字段是只读的,Kubernetes 在创建后不会对 PVC 进行任何更改。 必需,不能是 nil。 |
2.1.352. .spec.volumes[].ephemeral.volumeClaimTemplate 复制链接链接已复制到粘贴板!
- 描述
将用于创建独立 PVC 来置备卷。嵌入此 EphemeralVolumeSource 的 pod 将是 PVC 的所有者,即 PVC 将与 pod 一起删除。PVC 的名称将是 <
pod name>-<volume name>,其中<volumename> 是PodSpec.Volumes数组条目中的名称。如果串联的名称对 PVC 无效(例如,太长),pod 验证将拒绝 pod。具有名称不归 pod 所有的现有 PVC 将不会 用于 pod,以避免错误地使用不相关的卷。然后,启动 pod 会被阻断,直到删除不相关的 PVC。如果 pod 使用这样的预先创建的 PVC,则必须在 pod 存在后使用对 pod 的所有者引用来更新 PVC。通常,这应该不需要,但手动重建一个有问题的集群时可能会很有用。
此字段是只读的,Kubernetes 在创建后不会对 PVC 进行任何更改。
必需,不能是 nil。
- 类型
-
object - 必填
-
spec
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可能包含创建 PVC 时将复制到 PVC 的标签和注解。不允许其他字段,并在验证过程中被拒绝。 |
|
|
| PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。 |
- 描述
- 可能包含创建 PVC 时将复制到 PVC 的标签和注解。不允许其他字段,并在验证过程中被拒绝。
- 类型
-
object
- 描述
- PersistentVolumeClaim 的规格。整个内容保持不变复制到从该模板创建的 PVC 中。PersistentVolumeClaim 中与 相同的字段也有效。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| accessModes 包含卷应具有所需的访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
|
| Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。 |
|
|
| 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
|
|
| resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
|
| selector 是要考虑绑定的卷的标签查询。 |
|
|
| storageClassName 是声明所需的 StorageClass 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
|
| volumeAttributesClassName 可用于设置此声明使用的 VolumeAttributesClass。如果指定,CSI 驱动程序将使用对应的 VolumeAttributesClass 中定义的属性创建或更新卷。这有一个不同于 storageClassName 的目的,可在创建声明后更改。空字符串表示,不会将 VolumeAttributesClass 应用到声明,但不允许在设置后将此字段重置为空字符串。如果未指定,并且 PersistentVolumeClaim 为 unbound,则 persistentvolume 控制器将设置默认的 VolumeAttributesClass (如果存在)。如果 volumeAttributesClass 引用的资源不存在,则这个 PersistentVolumeClaim 将被设置为 Pending 状态,如 modifyVolumeStatus 字段反映,直到资源存在为止。更多信息:https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) 使用此字段需要启用 VolumeAttributesClass 功能门(默认为关闭)。 |
|
|
| volumeMode 定义声明需要哪些卷类型。当未包含在 claim spec 中时,文件系统的值会被表示。 |
|
|
| volumeName 是对此声明支持的 PersistentVolume 的绑定引用。 |
- 描述
- Datasource 字段可以用来指定:* 一个现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot)* 一个现有的 PVC (PersistentVolumeClaim),如果置备程序或外部控制器可以支持指定的数据源,它将基于指定数据源的内容创建一个新卷。当启用 AnyVolumeDataSource 功能门时,dataSource 内容将复制到 dataSourceRef 中,当未指定 dataSourceRef.namespace 时,dataSourceRef 内容将复制到 dataSource 中。如果指定了 namespace,则不会将 dataSourceRef 复制到 dataSource 中。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
- 描述
- 如果需要非空卷,则 dataSourceRef 指定要使用数据填充卷的对象。这可以是来自非空 API 组(非核心对象)或 PersistentVolumeClaim 对象的任何对象。当指定对象的类型与某些安装的卷填充或动态置备程序匹配时,卷绑定才会成功。此字段将替换 dataSource 字段的功能,如果两个字段都不是空的,则它们必须具有相同的值。为了向后兼容,当命名空间没有在 dataSourceRef 中指定时,如果其中一个为空,则两个字段(dataSource 和 dataSourceRef)都会自动设置为相同的值,另一个是非空的。当在 dataSourceRef 中指定 namespace 时,dataSource 不设置为相同的值,必须为空。dataSource 和 dataSourceRef 之间有三个重要区别:* While dataSource 只允许两种特定类型的对象,dataSourceRef 允许任何非核心对象,以及 PersistentVolumeClaim 对象。* 虽然 dataSource 忽略了禁止的值(丢弃它们),dataSourceRef 保留所有值,并在指定禁止的值时生成错误。* 虽然 dataSource 只允许本地对象,dataSourceRef 允许任何命名空间中的对象。(Beta)使用此字段需要启用 AnyVolumeDataSource 功能门。(Alpha)使用 dataSourceRef 的 namespace 字段需要启用 CrossNamespaceVolumeDataSource 功能门。
- 类型
-
object - 必填
-
kind -
name
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIGroup 是所引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
|
| kind 是被引用的资源类型 |
|
|
| name 是被引用的资源的名称 |
|
|
| 命名空间是被引用的资源的命名空间,请注意,当指定命名空间时,引用命名空间中需要一个 gateway.networking.k8s.io/ReferenceGrant 对象来允许该命名空间的所有者接受引用。详情请查看 ReferenceGrant 文档。(alpha)此字段需要启用 CrossNamespaceVolumeDataSource 功能门。 |
- 描述
- resources 代表卷应具有的最小资源。如果启用了 RecoverVolumeExpansionFailure 功能,用户可以指定小于之前值的资源要求,但仍必须高于声明的 status 字段中记录的容量。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。请求不能超过限值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
- 描述
- selector 是要考虑绑定的卷的标签查询。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
数组
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.361. .spec.volumes[].fc 复制链接链接已复制到粘贴板!
- 描述
- FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".如果未指定,则隐式推断为 "ext4"。 |
|
|
| LUN 是可选的:FC 目标 lun 号 |
|
|
| readonly 为 Optional: Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| targetWWNs 是可选:FC 目标全球名称(WWN) |
|
|
| wwids 可选:FC 卷全局范围标识符(wwids) Either wwids 或 targetWWN 和 lun 的组合必须被设置,但不能同时设置。 |
2.1.362. .spec.volumes[].flexVolume 复制链接链接已复制到粘贴板!
- 描述
- FlexVolume 代表使用基于 exec 的插件置备的/附加的通用卷资源。已弃用:FlexVolume 已被弃用。考虑使用 CSIDriver 替代。
- 类型
-
object - 必填
-
driver
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| driver 是用于此卷的驱动程序的名称。 |
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。 |
|
|
| 选项为 Optional:此字段包含额外的命令选项(若有)。 |
|
|
| readonly 为 Optional: 默认为 false (读/写)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| secretRef 是 Optional: secretRef 引用了包含敏感信息的 secret 对象,以传递给插件脚本。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。 |
2.1.363. .spec.volumes[].flexVolume.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 是 Optional: secretRef 引用了包含敏感信息的 secret 对象,以传递给插件脚本。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.364. .spec.volumes[].flocker 复制链接链接已复制到粘贴板!
- 描述
- flocker 代表附加到 kubelet 主机机器的 Flocker 卷。这取决于正在运行的 Flocker 控制服务。已弃用:Flocker 已弃用,in-tree flocker 类型不再被支持。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
datasetName 是数据存储为 Flocker dataset 上的 metadata |
|
|
| datasetUUID 是 dataset 的 UUID。这是 Flocker 数据集的唯一标识符 |
2.1.365. .spec.volumes[].gcePersistentDisk 复制链接链接已复制到粘贴板!
- 描述
- gcePersistentDisk 代表一个 GCE Disk 资源,该资源附加到 kubelet 的主机机器,然后公开给 pod。已弃用: GCEPersistentDisk 已被弃用。树内 gcePersistentDisk 类型的所有操作都会重定向到 pd.csi.storage.gke.io CSI 驱动程序。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- 类型
-
object - 必填
-
pdName
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是您要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为 "ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
| partition 是您要挂载的卷中的分区。如果省略,则默认使用卷名称来挂载。示例: 对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷分区是"0" (或者您可以将属性留空)。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
| pdName 是 GCE 中的 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
|
| 此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
2.1.366. .spec.volumes[].gitRepo 复制链接链接已复制到粘贴板!
- 描述
- gitRepo 代表特定修订版本中的 git 存储库。deprecated: GitRepo 已被弃用。要使用 git 存储库置备容器,请将 EmptyDir 挂载到使用 git 克隆存储库的 InitContainer 中,然后将 EmptyDir 挂载到 Pod 的容器中。
- 类型
-
object - 必填
-
软件仓库
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| directory 是目标目录名称。不得包含或以 '..' 开头。如果提供了 '.',则卷目录将是 git 存储库。否则,如果指定,卷将在带有给定名称的子目录中包含 git 存储库。 |
|
|
| repository 是 URL |
|
|
| revision 是指定修订版本的提交哈希。 |
2.1.367. .spec.volumes[].glusterfs 复制链接链接已复制到粘贴板!
- 描述
- GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。已弃用: Glusterfs 已被弃用,in-tree glusterfs 类型不再被支持。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md
- 类型
-
object - 必填
-
端点 -
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Endpoints 是 Glusterfs 拓扑的详细信息的端点名称。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
|
| path 是 Glusterfs 卷路径。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
|
| 此处的 readonly 将强制 Glusterfs 卷以只读权限挂载。默认为false。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
2.1.368. .spec.volumes[].hostPath 复制链接链接已复制到粘贴板!
- 描述
- hostpath 代表主机机器上直接公开给容器的已存在的文件或目录。这通常用于系统代理或其他允许查看主机机器的特权事情。大多数容器都不需要这样做。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
- 类型
-
object - 必填
-
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 主机上目录的路径。如果路径是符号链接,它将遵循指向实际路径的链接。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
|
| HostPath Volume 默认为 "" 更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
2.1.369. .spec.volumes[].image 复制链接链接已复制到粘贴板!
- 描述
Image 代表一个 OCI 对象(容器镜像或工件)拉取并挂载到 kubelet 的主机机器上。根据提供 PullPolicy 值,卷会在 pod 启动时解析:
- Always :kubelet 始终会尝试拉取引用。如果拉取失败,容器创建将失败。
- Never:kubelet 从不拉取引用,只使用本地镜像或工件。如果引用不存在,容器创建将失败。
- IfNotPresent :如果磁盘上不存在引用,kubelet 会拉取。如果引用不存在,则容器创建会失败,拉取会失败。
如果 pod 被删除并重新创建,则卷会被重新解析,这意味着新的远程内容将在 pod 重新创建时可用。在 pod 启动期间无法解析或拉取镜像将阻止容器启动,并可能会增加大量延迟。故障将使用正常的卷 backoff 重试,并将报告在 pod 原因和消息上。此卷可以挂载的对象类型由主机机器上的容器运行时实施定义,至少必须包含容器镜像字段支持的所有有效类型。通过合并清单层与容器镜像相同,OCI 对象会被挂载到单个目录中(spec.containers[].volumeMounts.mountPath)。该卷将被挂载为只读(ro)和不可执行的文件(noexec)。在 1.33 之前,不支持容器的子路径挂载(spec.containers[].volumeMounts.subpath)。字段 spec.securityContext.fsGroupChangePolicy 对这个卷类型没有影响。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 拉取 OCI 对象的策略。可能的值有: Always: kubelet 始终会尝试拉取引用。如果拉取失败,容器创建将失败。Never:kubelet 从不拉取引用,只使用本地镜像或工件。如果引用不存在,容器创建将失败。IfNotPresent :如果磁盘上不存在引用,kubelet 会拉取。如果引用不存在,则容器创建会失败,拉取会失败。如果指定了 :latest 标签,则默认为 Always,否则则默认为 IfNotPresent。 |
|
|
| 必需:要使用的镜像或工件引用。行为与 pod.spec.containers[*].image 相同。pull secret 将像查找节点凭证、SA 镜像 pull secret 和 pod spec 镜像 pull secret 一样对容器镜像进行编译。更多信息: https://kubernetes.io/docs/concepts/containers/images 此字段是可选的,允许更高级别的配置管理默认或覆盖工作负载控制器(如 Deployments 和 StatefulSets)中的容器镜像。 |
2.1.370. .spec.volumes[].iscsi 复制链接链接已复制到粘贴板!
- 描述
- iSCSI 代表附加到 kubelet 主机机器的 ISCSI Disk 资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md
- 类型
-
object - 必填
-
iqn -
lun -
targetPortal
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| chapAuthDiscovery 定义是否支持 iSCSI Discovery CHAP 身份验证 |
|
|
| chapAuthSession 定义是否支持 iSCSI 会话 CHAP 身份验证 |
|
|
| fstype 是您要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为 "ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
|
| initiatorname 是自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName,则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。 |
|
|
| IQN 是目标 iSCSI 限定名称。 |
|
|
| iscsiInterface 是使用 iSCSI 传输的接口名称。默认为 'default'(tcp)。 |
|
|
| LUN 表示 iSCSI 目标 Lun 编号。 |
|
|
| 门户是 iSCSI 目标门户列表。如果端口不是默认值(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。 |
|
|
| 此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。 |
|
|
| secretRef 是 iSCSI 目标和发起方身份验证的 CHAP Secret |
|
|
| targetPortal 是 iSCSI 目标门户。如果端口不是默认值(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。 |
2.1.371. .spec.volumes[].iscsi.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 是 iSCSI 目标和发起方身份验证的 CHAP Secret
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.372. .spec.volumes[].nfs 复制链接链接已复制到粘贴板!
- 描述
- NFS 代表共享 pod 生命周期更多信息的主机上 NFS 挂载: https://kubernetes.io/docs/concepts/storage/volumes#nfs
- 类型
-
object - 必填
-
path -
server
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| NFS 服务器导出的路径。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
|
| 此处的只读将强制使用只读权限挂载 NFS 导出。默认为false。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
|
| server 是 NFS 服务器的主机名或 IP 地址。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#nfs |
2.1.373. .spec.volumes[].persistentVolumeClaim 复制链接链接已复制到粘贴板!
- 描述
- persistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 类型
-
object - 必填
-
claimName
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| claimName 是与使用这个卷的 pod 相同的命名空间中的 PersistentVolumeClaim 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
|
| readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认 false。 |
2.1.374. .spec.volumes[].photonPersistentDisk 复制链接链接已复制到粘贴板!
- 描述
- photonPersistentDisk 代表附加并挂载到 kubelets 主机上的 PhotonController 持久磁盘。弃用: PhotonPersistentDisk 已被弃用,in-tree photonPersistentDisk 类型不再被支持。
- 类型
-
object - 必填
-
pdID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".如果未指定,则隐式推断为 "ext4"。 |
|
|
| pdID 是标识 Photon Controller 持久磁盘的 ID |
2.1.375. .spec.volumes[].portworxVolume 复制链接链接已复制到粘贴板!
- 描述
- portworxVolume 代表附加并挂载到 kubelets 主机上的 portworx 卷。已弃用:PortworxVolume 已被弃用。当 CSIMigrationPortworx feature-gate 为 on 时,in-tree portworxVolume 类型的所有操作都会被重定向到 pxd.portworx.com CSI 驱动程序。
- 类型
-
object - 必填
-
volumeID
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 代表要挂载的文件系统类型必须是主机操作系统支持的文件系统类型。EX. "ext4", "xfs"。如果未指定,则隐式推断为 "ext4"。 |
|
|
| readonly 默认为 false (读/写)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| VolumeId 唯一标识 Portworx 卷 |
2.1.376. .spec.volumes[].projected 复制链接链接已复制到粘贴板!
- 描述
- 一个资源 secret、configmap 和 Downward API 中所有的项目项目
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| defaultMode 是默认用于在创建的文件上设置权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| sources 是卷投射列表。此列表中的每个条目处理一个源。 |
|
|
| 可投射以及其他支持的卷类型的预测。必须设置其中一个字段。 |
2.1.377. .spec.volumes[].projected.sources 复制链接链接已复制到粘贴板!
- 描述
- sources 是卷投射列表。此列表中的每个条目处理一个源。
- 类型
-
array
2.1.378. .spec.volumes[].projected.sources[] 复制链接链接已复制到粘贴板!
- 描述
- 可投射以及其他支持的卷类型的预测。必须设置其中一个字段。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
ClusterTrustBundle 允许 pod 访问自动更新文件中的 ClusterTrustBundle 对象的 alpha,由 ClusterTrustBundleProjection 功能门实现。 ClusterTrustBundle 对象可以按名称选择,或者通过 signer 名称和标签选择器的组合来选择。 kubelet 对写入 pod 文件系统的 PEM 内容进行积极规范化。esoteric PEM 功能(如 inter-block 注释和块标头)将被剥离。证书会被重复数据删除。文件中的证书排序是任意的,Kubelet 可能会随时间更改顺序。 |
|
|
| 有关项目的 configMap 数据的 ConfigMap 信息 |
|
|
| downwardAPI 有关项目的 downwardAPI 数据的信息 |
|
|
| 有关项目的 secret 数据的 secret 信息 |
|
|
| serviceAccountToken 是与项目的 serviceAccountToken 数据相关的信息 |
- 描述
ClusterTrustBundle 允许 pod 访问自动更新文件中的 ClusterTrustBundle 对象的
.spec.trustBundle字段。alpha,由 ClusterTrustBundleProjection 功能门实现。
ClusterTrustBundle 对象可以按名称选择,或者通过 signer 名称和标签选择器的组合来选择。
kubelet 对写入 pod 文件系统的 PEM 内容进行积极规范化。esoteric PEM 功能(如 inter-block 注释和块标头)将被剥离。证书会被重复数据删除。文件中的证书排序是任意的,Kubelet 可能会随时间更改顺序。
- 类型
-
object - 必填
-
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 选择与这个标签选择器匹配的所有 ClusterTrustBundles。仅在设置了 signerName 时生效。使用名称互斥器.如果未设置,则解释为"匹配任何内容"。如果设置但为空,则解释为"匹配所有内容"。 |
|
|
| 按对象名称选择单个 ClusterTrustBundle。与 signerName 和 labelSelector 相互排斥. |
|
|
| 如果为 true,如果引用的 ClusterTrustBundle 不可用,则不阻止 pod 启动。如果使用 name,则允许命名 ClusterTrustBundle 不存在。如果使用 signerName,则允许 signerName 和 labelSelector 的组合匹配零 ClusterTrustBundles。 |
|
|
| 卷根的相对路径以写入捆绑包。 |
|
|
| 选择与这个签名者名称匹配的所有 ClusterTrustBundles。使用名称互斥器.所有所选 ClusterTrustBundles 的内容将统一并去除重复数据。 |
- 描述
- 选择与这个标签选择器匹配的所有 ClusterTrustBundles。仅在设置了 signerName 时生效。使用名称互斥器.如果未设置,则解释为"匹配任何内容"。如果设置但为空,则解释为"匹配所有内容"。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
数组
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
object - 必填
-
key -
operator
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是选择器应用到的标签键。 |
|
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
2.1.383. .spec.volumes[].projected.sources[].configMap 复制链接链接已复制到粘贴板!
- 描述
- 有关项目的 configMap 数据的 ConfigMap 信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 如果未指定,则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键,则卷设置将失败,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。 |
|
|
| 将字符串键映射到卷中的路径。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| (可选)指定是否必须定义 ConfigMap 或其键 |
- 描述
- 如果未指定,则引用的 ConfigMap 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 ConfigMap 中的键,则卷设置将失败,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。
- 类型
-
array
- 描述
- 将字符串键映射到卷中的路径。
- 类型
-
object - 必填
-
key -
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是项目的关键。 |
|
|
| 模式为可选:用于设置此文件权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| path 是将键映射到的文件的相对路径。可能不是绝对路径。不得包含路径元素 '..'。不得以字符串 '..' 开头。 |
2.1.386. .spec.volumes[].projected.sources[].downwardAPI 复制链接链接已复制到粘贴板!
- 描述
- downwardAPI 有关项目的 downwardAPI 数据的信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| items 是 DownwardAPIVolume 文件列表 |
|
|
| DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息 |
- 描述
- items 是 DownwardAPIVolume 文件列表
- 类型
-
array
- 描述
- DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
- 类型
-
object - 必填
-
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需:支持选择 pod 的字段:只支持注解、标签、名称、命名空间和 uid。 |
|
|
| 可选:用于设置此文件权限的模式位,必须是 0000 到 0777 之间的数值,或 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| 必需:Path 是要创建的文件的相对路径名称。不能是绝对的,也不能包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不能以 '..' 开头。 |
|
|
| 选择容器的资源:目前只支持资源限值和请求(limits.cpu、limits.memory、requests.cpu 和 requests.memory)。 |
- 描述
- 必需:支持选择 pod 的字段:只支持注解、标签、名称、命名空间和 uid。
- 类型
-
object - 必填
-
fieldPath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 模式的版本是按术语编写的 FieldPath,默认为 "v1"。 |
|
|
| 在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:目前只支持资源限值和请求(limits.cpu、limits.memory、requests.cpu 和 requests.memory)。
- 类型
-
object - 必填
-
resource
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 容器名称:卷需要,对于 env vars是可选的 |
|
|
| 指定公开资源的输出格式,默认为 "1" |
|
|
| 必需:要选择的资源 |
2.1.391. .spec.volumes[].projected.sources[].secret 复制链接链接已复制到粘贴板!
- 描述
- 有关项目的 secret 数据的 secret 信息
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 如果未指定,则引用 Secret 的 Data 字段中的每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 Secret 中的密钥,则卷设置将出错,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。 |
|
|
| 将字符串键映射到卷中的路径。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 可选字段指定是否必须定义 Secret 或其密钥 |
- 描述
- 如果未指定,则引用 Secret 的 Data 字段中的每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 Secret 中的密钥,则卷设置将出错,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。
- 类型
-
array
- 描述
- 将字符串键映射到卷中的路径。
- 类型
-
object - 必填
-
key -
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是项目的关键。 |
|
|
| 模式为可选:用于设置此文件权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| path 是将键映射到的文件的相对路径。可能不是绝对路径。不得包含路径元素 '..'。不得以字符串 '..' 开头。 |
- 描述
- serviceAccountToken 是与项目的 serviceAccountToken 数据相关的信息
- 类型
-
object - 必填
-
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 受众是令牌的预期使用者。令牌的接收者必须使用令牌使用者中指定的标识符来识别其自身,否则应拒绝令牌。受众默认为 apiserver 的标识符。 |
|
|
| expirationSeconds 是服务帐户令牌的请求的有效期。当令牌接近过期时,kubelet 卷插件会主动轮转服务帐户令牌。如果令牌的时间超过 80%,或者令牌早于 24 小时,则 kubelet 将开始尝试轮转令牌。默认为 1 小时,且必须至少为 10 分钟。 |
|
|
| path 是与文件挂载点相关的路径,用于将令牌放入其中。 |
2.1.395. .spec.volumes[].quobyte 复制链接链接已复制到粘贴板!
- 描述
- quobyte 代表共享 pod 生命周期的主机上执行 Quobyte 挂载。已弃用:Quobyte 已弃用,in-tree Quobyte 类型不再被支持。
- 类型
-
object - 必填
-
registry -
卷
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 将卷访问映射到 Default 的组没有组 |
|
|
| 此处的 readonly 将强制使用只读权限挂载 Quobyte 卷。默认为false。 |
|
|
| registry 代表单个或多个 Quobyte Registry 服务,它指定为 host:port 对(多个条目用逗号分开),它充当卷的中央 registry |
|
|
| 在带有动态置备 Quobyte 卷的后端使用中拥有给定 Quobyte 卷的租户,由插件设置 |
|
|
| 用户,将卷访问权限映射到 Defaults 到 serivceaccount 用户 |
|
|
| volume 是按名称引用已创建 Quobyte 卷的字符串。 |
2.1.396. .spec.volumes[].rbd 复制链接链接已复制到粘贴板!
- 描述
- RBD 代表共享 pod 生命周期的主机上 Rados 块设备挂载。已弃用:RBD 已被弃用,in-tree rbd 类型不再被支持。更多信息: https://examples.k8s.io/volumes/rbd/README.md
- 类型
-
object - 必填
-
image -
monitor
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是您要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为 "ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
|
| image 是 rados 镜像名称。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| keyring 是 RBDUser 的密钥环路径。默认为 /etc/ceph/keyring。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| monitor 是 Ceph 监视器的集合。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| pool 是 rados 池名称。默认为 rbd。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| 此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| secretRef 是 RBDUser 的身份验证 secret 的名称。如果提供的会覆盖密钥环。默认为 nil。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
|
| user 是 rados 用户名。默认为 admin。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
2.1.397. .spec.volumes[].rbd.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 是 RBDUser 的身份验证 secret 的名称。如果提供的会覆盖密钥环。默认为 nil。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.398. .spec.volumes[].scaleIO 复制链接链接已复制到粘贴板!
- 描述
- scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。已弃用:ScaleIO 已被弃用,in-tree scaleIO 类型不再被支持。
- 类型
-
object - 必填
-
gateway -
secretRef -
system
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".默认为 "xfs"。 |
|
|
| gateway 是 ScaleIO API 网关的主机地址。 |
|
|
| protectionDomain 是配置存储的 ScaleIO 保护域的名称。 |
|
|
| readonly Defaults to false (read/write)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| secretRef 引用 ScaleIO 用户和其他敏感信息的 secret。如果没有提供,则登录操作将失败。 |
|
|
| sslEnabled Flag 启用/禁用与网关的 SSL 通信,默认为 false |
|
|
| storageMode 指示卷的存储是否应 ThickProvisioned 或 ThinProvisioned。默认为 ThinProvisioned。 |
|
|
| StoragePool 是与保护域关联的 ScaleIO 存储池。 |
|
|
| system 是 ScaleIO 中配置的存储系统的名称。 |
|
|
| volumeName 是在与这个卷源关联的 ScaleIO 系统中创建的卷的名称。 |
2.1.399. .spec.volumes[].scaleIO.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 引用 ScaleIO 用户和其他敏感信息的 secret。如果没有提供,则登录操作将失败。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.400. .spec.volumes[].secret 复制链接链接已复制到粘贴板!
- 描述
- Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| defaultMode 是可选:默认用于设置创建文件的权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。默认值为 0644。路径中的目录不受此设置的影响。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| 如果未指定,则引用的 Secret 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 Secret 中的密钥,则卷设置将出错,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。 |
|
|
| 将字符串键映射到卷中的路径。 |
|
|
| 可选字段指定是否必须定义 Secret 或其密钥 |
|
|
| secretName 是要使用的 pod 命名空间中的 secret 名称。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret |
2.1.401. .spec.volumes[].secret.items 复制链接链接已复制到粘贴板!
- 描述
- 如果未指定,则引用的 Secret 的 Data 字段中每个键值对将投射到卷中,其名称是键,内容是值。如果指定,列出的键将投射到指定的路径中,并且不会出现未列出的键。如果指定了没有存在于 Secret 中的密钥,则卷设置将出错,除非标记为可选。路径必须是相对的,且不能包含 '..' 路径,或者以 '..' 开始。
- 类型
-
array
2.1.402. .spec.volumes[].secret.items[] 复制链接链接已复制到粘贴板!
- 描述
- 将字符串键映射到卷中的路径。
- 类型
-
object - 必填
-
key -
path
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| key 是项目的关键。 |
|
|
| 模式为可选:用于设置此文件权限的模式位。必须是一个 0000 到 0777 之间的八进制数值,或者 0 到 511 之间的十进制值。YAML 接受八进制和十进制值,JSON 需要模式位的值为十进制值。如果没有指定,则使用卷 defaultMode。这可能与影响文件模式的其他选项(如 fsGroup )冲突,结果可以是其他模式位。 |
|
|
| path 是将键映射到的文件的相对路径。可能不是绝对路径。不得包含路径元素 '..'。不得以字符串 '..' 开头。 |
2.1.403. .spec.volumes[].storageos 复制链接链接已复制到粘贴板!
- 描述
- storageos 代表附加并挂载到 Kubernetes 节点上的 StorageOS 卷。已弃用:StorageOS 已被弃用,in-tree storageos 类型不再被支持。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".如果未指定,则隐式推断为 "ext4"。 |
|
|
| readonly 默认为 false (读/写)。此处的 readonly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
|
| secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。 |
|
|
| volumeName 是 StorageOS 卷的人类可读名称。卷名称仅在命名空间中唯一。 |
|
|
| volumeNamespace 指定 StorageOS 中的卷范围。如果没有指定命名空间,则使用 Pod 的命名空间。这允许在 StorageOS 中镜像 Kubernetes 名称进行更紧密的集成。将 VolumeName 设置为任何名称,以覆盖默认的行为。如果没有在 StorageOS 中使用命名空间,则设置为 "default"。将创建在 StorageOS 中没有预先存在的命名空间。 |
2.1.404. .spec.volumes[].storageos.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
2.1.405. .spec.volumes[].vsphereVolume 复制链接链接已复制到粘贴板!
- 描述
- vsphereVolume 代表附加并挂载到 kubelets 主机上的 vSphere 卷。已弃用:VsphereVolume 已被弃用。in-tree vsphereVolume 类型的所有操作都会重定向到 csi.vsphere.vmware.com CSI 驱动程序。
- 类型
-
object - 必填
-
volumePath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| fstype 是要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。例如,"ext4", "xfs", "ntfs".如果未指定,则隐式推断为 "ext4"。 |
|
|
| storagePolicyID 是与 StoragePolicyName 关联的存储策略 Based Management (SPBM)配置集 ID。 |
|
|
| StoragePolicyName 是存储基于策略的管理(SPBM)配置集名称。 |
|
|
| volumePath 是标识 vSphere 卷 vmdk 的路径 |
2.1.406. .spec.web 复制链接链接已复制到粘贴板!
- 描述
- 定义启动 Alertmanager 时的 Web 命令行标志。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
|
同时处理的最大 GET 请求数。这与 Alertmanager 的-- |
|
|
| 定义 Web 服务器的 HTTP 参数。 |
|
|
|
HTTP 请求的超时。这与 Alertmanager 的- |
|
|
| 定义 HTTPS 的 TLS 参数。 |
2.1.407. .spec.web.httpConfig 复制链接链接已复制到粘贴板!
- 描述
- 定义 Web 服务器的 HTTP 参数。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 可添加到 HTTP 响应中的标头列表。 |
|
|
| 启用 HTTP/2 支持。请注意,只有 TLS 支持 HTTP/2。如果没有配置 TLSConfig,则禁用 HTTP/2。每当字段更改时,将触发滚动更新。 |
2.1.408. .spec.web.httpConfig.headers 复制链接链接已复制到粘贴板!
- 描述
- 可添加到 HTTP 响应中的标头列表。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 将 Content-Security-Policy 标头设置为 HTTP 响应。如果为空,则取消设置。 |
|
|
| 将 Strict-Transport-Security 标头设置为 HTTP 响应。如果为空,则取消设置。请确定您谨慎使用此标头,因为这个标头可能会强制浏览器加载 Prometheus,以及通过 HTTPS 在同一域和子域上托管的其他应用程序。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security |
|
|
| 将 X-Content-Type-Options 标头设置为 HTTP 响应。如果为空,则取消设置。接受的值是 nosniff。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options |
|
|
| 将 X-Frame-Options 标头设置为 HTTP 响应。如果为空,则取消设置。接受的值是 deny 和 sameorigin。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options |
|
|
| 将 X-XSS-Protection 标头设置为所有响应。如果为空,则取消设置。https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-XSS-Protection |
2.1.409. .spec.web.tlsConfig 复制链接链接已复制到粘贴板!
- 描述
- 定义 HTTPS 的 TLS 参数。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含 web 服务器的 TLS 证书的 secret 或 ConfigMap。
必须定义
它与 |
|
|
| Web 服务器的容器中的 TLS 证书文件的路径。
必须定义
它与证书 |
|
|
| TLS 版本支持的密码套件列表,最高为 TLS 1.2。 如果没有定义,则使用 Go 默认密码套件。可用的密码套件记录在 Go 文档中: https://golang.org/pkg/crypto/tls/#pkg-constants |
|
|
| 客户端 TLS 身份验证的服务器策略。 有关 clientAuth 选项的详情: https://golang.org/pkg/crypto/tls/#ClientAuthType |
|
|
| 服务器客户端证书身份验证的 CA 证书文件的路径。
它与 |
|
|
| 包含服务器客户端证书身份验证的 CA 证书的 secret 或 ConfigMap。
它与 |
|
|
| 按偏好顺序在 ECDHE 握手中使用的 Elliptic curves。 Go 文档中记录了可用的 curves :https://golang.org/pkg/crypto/tls/#CurveID |
|
|
| Web 服务器的容器中的 TLS 私钥文件的路径。
如果定义,则必须定义
它与 |
|
|
| 包含 web 服务器的 TLS 私钥的 secret。
必须定义
它与 |
|
|
| 可接受的最大 TLS 版本。 |
|
|
| 可以接受的最低 TLS 版本。 |
|
|
| 控制服务器是否选择客户端最首选密码套件,或者服务器最首选密码套件。 如果为 true,则使用服务器的首选项,如 cipherSuites 中的元素顺序表示。 |
2.1.410. .spec.web.tlsConfig.cert 复制链接链接已复制到粘贴板!
- 描述
包含 web 服务器的 TLS 证书的 secret 或 ConfigMap。
必须定义
keySecret或keyFile。它与
certFile相互排斥。- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.411. .spec.web.tlsConfig.cert.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.412. .spec.web.tlsConfig.cert.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.413. .spec.web.tlsConfig.client_ca 复制链接链接已复制到粘贴板!
- 描述
包含服务器客户端证书身份验证的 CA 证书的 secret 或 ConfigMap。
它与
clientCAFile相互排斥。- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 包含用于目标的数据的 ConfigMap。 |
|
|
| 包含用于目标的数据的 secret。 |
2.1.414. .spec.web.tlsConfig.client_ca.configMap 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 ConfigMap。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要选择的密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 ConfigMap 或是其键 |
2.1.415. .spec.web.tlsConfig.client_ca.secret 复制链接链接已复制到粘贴板!
- 描述
- 包含用于目标的数据的 secret。
- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.416. .spec.web.tlsConfig.keySecret 复制链接链接已复制到粘贴板!
- 描述
包含 web 服务器的 TLS 私钥的 secret。
必须定义
cert或certFile。它与
keyFile相互排斥。- 类型
-
object - 必填
-
key
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
|
| 引用的名称。需要此字段,但因为向后兼容的目的,它可以为空。具有空值的此类实例几乎肯定是错误的。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
| 指定是否必须定义 Secret 或其密钥 |
2.1.417. .status 复制链接链接已复制到粘贴板!
- 描述
- Alertmanager 集群的状态最近观察到的状态。只读。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 类型
-
object - 必填
-
availableReplicas -
paused -
replicas -
unavailableReplicas -
updatedReplicas
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 此 Alertmanager 集群的目标可用 pod 的可用 pod 数量(至少为 minReadySeconds)。 |
|
|
| Alertmanager 对象的当前状态。 |
|
|
| condition 代表与 Prometheus、Alertmanager 或 ThanosRuler 资源关联的资源的状态。 |
|
|
| 代表是否在执行底层受管对象的任何操作。只有 delete 操作才会执行。 |
|
|
| 此 Alertmanager 对象的目标非确定 pod 的总数(标签与选择器匹配)。 |
|
|
| 用于匹配此 Alertmanager 对象目标的 pod 的选择器。 |
|
|
| 此 Alertmanager 对象目标不可用 pod 的总数。 |
|
|
| 此 Alertmanager 对象的目标非确定 pod 的总数,该对象具有所需版本 spec。 |
2.1.418. .status.conditions 复制链接链接已复制到粘贴板!
- 描述
- Alertmanager 对象的当前状态。
- 类型
-
array
2.1.419. .status.conditions[] 复制链接链接已复制到粘贴板!
- 描述
- condition 代表与 Prometheus、Alertmanager 或 ThanosRuler 资源关联的资源的状态。
- 类型
-
object - 必填
-
lastTransitionTime -
status -
type
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| lastTransitionTime 是当前 status 属性最后一次更新的时间。 |
|
|
| 人类可读的消息,指示条件最后一次转换的详细信息。 |
|
|
|
observedGeneration 代表 .metadata.generation,条件基于这个条件。例如,如果 |
|
|
| 条件最后一次转换的原因。 |
|
|
| 条件的状态。 |
|
|
| 所报告条件的类型。 |