14.2. Alertmanager [monitoring.coreos.com/v1]
- 描述
- Alertmanager 描述 Alertmanager 集群。
- 类型
-
对象
- 必填
-
spec
-
14.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 集群最近观察到的状态。只读。从 apiserver 请求时不包括,仅来自 Prometheus Operator API 本身。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
14.2.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- Alertmanager 集群所需行为的规格。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| AdditionalPeers 允许将一组额外的 Alertmanager 注入 peer 来形成高可用性集群。 |
|
| 如果指定,pod 的调度限制。 |
|
| 为 AlertmanagerConfig 发现选择的命名空间。如果为 nil,则只检查自己的命名空间。 |
|
| 为合并和配置 Alertmanager 的 alertmanagerconfigs。 |
|
| 用于部署 pod 的基础镜像,无需标签。弃用:使用 'image' 替代 |
|
| ClusterAdvertiseAddress 是集群中公告的显式地址。需要为非 RFC1918 [1](公共)地址提供。[1] RFC1918: https://tools.ietf.org/html/rfc1918 |
|
| gossip 尝试之间的间隔。 |
|
| 集群 peering 的超时时间。 |
|
| pushpull 尝试之间的间隔。 |
|
| ConfigMap 是与 Alertmanager 对象相同的命名空间中的 ConfigMap 列表,应该挂载到 Alertmanager Pod 中。ConfigMap 挂载到 /etc/alertmanager/configmaps/<configmap-name> 中。 |
|
| ConfigSecret 是与 Alertmanager 对象相同的命名空间中的 Kubernetes Secret 的名称,其中包含此 Alertmanager 实例的配置。默认为 'alertmanager-<alertmanager-name>' The secret 被挂载到 /etc/alertmanager/config。 |
|
|
容器允许注入其他容器。这是允许在 Alertmanager pod 中添加身份验证代理。如果容器共享相同名称和修改是通过策略合并补丁进行的,则此处描述的容器会修改 Operator 生成的容器。当前容器名称为: |
|
| 要在 pod 中运行的单一应用程序容器。 |
|
| Alertmanager 实例将位于的外部 URL。这是生成正确的 URL 所必需的。如果 Alertmanager 没有从 DNS 名称的根目录提供,则需要此项。 |
|
| ForceEnableClusterMode 确保 Alertmanager 在使用单个副本运行时不会停用集群模式。例如,在 Kubernetes 集群间跨越一个 Alertmanager 集群,每个集群都有一个副本。 |
|
| 如果指定的优先级高于 baseImage、tag 和 sha 组合,则镜像。仍然需要指定版本,以确保 Prometheus Operator 知道要配置的 Alertmanager 版本。 |
|
| 用于从 registry 中拉取 prometheus 和 alertmanager 镜像的 secret 的可选引用列表,请参阅 http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod |
|
| LocalObjectReference 包含足够信息,供您在同一命名空间中查找引用的对象。 |
|
| initContainers 允许将 initContainers 添加到 pod 定义中。它们可用于从外部来源获取用于注入 Alertmanager 配置的 secret。执行 initContainer 期间的任何错误将导致 Pod 重启。更多信息:使用 initContainers 进行其他用例的 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/,然后 secret 获取完全不在维护者支持的范围之外,因此您接受这个行为可能会随时中断,而不会注意到。 |
|
| 要在 pod 中运行的单一应用程序容器。 |
|
| ListenLocal 使 Alertmanager 服务器侦听回送,使其不会绑定到 Pod IP。请注意,这仅适用于 Alertmanager UI,而不是 gossip 通信。 |
|
| 用于配置 Alertmanager 的日志格式。 |
|
| 要配置的 Alertmanager 的日志级别。 |
|
| 新创建的 pod 应该就绪的最小秒数,无需任何容器崩溃,使其被视为可用。默认值为 0 (pod 会在就绪后马上被视为可用),这是 alpha 字段,需要启用 StatefulSetMinReadySeconds 功能门。 |
|
| 定义 Pod 调度到哪些节点上。 |
|
| 如果设置为 true,则底层受管对象的所有操作都不会执行 goint,但删除操作除外。 |
|
| podMetadata 配置向 alertmanager pod 传播的标签和注解。 |
|
| 用于 pod 和管理服务的端口名称。默认值为 web |
|
| 分配给 Pod 的优先级类 |
|
| size 是 alertmanager 集群的预期大小。控制器最终将使正在运行的集群的大小与预期大小相等。 |
|
| 定义单个 Pod 的资源请求和限值。 |
|
|
Alertmanager 应该保留数据的持续时间。默认为 '120h',必须与正则表达式 |
|
|
Alertmanager 注册 HTTP 处理程序的路由前缀。这非常有用,如果使用 ExternalURL 和代理被重写请求的 HTTP 路由,并且实际的 ExternalURL 仍为 true,但服务器在不同路由前缀下服务请求。例如,用于 |
|
| secret 是与 Alertmanager 对象相同的命名空间中的 Secret 列表,应该挂载到 Alertmanager Pod 中。Secret 被挂载到 /etc/alertmanager/secrets/<secret-name> 中。 |
|
| securityContext 包含 pod 级别的安全属性和通用容器设置。默认为默认的 PodSecurityContext。 |
|
| serviceAccountName 是用于运行 Prometheus Pod 的 ServiceAccount 的名称。 |
|
|
要部署的 Alertmanager 容器镜像的 SHA。默认为 |
|
| Storage 是 Alertmanager 实例如何使用存储的定义。 |
|
|
要部署的 Alertmanager 容器镜像的标签。默认为 |
|
| 如果指定,pod 的容限。 |
|
| 附加此 Toleration 的 pod,以使用匹配的 operator <operator> 来容许与 triple <key,value,effect> 匹配的任何污点。 |
|
| 如果指定,pod 的拓扑分布约束。 |
|
| TopologySpreadConstraint 指定如何将匹配的 pod 分散到给定拓扑中。 |
|
| 集群应处于的版本。 |
|
| volumeMounts 允许在输出 StatefulSet 定义上配置额外的 VolumeMounts。指定 volumeMounts 将附加到 alertmanager 容器中的其他 VolumeMounts 中,后者由 StorageSpec 对象生成。 |
|
| VolumeMount 描述了容器内卷的挂载。 |
|
| 卷允许在输出 StatefulSet 定义中配置额外的卷。指定的卷将附加到因为 StorageSpec 对象生成的其他卷中。 |
|
| 卷代表 pod 中可以被 pod 中任何容器访问的命名卷。 |
14.2.1.2. .spec.affinity 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的调度限制。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 描述 pod 的节点关联性调度规则。 |
|
| 描述 pod 关联性调度规则(例如,将此 pod 放置到同一节点、区域等)。 |
|
| 描述 pod 反关联性调度规则(例如,避免将此 pod 放置到同一节点、区等)。 |
14.2.1.3. .spec.affinity.nodeAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 的节点关联性调度规则。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、必需DuringScheduling 关联性表达式等)的节点,通过迭代此字段元素并在总和中添加"权重"来计算总和,如果节点与对应的 matchExpressions 匹配;最高总和最高的节点是首选的。 |
|
| 空的首选调度术语与所有带有隐式权重 0 的对象匹配(例如,它是一个 no-op)。空首选调度术语不匹配任何对象(例如,也不是 no-op)。 |
|
| 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间某个时间点上满足此字段指定的关联性要求(例如,由于更新),系统可能无法最终尝试从其节点驱除 pod。 |
- 描述
- 调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、必需DuringScheduling 关联性表达式等)的节点,通过迭代此字段元素并在总和中添加"权重"来计算总和,如果节点与对应的 matchExpressions 匹配;最高总和最高的节点是首选的。
- 类型
-
array
- 描述
- 空的首选调度术语与所有带有隐式权重 0 的对象匹配(例如,它是一个 no-op)。空首选调度术语不匹配任何对象(例如,也不是 no-op)。
- 类型
-
对象
- 必填
-
preference
-
weight
-
属性 | 类型 | 描述 |
---|---|---|
|
| 节点选择器,与对应的权重相关联。 |
|
| 与对应 nodeSelectorTerm 匹配的权重,在 1 到 100 之间。 |
- 描述
- 节点选择器,与对应的权重相关联。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 按节点标签划分的节点选择器要求列表。 |
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| 按节点字段的节点选择器要求列表。 |
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| 选择器应用到的标签键。 |
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。 |
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,该元素将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 按节点字段的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| 选择器应用到的标签键。 |
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。 |
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,该元素将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间某个时间点上满足此字段指定的关联性要求(例如,由于更新),系统可能无法最终尝试从其节点驱除 pod。
- 类型
-
对象
- 必填
-
nodeSelectorTerms
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需。节点选择器术语列表。术语为 ORed。 |
|
| 空或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。 |
- 描述
- 必需。节点选择器术语列表。术语为 ORed。
- 类型
-
array
- 描述
- 空或空节点选择器术语不匹配任何对象。它们的要求是 AND。TopologySelectorTerm 类型实现 NodeSelectorTerm 的子集。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 按节点标签划分的节点选择器要求列表。 |
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| 按节点字段的节点选择器要求列表。 |
|
| 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
- 描述
- 按节点标签划分的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| 选择器应用到的标签键。 |
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。 |
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,该元素将解释为整数。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 按节点字段的节点选择器要求列表。
- 类型
-
array
- 描述
- 节点选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| 选择器应用到的标签键。 |
|
| 代表键与一组值的关系。有效的运算符为 In、NotIn、Exists、DoesNotExist。gt 和 Lt。 |
|
| 字符串值数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。如果运算符是 Gt 或 Lt,则值数组必须具有单个元素,该元素将解释为整数。这个数组会在策略性合并补丁中被替换。 |
14.2.1.18. .spec.affinity.podAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 关联性调度规则(例如,将此 pod 放置到同一节点、区域等)。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、必需DuringScheduling 关联性表达式等)的节点,通过迭代此字段元素并在总和中添加"权重"的总和,如果节点具有与对应 podAffinityTerm 匹配的 pod,以及最高总和最高的节点。 |
|
| 每个节点会添加所有匹配的 WeightedPodAffinityTerm 字段的权重,以查找最首选的节点。 |
|
| 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间某个时间点上满足此字段指定的关联性要求(例如,由于 pod 标签更新),系统可能也可能不最终尝试从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表会交集,例如所有术语都必须满足。 |
|
| 定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod (即,这个 pod 应该与运行 pod 的 pod 共存(关联性)或非并置(反关联性)匹配,其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行,其键为 <topologyKey> 匹配。 |
- 描述
- 调度程序希望将 pod 调度到满足此字段指定的关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、必需DuringScheduling 关联性表达式等)的节点,通过迭代此字段元素并在总和中添加"权重"的总和,如果节点具有与对应 podAffinityTerm 匹配的 pod,以及最高总和最高的节点。
- 类型
-
array
- 描述
- 每个节点会添加所有匹配的 WeightedPodAffinityTerm 字段的权重,以查找最首选的节点。
- 类型
-
对象
- 必填
-
podAffinityTerm
-
weight
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需。与对应的权重关联的 pod 关联性术语。 |
|
| 与对应 podAffinityTerm 匹配的权重在 1-100 之间。 |
- 描述
- 必需。与对应的权重关联的 pod 关联性术语。
- 类型
-
对象
- 必填
-
topologyKey
-
属性 | 类型 | 描述 |
---|---|---|
|
| 对一组资源进行的标签查询,本例中为 pod。 |
|
| namespaces 指定 labelSelector 应用到的命名空间(匹配); null 或空列表表示"此 pod 的命名空间" |
|
| 此 pod 应该并置(关联性)或与指定命名空间中的 labelSelector 匹配的 pod 共处(反关联性),其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。 |
- 描述
- 对一组资源进行的标签查询,本例中为 pod。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间某个时间点上满足此字段指定的关联性要求(例如,由于 pod 标签更新),系统可能也可能不最终尝试从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表会交集,例如所有术语都必须满足。
- 类型
-
array
- 描述
- 定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod (即,这个 pod 应该与运行 pod 的 pod 共存(关联性)或非并置(反关联性)匹配,其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行,其键为 <topologyKey> 匹配。
- 类型
-
对象
- 必填
-
topologyKey
-
属性 | 类型 | 描述 |
---|---|---|
|
| 对一组资源进行的标签查询,本例中为 pod。 |
|
| namespaces 指定 labelSelector 应用到的命名空间(匹配); null 或空列表表示"此 pod 的命名空间" |
|
| 此 pod 应该并置(关联性)或与指定命名空间中的 labelSelector 匹配的 pod 共处(反关联性),其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。 |
- 描述
- 对一组资源进行的标签查询,本例中为 pod。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.30. .spec.affinity.podAntiAffinity 复制链接链接已复制到粘贴板!
- 描述
- 描述 pod 反关联性调度规则(例如,避免将此 pod 放置到同一节点、区等)。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 调度程序希望将 pod 调度到满足此字段指定的反关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、所需的DuringScheduling 反关联性表达式等)的节点,通过迭代此字段的元素以及 "weight" 的总和,如果节点具有与对应 podAffinityTerm 匹配的 pod,以及最高总和最高的节点。 |
|
| 每个节点会添加所有匹配的 WeightedPodAffinityTerm 字段的权重,以查找最首选的节点。 |
|
| 如果在调度时没有满足此字段指定的反关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间发生此字段指定的反关联性要求(例如,由于 pod 标签更新),系统可能最终尝试从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表会交集,例如所有术语都必须满足。 |
|
| 定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod (即,这个 pod 应该与运行 pod 的 pod 共存(关联性)或非并置(反关联性)匹配,其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行,其键为 <topologyKey> 匹配。 |
- 描述
- 调度程序希望将 pod 调度到满足此字段指定的反关联性表达式的节点,但可以选择违反一个或多个表达式的节点。最首选的节点是,具有最高权重和最高权重的节点,即满足所有调度要求(资源请求、所需的DuringScheduling 反关联性表达式等)的节点,通过迭代此字段的元素以及 "weight" 的总和,如果节点具有与对应 podAffinityTerm 匹配的 pod,以及最高总和最高的节点。
- 类型
-
array
- 描述
- 每个节点会添加所有匹配的 WeightedPodAffinityTerm 字段的权重,以查找最首选的节点。
- 类型
-
对象
- 必填
-
podAffinityTerm
-
weight
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需。与对应的权重关联的 pod 关联性术语。 |
|
| 与对应 podAffinityTerm 匹配的权重在 1-100 之间。 |
- 描述
- 必需。与对应的权重关联的 pod 关联性术语。
- 类型
-
对象
- 必填
-
topologyKey
-
属性 | 类型 | 描述 |
---|---|---|
|
| 对一组资源进行的标签查询,本例中为 pod。 |
|
| namespaces 指定 labelSelector 应用到的命名空间(匹配); null 或空列表表示"此 pod 的命名空间" |
|
| 此 pod 应该并置(关联性)或与指定命名空间中的 labelSelector 匹配的 pod 共处(反关联性),其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。 |
- 描述
- 对一组资源进行的标签查询,本例中为 pod。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
- 描述
- 如果在调度时没有满足此字段指定的反关联性要求,则 pod 不会调度到该节点上。如果在 pod 执行期间发生此字段指定的反关联性要求(例如,由于 pod 标签更新),系统可能最终尝试从其节点驱除 pod。当有多个元素时,与每个 podAffinityTerm 对应的节点列表会交集,例如所有术语都必须满足。
- 类型
-
array
- 描述
- 定义一组与给定命名空间匹配的 labelSelector 匹配的一组 pod (即,这个 pod 应该与运行 pod 的 pod 共存(关联性)或非并置(反关联性)匹配,其中 co-located 定义为在带有 <topologyKey> 标签值的节点上运行,其键为 <topologyKey> 匹配。
- 类型
-
对象
- 必填
-
topologyKey
-
属性 | 类型 | 描述 |
---|---|---|
|
| 对一组资源进行的标签查询,本例中为 pod。 |
|
| namespaces 指定 labelSelector 应用到的命名空间(匹配); null 或空列表表示"此 pod 的命名空间" |
|
| 此 pod 应该并置(关联性)或与指定命名空间中的 labelSelector 匹配的 pod 共处(反关联性),其中 co-located 定义为运行任何带有 key topologyKey 的标签值的节点上运行。不允许空的 topologyKey。 |
- 描述
- 对一组资源进行的标签查询,本例中为 pod。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.42. .spec.alertmanagerConfigNamespaceSelector 复制链接链接已复制到粘贴板!
- 描述
- 为 AlertmanagerConfig 发现选择的命名空间。如果为 nil,则只检查自己的命名空间。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.45. .spec.alertmanagerConfigSelector 复制链接链接已复制到粘贴板!
- 描述
- 为合并和配置 Alertmanager 的 alertmanagerconfigs。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.48. .spec.containers 复制链接链接已复制到粘贴板!
- 描述
-
容器允许注入其他容器。这是允许在 Alertmanager pod 中添加身份验证代理。如果容器共享相同名称和修改是通过策略合并补丁进行的,则此处描述的容器会修改 Operator 生成的容器。当前容器名称为:
alertmanager
和config-reloader
。覆盖容器完全不在维护人员支持的范围之外,您可以接受这种行为可能会随时中断,而不会注意到。 - 类型
-
array
14.2.1.49. .spec.containers[] 复制链接链接已复制到粘贴板!
- 描述
- 要在 pod 中运行的单一应用程序容器。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 入口点的参数。如果没有提供,则使用 docker 镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (VAR_NAME)进行转义。转义的引用永远不会扩展,无论变量是否存在。无法更新。更多信息: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| ENTRYPOINT 数组。不在 shell 中执行。如果没有提供,则使用 docker 镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (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 的源 |
|
| Docker 镜像名称。更多信息: https://kubernetes.io/docs/concepts/containers/images 此字段是可选的,允许更高级别的配置管理在工作负载控制器(如 Deployment 和 StatefulSets)中覆盖默认或覆盖容器镜像。 |
|
| 镜像拉取策略。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"地址的端口都可从网络访问。无法更新。 |
|
| containerPort 代表单个容器中的网络端口。 |
|
| 容器服务的定期探测。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| pod 应该使用的安全选项运行。更多信息: https://kubernetes.io/docs/concepts/policy/security-context/ 更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
| startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或热缓存时,而不是处于 steady-state 操作期间。无法更新。这是 StartupProbe 功能标记启用的 beta 功能。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 此容器是否应该为容器运行时中的 stdin 分配缓冲区。如果没有设置,则容器中的 stdin 读取始终会导致 EOF。默认值为 false。 |
|
| 容器运行时是否应该在单个附加打开后关闭 stdin 频道。当 stdin 为 true 时,stdstd 流将在多个附加会话之间保持打开。如果 stdinOnce 设为 true,则 stdin 会在容器启动时打开,直到第一个客户端附加到 stdin 前,然后保持打开并接受数据,直到客户端断开连接,此时 stdin 被关闭并保持关闭状态,直到容器重启为止。如果此标志为 false,则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false |
|
| 可选:将容器终止消息写入容器文件系统中的路径。编写的消息旨在是短暂的最终状态,如断言失败消息。如果大于 4096 字节,则节点将被节点截断。所有容器的总消息长度限制为 12kb。默认为 /dev/termination-log。无法更新。 |
|
| 指明终止消息应如何填充。文件将使用 terminationMessagePath 的内容在成功和失败时填充容器状态消息。如果终止消息文件为空,且容器退出并显示错误,则 FallbackToLogsOnError 将使用容器日志输出的最后块。日志输出限制为 2048 字节或 80 行(以小)。默认为 file。无法更新。 |
|
| 此容器是否应为其自身分配一个 一 个,还需要"stdin"为 true。默认值为 false。 |
|
| volumeDevices 是容器要使用的块设备列表。 |
|
| volumeDevice 描述了容器中原始块设备的映射。 |
|
| 要挂载到容器文件系统的 Pod 卷。无法更新。 |
|
| VolumeMount 描述了容器内卷的挂载。 |
|
| 容器的工作目录。如果没有指定,则使用容器运行时的默认值,这可能会在容器镜像中配置。无法更新。 |
14.2.1.50. .spec.containers[].env 复制链接链接已复制到粘贴板!
- 描述
- 要在容器中设置的环境变量列表。无法更新。
- 类型
-
array
14.2.1.51. .spec.containers[].env[] 复制链接链接已复制到粘贴板!
- 描述
- EnvVar 代表容器中存在的环境变量。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 环境变量的名称。必须是 C_IDENTIFIER。 |
|
| 变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (VAR_NAME)进行转义。转义的引用永远不会扩展,无论变量是否存在。默认值为 ""。 |
|
| 环境变量值的源。如果值不为空,则无法使用。 |
14.2.1.52. .spec.containers[].env[].valueFrom 复制链接链接已复制到粘贴板!
- 描述
- 环境变量值的源。如果值不为空,则无法使用。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 选择 ConfigMap 的键。 |
|
| 选择 pod 的字段:支持 metadata.name、metadata.namespace、metadata.labels、metadata.annotations、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。 |
|
| 选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。 |
|
| 在 pod 命名空间中选择一个 secret 的密钥 |
- 描述
- 选择 ConfigMap 的键。
- 类型
-
对象
- 必填
-
key
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要选择的键。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap 还是其密钥 |
14.2.1.54. .spec.containers[].env[].valueFrom.fieldRef 复制链接链接已复制到粘贴板!
- 描述
- 选择 pod 的字段:支持 metadata.name、metadata.namespace、metadata.labels、metadata.annotations、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。
- 类型
-
对象
- 必填
-
fieldPath
-
属性 | 类型 | 描述 |
---|---|---|
|
| FieldPath 编写的模式版本,默认为 "v1"。 |
|
| 要在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。
- 类型
-
对象
- 必填
-
resource
-
属性 | 类型 | 描述 |
---|---|---|
|
| 容器名称:卷需要,对于 env vars 是可选的 |
|
| 指定公开资源的输出格式,默认为 "1" |
|
| 必需:要选择的资源 |
- 描述
- 在 pod 命名空间中选择一个 secret 的密钥
- 类型
-
对象
- 必填
-
key
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 Secret 还是其密钥 |
14.2.1.57. .spec.containers[].envFrom 复制链接链接已复制到粘贴板!
- 描述
- 在容器中填充环境变量的源列表。源中定义的密钥必须是 C_IDENTIFIER。容器启动时,所有无效密钥都会报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。
- 类型
-
array
14.2.1.58. .spec.containers[].envFrom[] 复制链接链接已复制到粘贴板!
- 描述
- EnvFromSource 代表一组 ConfigMap 的源
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 要从中选择的 ConfigMap |
|
| ConfigMap 中每个键的可选标识符。必须是 C_IDENTIFIER。 |
|
| 要从中选择的 Secret |
14.2.1.59. .spec.containers[].envFrom[].configMapRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 ConfigMap
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap |
14.2.1.60. .spec.containers[].envFrom[].secretRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 Secret
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 Secret |
14.2.1.61. .spec.containers[].lifecycle 复制链接链接已复制到粘贴板!
- 描述
- 管理系统应采取的操作响应容器生命周期事件。无法更新。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| postStart 在容器创建后立即调用。如果处理程序失败,容器将被终止并根据重启策略重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
| 由于 API 请求或管理事件(如存活度/启动探测失败、抢占、资源争用等),在容器终止之前调用 preStop。如果容器崩溃或退出,则不会调用处理程序。终止发送到处理器的原因。Pod 的终止宽限期计数在执行 PreStop hooked 之前开始。无论处理程序的结果是什么,容器最终会在 Pod 终止宽限期内终止。容器块的其他管理,直到 hook 完成或直到达到终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
14.2.1.62. .spec.containers[].lifecycle.postStart 复制链接链接已复制到粘贴板!
- 描述
- postStart 在容器创建后立即调用。如果处理程序失败,容器将被终止并根据重启策略重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
14.2.1.63. .spec.containers[].lifecycle.postStart.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.68. .spec.containers[].lifecycle.preStop 复制链接链接已复制到粘贴板!
- 描述
- 由于 API 请求或管理事件(如存活度/启动探测失败、抢占、资源争用等),在容器终止之前调用 preStop。如果容器崩溃或退出,则不会调用处理程序。终止发送到处理器的原因。Pod 的终止宽限期计数在执行 PreStop hooked 之前开始。无论处理程序的结果是什么,容器最终会在 Pod 终止宽限期内终止。容器块的其他管理,直到 hook 完成或直到达到终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
14.2.1.69. .spec.containers[].lifecycle.preStop.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.70. .spec.containers[].lifecycle.preStop.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.74. .spec.containers[].livenessProbe 复制链接链接已复制到粘贴板!
- 描述
- 定期探测容器存活度。如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.75. .spec.containers[].livenessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.76. .spec.containers[].livenessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
14.2.1.79. .spec.containers[].livenessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.80. .spec.containers[].ports 复制链接链接已复制到粘贴板!
- 描述
- 要从容器公开的端口列表。在此处公开端口可让系统有关容器使用的网络连接的额外信息,但主要是信息。在这里不指定端口不阻止公开该端口。任何侦听容器内的默认"0.0.0.0"地址的端口都可从网络访问。无法更新。
- 类型
-
array
14.2.1.81. .spec.containers[].ports[] 复制链接链接已复制到粘贴板!
- 描述
- containerPort 代表单个容器中的网络端口。
- 类型
-
对象
- 必填
-
containerPort
-
属性 | 类型 | 描述 |
---|---|---|
|
| 在 pod IP 地址上公开的端口数量。这必须是有效的端口号 0 < x < 65536。 |
|
| 将外部端口绑定到的主机 IP。 |
|
| 主机上公开的端口数量。如果指定,这必须是有效的端口号 0 < x < 65536。如果指定了 HostNetwork,则必须与 ContainerPort 匹配。大多数容器都不需要此操作。 |
|
| 如果指定,这必须是 pod 中的 IANA_SVC_NAME 和 unique。pod 中的每个命名端口都必须具有唯一的名称。服务可以引用的端口的名称。 |
|
| 端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。 |
14.2.1.82. .spec.containers[].readinessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器服务的定期探测。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.83. .spec.containers[].readinessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.84. .spec.containers[].readinessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
14.2.1.87. .spec.containers[].readinessProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.88. .spec.containers[].resources 复制链接链接已复制到粘贴板!
- 描述
- 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
14.2.1.89. .spec.containers[].securityContext 复制链接链接已复制到粘贴板!
- 描述
- pod 应该使用的安全选项运行。更多信息: https://kubernetes.io/docs/concepts/policy/security-context/ 更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| allowPrivilegeEscalation 控制进程是否可以获得比父进程更多的特权。此 bool 直接控制是否在容器进程上设置 no_new_privs 标志。当容器为 1 时,allowPrivilegeEscalation 始终为 true,作为 Privileged 2 运行)具有 CAP_SYS_ADMIN |
|
| 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。 |
|
| 以特权模式运行容器。特权容器中的进程基本上相当于主机上的 root。默认为false。 |
|
| procMount 表示要用于容器的 proc 挂载类型。默认为 DefaultProcMount,它对只读路径和屏蔽的路径使用容器运行时默认值。这需要启用 ProcMountType 功能标记。 |
|
| 此容器是否具有只读根文件系统。默认值为 false。 |
|
| 运行容器进程的入口点的 GID。如果未设置,则使用运行时默认值。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不会以 UID 0 (root)运行,如果容器确实正常运行。如果未设置或为 false,则不会执行这样的验证。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 运行容器进程的入口点的 UID。如果未指定,则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 应用到所有容器的 Windows 具体设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
- 描述
- 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 添加了功能 |
|
| 删除的功能 |
- 描述
- 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| level 是应用到容器的 SELinux 级别标签。 |
|
| Role 是一个适用于容器的 SELinux 角色标签。 |
|
| type 是应用到容器的 SELinux 类型标签。 |
|
| 用户是应用到容器的 SELinux 用户标签。 |
- 描述
- 应用到所有容器的 Windows 具体设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpecName 字段命名的 GMSA 凭证规格的内容。 |
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
| Windows 中的 UserName,用于运行容器进程的入口点。如果未指定,则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
14.2.1.93. .spec.containers[].startupProbe 复制链接链接已复制到粘贴板!
- 描述
- startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或热缓存时,而不是处于 steady-state 操作期间。无法更新。这是 StartupProbe 功能标记启用的 beta 功能。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.94. .spec.containers[].startupProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.95. .spec.containers[].startupProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
14.2.1.98. .spec.containers[].startupProbe.tcpSocket 复制链接链接已复制到粘贴板!
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.99. .spec.containers[].volumeDevices 复制链接链接已复制到粘贴板!
- 描述
- volumeDevices 是容器要使用的块设备列表。
- 类型
-
array
14.2.1.100. .spec.containers[].volumeDevices[] 复制链接链接已复制到粘贴板!
- 描述
- volumeDevice 描述了容器中原始块设备的映射。
- 类型
-
对象
- 必填
-
devicePath
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| DevicePath 是设备要映射到的容器内的路径。 |
|
| 名称必须与 pod 中的 persistentVolumeClaim 的名称匹配 |
14.2.1.101. .spec.containers[].volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- 要挂载到容器文件系统的 Pod 卷。无法更新。
- 类型
-
array
14.2.1.102. .spec.containers[].volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷的挂载。
- 类型
-
对象
- 必填
-
mountPath
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 应该挂载卷的容器内的路径。不得包含 ':'。 |
|
| mountPropagation 决定如何将挂载从主机传播到容器,以及传输的其他方式。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。 |
|
| 这必须与卷的名称匹配。 |
|
| 如果为 true,则以只读形式挂载,否则为读写(false 或未指定)。默认为false。 |
|
| 应该从中挂载容器卷的卷内的路径。默认为 "" (卷的 root)。 |
|
| 在卷中应该挂载容器的卷的扩展路径。的行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
14.2.1.103. .spec.imagePullSecrets 复制链接链接已复制到粘贴板!
- 描述
- 用于从 registry 中拉取 prometheus 和 alertmanager 镜像的 secret 的可选引用列表,请参阅 http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod
- 类型
-
array
14.2.1.104. .spec.imagePullSecrets[] 复制链接链接已复制到粘贴板!
- 描述
- LocalObjectReference 包含足够信息,供您在同一命名空间中查找引用的对象。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.105. .spec.initContainers 复制链接链接已复制到粘贴板!
- 描述
- initContainers 允许将 initContainers 添加到 pod 定义中。它们可用于从外部来源获取用于注入 Alertmanager 配置的 secret。执行 initContainer 期间的任何错误将导致 Pod 重启。更多信息:使用 initContainers 进行其他用例的 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/,然后 secret 获取完全不在维护者支持的范围之外,因此您接受这个行为可能会随时中断,而不会注意到。
- 类型
-
array
14.2.1.106. .spec.initContainers[] 复制链接链接已复制到粘贴板!
- 描述
- 要在 pod 中运行的单一应用程序容器。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 入口点的参数。如果没有提供,则使用 docker 镜像的 CMD。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (VAR_NAME)进行转义。转义的引用永远不会扩展,无论变量是否存在。无法更新。更多信息: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
|
| ENTRYPOINT 数组。不在 shell 中执行。如果没有提供,则使用 docker 镜像的 ENTRYPOINT。变量引用 $(VAR_NAME)使用容器的环境扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (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 的源 |
|
| Docker 镜像名称。更多信息: https://kubernetes.io/docs/concepts/containers/images 此字段是可选的,允许更高级别的配置管理在工作负载控制器(如 Deployment 和 StatefulSets)中覆盖默认或覆盖容器镜像。 |
|
| 镜像拉取策略。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"地址的端口都可从网络访问。无法更新。 |
|
| containerPort 代表单个容器中的网络端口。 |
|
| 容器服务的定期探测。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| pod 应该使用的安全选项运行。更多信息: https://kubernetes.io/docs/concepts/policy/security-context/ 更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ |
|
| startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或热缓存时,而不是处于 steady-state 操作期间。无法更新。这是 StartupProbe 功能标记启用的 beta 功能。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 此容器是否应该为容器运行时中的 stdin 分配缓冲区。如果没有设置,则容器中的 stdin 读取始终会导致 EOF。默认值为 false。 |
|
| 容器运行时是否应该在单个附加打开后关闭 stdin 频道。当 stdin 为 true 时,stdstd 流将在多个附加会话之间保持打开。如果 stdinOnce 设为 true,则 stdin 会在容器启动时打开,直到第一个客户端附加到 stdin 前,然后保持打开并接受数据,直到客户端断开连接,此时 stdin 被关闭并保持关闭状态,直到容器重启为止。如果此标志为 false,则从 stdin 读取的容器进程永远不会收到 EOF。默认为 false |
|
| 可选:将容器终止消息写入容器文件系统中的路径。编写的消息旨在是短暂的最终状态,如断言失败消息。如果大于 4096 字节,则节点将被节点截断。所有容器的总消息长度限制为 12kb。默认为 /dev/termination-log。无法更新。 |
|
| 指明终止消息应如何填充。文件将使用 terminationMessagePath 的内容在成功和失败时填充容器状态消息。如果终止消息文件为空,且容器退出并显示错误,则 FallbackToLogsOnError 将使用容器日志输出的最后块。日志输出限制为 2048 字节或 80 行(以小)。默认为 file。无法更新。 |
|
| 此容器是否应为其自身分配一个 一 个,还需要"stdin"为 true。默认值为 false。 |
|
| volumeDevices 是容器要使用的块设备列表。 |
|
| volumeDevice 描述了容器中原始块设备的映射。 |
|
| 要挂载到容器文件系统的 Pod 卷。无法更新。 |
|
| VolumeMount 描述了容器内卷的挂载。 |
|
| 容器的工作目录。如果没有指定,则使用容器运行时的默认值,这可能会在容器镜像中配置。无法更新。 |
14.2.1.107. .spec.initContainers[].env 复制链接链接已复制到粘贴板!
- 描述
- 要在容器中设置的环境变量列表。无法更新。
- 类型
-
array
14.2.1.108. .spec.initContainers[].env[] 复制链接链接已复制到粘贴板!
- 描述
- EnvVar 代表容器中存在的环境变量。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 环境变量的名称。必须是 C_IDENTIFIER。 |
|
| 变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量,则输入字符串中的引用不会改变。$(VAR_NAME)语法可以使用双 ie: (VAR_NAME)进行转义。转义的引用永远不会扩展,无论变量是否存在。默认值为 ""。 |
|
| 环境变量值的源。如果值不为空,则无法使用。 |
14.2.1.109. .spec.initContainers[].env[].valueFrom 复制链接链接已复制到粘贴板!
- 描述
- 环境变量值的源。如果值不为空,则无法使用。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 选择 ConfigMap 的键。 |
|
| 选择 pod 的字段:支持 metadata.name、metadata.namespace、metadata.labels、metadata.annotations、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。 |
|
| 选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。 |
|
| 在 pod 命名空间中选择一个 secret 的密钥 |
- 描述
- 选择 ConfigMap 的键。
- 类型
-
对象
- 必填
-
key
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要选择的键。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap 还是其密钥 |
- 描述
- 选择 pod 的字段:支持 metadata.name、metadata.namespace、metadata.labels、metadata.annotations、spec.nodeName、spec.serviceAccountName、status.hostIP、status.podIP、status.podIPs。
- 类型
-
对象
- 必填
-
fieldPath
-
属性 | 类型 | 描述 |
---|---|---|
|
| FieldPath 编写的模式版本,默认为 "v1"。 |
|
| 要在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限值和请求(limits.cpu、limit.memory、limit.ephemeral-storage、request.cpu、request.memory 和 requests.ephemeral-storage)。
- 类型
-
对象
- 必填
-
resource
-
属性 | 类型 | 描述 |
---|---|---|
|
| 容器名称:卷需要,对于 env vars 是可选的 |
|
| 指定公开资源的输出格式,默认为 "1" |
|
| 必需:要选择的资源 |
- 描述
- 在 pod 命名空间中选择一个 secret 的密钥
- 类型
-
对象
- 必填
-
key
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 Secret 还是其密钥 |
14.2.1.114. .spec.initContainers[].envFrom 复制链接链接已复制到粘贴板!
- 描述
- 在容器中填充环境变量的源列表。源中定义的密钥必须是 C_IDENTIFIER。容器启动时,所有无效密钥都会报告为事件。当多个源中存在键时,与最后一个源关联的值将具有优先权。由带有重复键的 Env 定义的值将具有优先权。无法更新。
- 类型
-
array
14.2.1.115. .spec.initContainers[].envFrom[] 复制链接链接已复制到粘贴板!
- 描述
- EnvFromSource 代表一组 ConfigMap 的源
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 要从中选择的 ConfigMap |
|
| ConfigMap 中每个键的可选标识符。必须是 C_IDENTIFIER。 |
|
| 要从中选择的 Secret |
- 描述
- 要从中选择的 ConfigMap
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap |
14.2.1.117. .spec.initContainers[].envFrom[].secretRef 复制链接链接已复制到粘贴板!
- 描述
- 要从中选择的 Secret
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 Secret |
14.2.1.118. .spec.initContainers[].lifecycle 复制链接链接已复制到粘贴板!
- 描述
- 管理系统应采取的操作响应容器生命周期事件。无法更新。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| postStart 在容器创建后立即调用。如果处理程序失败,容器将被终止并根据重启策略重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
|
| 由于 API 请求或管理事件(如存活度/启动探测失败、抢占、资源争用等),在容器终止之前调用 preStop。如果容器崩溃或退出,则不会调用处理程序。终止发送到处理器的原因。Pod 的终止宽限期计数在执行 PreStop hooked 之前开始。无论处理程序的结果是什么,容器最终会在 Pod 终止宽限期内终止。容器块的其他管理,直到 hook 完成或直到达到终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks |
14.2.1.119. .spec.initContainers[].lifecycle.postStart 复制链接链接已复制到粘贴板!
- 描述
- postStart 在容器创建后立即调用。如果处理程序失败,容器将被终止并根据重启策略重启。容器块的其他管理,直到 hook 完成为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.125. .spec.initContainers[].lifecycle.preStop 复制链接链接已复制到粘贴板!
- 描述
- 由于 API 请求或管理事件(如存活度/启动探测失败、抢占、资源争用等),在容器终止之前调用 preStop。如果容器崩溃或退出,则不会调用处理程序。终止发送到处理器的原因。Pod 的终止宽限期计数在执行 PreStop hooked 之前开始。无论处理程序的结果是什么,容器最终会在 Pod 终止宽限期内终止。容器块的其他管理,直到 hook 完成或直到达到终止宽限期为止。更多信息: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.131. .spec.initContainers[].livenessProbe 复制链接链接已复制到粘贴板!
- 描述
- 定期探测容器存活度。如果探测失败,容器将重启。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.132. .spec.initContainers[].livenessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.133. .spec.initContainers[].livenessProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.137. .spec.initContainers[].ports 复制链接链接已复制到粘贴板!
- 描述
- 要从容器公开的端口列表。在此处公开端口可让系统有关容器使用的网络连接的额外信息,但主要是信息。在这里不指定端口不阻止公开该端口。任何侦听容器内的默认"0.0.0.0"地址的端口都可从网络访问。无法更新。
- 类型
-
array
14.2.1.138. .spec.initContainers[].ports[] 复制链接链接已复制到粘贴板!
- 描述
- containerPort 代表单个容器中的网络端口。
- 类型
-
对象
- 必填
-
containerPort
-
属性 | 类型 | 描述 |
---|---|---|
|
| 在 pod IP 地址上公开的端口数量。这必须是有效的端口号 0 < x < 65536。 |
|
| 将外部端口绑定到的主机 IP。 |
|
| 主机上公开的端口数量。如果指定,这必须是有效的端口号 0 < x < 65536。如果指定了 HostNetwork,则必须与 ContainerPort 匹配。大多数容器都不需要此操作。 |
|
| 如果指定,这必须是 pod 中的 IANA_SVC_NAME 和 unique。pod 中的每个命名端口都必须具有唯一的名称。服务可以引用的端口的名称。 |
|
| 端口的协议。必须是 UDP、TCP 或 SCTP。默认为 "TCP"。 |
14.2.1.139. .spec.initContainers[].readinessProbe 复制链接链接已复制到粘贴板!
- 描述
- 容器服务的定期探测。如果探测失败,容器将从服务端点中删除。无法更新。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.140. .spec.initContainers[].readinessProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.145. .spec.initContainers[].resources 复制链接链接已复制到粘贴板!
- 描述
- 此容器所需的计算资源。无法更新。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
14.2.1.146. .spec.initContainers[].securityContext 复制链接链接已复制到粘贴板!
- 描述
- pod 应该使用的安全选项运行。更多信息: https://kubernetes.io/docs/concepts/policy/security-context/ 更多信息: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| allowPrivilegeEscalation 控制进程是否可以获得比父进程更多的特权。此 bool 直接控制是否在容器进程上设置 no_new_privs 标志。当容器为 1 时,allowPrivilegeEscalation 始终为 true,作为 Privileged 2 运行)具有 CAP_SYS_ADMIN |
|
| 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。 |
|
| 以特权模式运行容器。特权容器中的进程基本上相当于主机上的 root。默认为false。 |
|
| procMount 表示要用于容器的 proc 挂载类型。默认为 DefaultProcMount,它对只读路径和屏蔽的路径使用容器运行时默认值。这需要启用 ProcMountType 功能标记。 |
|
| 此容器是否具有只读根文件系统。默认值为 false。 |
|
| 运行容器进程的入口点的 GID。如果未设置,则使用运行时默认值。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不会以 UID 0 (root)运行,如果容器确实正常运行。如果未设置或为 false,则不会执行这样的验证。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 运行容器进程的入口点的 UID。如果未指定,则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 应用到所有容器的 Windows 具体设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
- 描述
- 运行容器时添加/丢弃的功能。默认为容器运行时授予的默认功能集。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 添加了功能 |
|
| 删除的功能 |
- 描述
- 要应用到容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| level 是应用到容器的 SELinux 级别标签。 |
|
| Role 是一个适用于容器的 SELinux 角色标签。 |
|
| type 是应用到容器的 SELinux 类型标签。 |
|
| 用户是应用到容器的 SELinux 用户标签。 |
- 描述
- 应用到所有容器的 Windows 具体设置。如果未指定,则使用 PodSecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpecName 字段命名的 GMSA 凭证规格的内容。 |
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
| Windows 中的 UserName,用于运行容器进程的入口点。如果未指定,则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
14.2.1.150. .spec.initContainers[].startupProbe 复制链接链接已复制到粘贴板!
- 描述
- startupProbe 表示 Pod 已成功初始化。如果指定,则不会执行其他探测,直到成功完成为止。如果这个探测失败,则 Pod 将重启,就像 livenessProbe 失败一样。这可用于在 Pod 生命周期开始时提供不同的探测参数,当可能需要很长时间才能加载数据或热缓存时,而不是处于 steady-state 操作期间。无法更新。这是 StartupProbe 功能标记启用的 beta 功能。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 应该只指定以下之一和其中之一。exec 指定要执行的操作。 |
|
| 成功后探测被视为失败的最小连续失败。默认值为 3。最小值为 1。 |
|
| httpGet 指定要执行的 http 请求。 |
|
| 在启动存活度探测前容器启动后的秒数。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 执行探测的频率(以秒为单位)。默认值为 10 秒。最小值为 1。 |
|
| 在失败后,探测的连续成功才被视为成功。默认值为 1。对于存活度和启动,必须是 1。最小值为 1。 |
|
| tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook |
|
| 探测超时的秒数。默认值为 1 秒。最小值为 1。更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.2.1.151. .spec.initContainers[].startupProbe.exec 复制链接链接已复制到粘贴板!
- 描述
- 应该只指定以下之一和其中之一。exec 指定要执行的操作。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| command 是在容器内执行的命令行,命令的工作目录是容器文件系统中的根目录('/')。命令只是 exec,它不在 shell 中运行,因此传统的 shell 指令('|' 等)将无法工作。要使用 shell,您需要明确调用至该 shell。退出状态 0 被视为 live/healthy,非零则被视为不健康。 |
14.2.1.152. .spec.initContainers[].startupProbe.httpGet 复制链接链接已复制到粘贴板!
- 描述
- httpGet 指定要执行的 http 请求。
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要连接的主机名,默认为 pod IP。您可能想在 httpHeaders 中设置 "Host"。 |
|
| 要在请求中设置的自定义标头。HTTP 允许重复标头。 |
|
| HTTPHeader 描述了在 HTTP 探测中使用的自定义标头 |
|
| 在 HTTP 服务器上访问的路径。 |
|
| 要在容器中访问的端口的名称或数。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
|
| 用于连接到主机的方案。默认为 HTTP。 |
- 描述
- 要在请求中设置的自定义标头。HTTP 允许重复标头。
- 类型
-
array
- 描述
- HTTPHeader 描述了在 HTTP 探测中使用的自定义标头
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 标头字段名称 |
|
| 标头字段值 |
- 描述
- tcpSocket 指定涉及 TCP 端口的操作。尚不支持 TCP hook:实现实际的 TCP 生命周期 hook
- 类型
-
对象
- 必填
-
port
-
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:要连接到的主机名,默认为 pod IP。 |
|
| 要在容器中访问的端口的数量或名称。数字必须在 1 到 65535 之间。名称必须是 IANA_SVC_NAME。 |
14.2.1.156. .spec.initContainers[].volumeDevices 复制链接链接已复制到粘贴板!
- 描述
- volumeDevices 是容器要使用的块设备列表。
- 类型
-
array
14.2.1.157. .spec.initContainers[].volumeDevices[] 复制链接链接已复制到粘贴板!
- 描述
- volumeDevice 描述了容器中原始块设备的映射。
- 类型
-
对象
- 必填
-
devicePath
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| DevicePath 是设备要映射到的容器内的路径。 |
|
| 名称必须与 pod 中的 persistentVolumeClaim 的名称匹配 |
14.2.1.158. .spec.initContainers[].volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- 要挂载到容器文件系统的 Pod 卷。无法更新。
- 类型
-
array
14.2.1.159. .spec.initContainers[].volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷的挂载。
- 类型
-
对象
- 必填
-
mountPath
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 应该挂载卷的容器内的路径。不得包含 ':'。 |
|
| mountPropagation 决定如何将挂载从主机传播到容器,以及传输的其他方式。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。 |
|
| 这必须与卷的名称匹配。 |
|
| 如果为 true,则以只读形式挂载,否则为读写(false 或未指定)。默认为false。 |
|
| 应该从中挂载容器卷的卷内的路径。默认为 "" (卷的 root)。 |
|
| 在卷中应该挂载容器的卷的扩展路径。的行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
14.2.1.160. .spec.podMetadata 复制链接链接已复制到粘贴板!
- 描述
- podMetadata 配置向 alertmanager pod 传播的标签和注解。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 注解是一个无结构的键值映射,与资源存储,可通过外部工具设置来存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: http://kubernetes.io/docs/user-guide/annotations |
|
| 可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: http://kubernetes.io/docs/user-guide/labels |
|
| 名称在命名空间中必须是唯一的。在创建资源时是必需的,但有些资源可能允许客户端自动请求生成适当名称。名称主要用于创建 idempotence 和配置定义。无法更新。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names |
14.2.1.161. .spec.resources 复制链接链接已复制到粘贴板!
- 描述
- 定义单个 Pod 的资源请求和限值。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
14.2.1.162. .spec.securityContext 复制链接链接已复制到粘贴板!
- 描述
- securityContext 包含 pod 级别的安全属性和通用容器设置。默认为默认的 PodSecurityContext。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 适用于 pod 中所有容器的特殊补充组。某些卷类型允许 Kubelet 更改该卷的所有权,使其归 pod 所有:1。拥有的 GID 将是 FSGroup 2。设定 setgid 位(卷中创建的新文件将归 FSGroup 所有)3。权限位是 OR'd with rw-rw----,如果未设置,Kubelet 不会修改任何卷的所有权和权限。 |
|
| fsGroupChangePolicy 定义在 Pod 中公开卷前更改卷的所有权和权限的行为。此字段仅适用于支持基于 fsGroup 的所有权(和权限)的卷类型。它对临时卷类型没有影响,如 secret、configmaps 和 emptydir。有效值为 "OnRootMismatch" 和 "Always"。如果没有指定,则默认为 "Always"。 |
|
| 运行容器进程的入口点的 GID。如果未设置,则使用运行时默认值。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将优先用于该容器。 |
|
| 表示容器必须以非 root 用户身份运行。如果为 true,Kubelet 将在运行时验证镜像,以确保它不会以 UID 0 (root)运行,如果容器确实正常运行。如果未设置或为 false,则不会执行这样的验证。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
|
| 运行容器进程的入口点的 UID。如果未指定,则默认为镜像元数据中指定的用户。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将优先用于该容器。 |
|
| 要应用到所有容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将优先用于该容器。 |
|
| 除了容器的主 GID 外,应用到每个容器中运行的第一个进程的组列表。如果未指定,则不会将任何组添加到任何容器中。 |
|
| sysctl 包含用于 pod 的命名空间 sysctl 列表。带有不支持的 sysctl (通过容器运行时)的 Pod 可能无法启动。 |
|
| sysctl 定义要设置的内核参数 |
|
| 应用到所有容器的 Windows 具体设置。如果未指定,则使用容器的 SecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
14.2.1.163. .spec.securityContext.seLinuxOptions 复制链接链接已复制到粘贴板!
- 描述
- 要应用到所有容器的 SELinux 上下文。如果未指定,容器运行时将为每个容器分配一个随机 SELinux 上下文。也可以在 SecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将优先用于该容器。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| level 是应用到容器的 SELinux 级别标签。 |
|
| Role 是一个适用于容器的 SELinux 角色标签。 |
|
| type 是应用到容器的 SELinux 类型标签。 |
|
| 用户是应用到容器的 SELinux 用户标签。 |
14.2.1.164. .spec.securityContext.sysctls 复制链接链接已复制到粘贴板!
- 描述
- sysctl 包含用于 pod 的命名空间 sysctl 列表。带有不支持的 sysctl (通过容器运行时)的 Pod 可能无法启动。
- 类型
-
array
14.2.1.165. .spec.securityContext.sysctls[] 复制链接链接已复制到粘贴板!
- 描述
- sysctl 定义要设置的内核参数
- 类型
-
对象
- 必填
-
name
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要设置的属性的名称 |
|
| 要设置的属性值 |
14.2.1.166. .spec.securityContext.windowsOptions 复制链接链接已复制到粘贴板!
- 描述
- 应用到所有容器的 Windows 具体设置。如果未指定,则使用容器的 SecurityContext 中的选项。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| GMSACredentialSpec 是 GMSA 准入 Webhook (https://github.com/kubernetes-sigs/windows-gmsa)内联由 GMSACredentialSpecName 字段命名的 GMSA 凭证规格的内容。 |
|
| GMSACredentialSpecName 是要使用的 GMSA 凭证规格的名称。 |
|
| Windows 中的 UserName,用于运行容器进程的入口点。如果未指定,则默认为镜像元数据中指定的用户。也可以在 PodSecurityContext 中设置。如果在 SecurityContext 和 PodSecurityContext 中设置,则 SecurityContext 的值将具有优先权。 |
14.2.1.167. .spec.storage 复制链接链接已复制到粘贴板!
- 描述
- Storage 是 Alertmanager 实例如何使用存储的定义。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 已弃用: 默认情况下,子路径使用量将在以后的版本中被禁用,这个选项将变得不必要的。DisableMountSubPath 允许删除卷挂载中的任何 subPath 使用量。 |
|
| Prometheus StatefulSets 使用的 EmptyDirVolumeSource。如果指定,则使用代替任何 volumeClaimTemplate。更多信息: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir |
|
| Prometheus StatefulSets 使用的 PVC spec。 |
14.2.1.168. .spec.storage.emptyDir 复制链接链接已复制到粘贴板!
- 描述
- Prometheus StatefulSets 使用的 EmptyDirVolumeSource。如果指定,则使用代替任何 volumeClaimTemplate。更多信息: https://kubernetes.io/docs/concepts/storage/volumes/#emptydir
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 哪个类型的存储介质应该支持此目录。默认值为 "",这意味着使用节点的默认介质。必须是空字符串(默认)或内存。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| 此 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存介质 EmptyDir 的最大使用量是此处指定的 SizeLimit 和 pod 中所有容器的总和之间的最小值。默认值为 nil,这意味着限制未定义。更多信息: http://kubernetes.io/docs/user-guide/volumes#emptydir |
14.2.1.169. .spec.storage.volumeClaimTemplate 复制链接链接已复制到粘贴板!
- 描述
- Prometheus StatefulSets 使用的 PVC spec。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 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 包含与 EmbededResource 相关的元数据。 |
|
| spec 定义 pod 作者请求的卷所需的特征。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| status 代表持久性卷声明的当前信息/状态。只读。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
14.2.1.170. .spec.storage.volumeClaimTemplate.metadata 复制链接链接已复制到粘贴板!
- 描述
- EmbeddedMetadata 包含与 EmbededResource 相关的元数据。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 注解是一个无结构的键值映射,与资源存储,可通过外部工具设置来存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: http://kubernetes.io/docs/user-guide/annotations |
|
| 可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: http://kubernetes.io/docs/user-guide/labels |
|
| 名称在命名空间中必须是唯一的。在创建资源时是必需的,但有些资源可能允许客户端自动请求生成适当名称。名称主要用于创建 idempotence 和配置定义。无法更新。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names |
14.2.1.171. .spec.storage.volumeClaimTemplate.spec 复制链接链接已复制到粘贴板!
- 描述
- spec 定义 pod 作者请求的卷所需的特征。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| accessModes 包含卷应具有所需的访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| 此字段可以用来指定现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot - Beta),如果置备程序或外部控制器支持指定的数据源,则必须启用适当的功能门(VolumeSnapshotDataSource 或任何VolumeDataSource)。 它将基于指定数据源的内容创建一个新卷。如果不支持指定的数据源,则不会创建该卷,且故障将报告为事件。未来,我们计划支持更多数据源类型,并且置备程序的行为可能会改变。 |
|
| resources 代表卷应具有的最小资源。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources |
|
| 要考虑绑定的卷的标签查询。 |
|
| 声明所需的 StorageClass 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeMode 定义声明需要哪些卷类型。如果没有包含在 claim spec 中,则 Filesystem 的值会被表示。 |
|
| volumeName 是支持此声明的 PersistentVolume 的绑定引用。 |
- 描述
- 此字段可以用来指定现有的 VolumeSnapshot 对象(snapshot.storage.k8s.io/VolumeSnapshot - Beta),如果置备程序或外部控制器支持指定的数据源,则必须启用适当的功能门(VolumeSnapshotDataSource 或任何VolumeDataSource)。 它将基于指定数据源的内容创建一个新卷。如果不支持指定的数据源,则不会创建该卷,且故障将报告为事件。未来,我们计划支持更多数据源类型,并且置备程序的行为可能会改变。
- 类型
-
对象
- 必填
-
kind
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| apigroup 是被引用资源的组。如果没有指定 APIGroup,则指定的 Kind 必须位于 core API 组中。对于任何其他第三方类型,需要 APIGroup。 |
|
| kind 是被引用的资源类型 |
|
| name 是被引用的资源的名称 |
- 描述
- resources 代表卷应具有的最小资源。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 限制描述了允许的最大计算资源量。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
|
| Requests 描述了所需的最少计算资源。如果容器省略了 Requests,则默认为 Limits (如果明确指定),否则默认为实现定义的值。更多信息: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ |
- 描述
- 要考虑绑定的卷的标签查询。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.177. .spec.storage.volumeClaimTemplate.status 复制链接链接已复制到粘贴板!
- 描述
- status 代表持久性卷声明的当前信息/状态。只读。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| accessModes 包含支持 PVC 的卷的实际访问模式。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| 代表基础卷的实际资源。 |
|
| 持久性卷声明的当前条件。如果底层持久性卷正在调整大小,则条件将被设置为 'ResizeStarted'。 |
|
| PersistentVolumeClaimCondition 提供有关 pvc 状态的详细信息 |
|
| phase 代表 PersistentVolumeClaim 的当前阶段。 |
- 描述
- 持久性卷声明的当前条件。如果底层持久性卷正在调整大小,则条件将被设置为 'ResizeStarted'。
- 类型
-
array
- 描述
- PersistentVolumeClaimCondition 提供有关 pvc 状态的详细信息
- 类型
-
对象
- 必填
-
status
-
type
-
属性 | 类型 | 描述 |
---|---|---|
|
| 最后一次探测到条件的时间。 |
|
| 条件从一个状态转换到另一个状态的时间。 |
|
| 人类可读的消息,指示最后一次转换的详细信息。 |
|
| 唯一,这应该是简短的、可理解的机器字符串,为条件最后一次转换提供原因。如果报告"ResizeStarted"表示底层持久性卷正在调整大小。 |
|
| |
|
| PersistentVolumeClaimConditionType 是 PersistentVolumeClaimCondition.Type 的有效值 |
14.2.1.180. .spec.tolerations 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的容限。
- 类型
-
array
14.2.1.181. .spec.tolerations[] 复制链接链接已复制到粘贴板!
- 描述
- 附加此 Toleration 的 pod,以使用匹配的 operator <operator> 来容许与 triple <key,value,effect> 匹配的任何污点。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| effect 表示污点效果要匹配的污点。空意味着匹配所有污点效果。指定后,允许的值为 NoSchedule、PreferNoSchedule 和 NoExecute。 |
|
| key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空,运算符必须是 Exists;此组合意味着匹配所有值和所有键。 |
|
| 运算符表示键与值的关系。有效的运算符为 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符,以便 pod 可以容忍特定类别的所有污点。 |
|
| tolerationSeconds 代表容限(必须具有 NoExecute effect,否则此字段将被忽略)容许污点的时间周期。默认情况下,它没有被设置,这意味着容许污点(不要驱除)。零值和负值将被视为系统 0 (立即撤离)。 |
|
| value 是容限匹配的污点值。如果运算符是 Exists,则该值应该为空,否则仅是一个常规字符串。 |
14.2.1.182. .spec.topologySpreadConstraints 复制链接链接已复制到粘贴板!
- 描述
- 如果指定,pod 的拓扑分布约束。
- 类型
-
array
14.2.1.183. .spec.topologySpreadConstraints[] 复制链接链接已复制到粘贴板!
- 描述
- TopologySpreadConstraint 指定如何将匹配的 pod 分散到给定拓扑中。
- 类型
-
对象
- 必填
-
maxSkew
-
topologyKey
-
whenUnsatisfiable
-
属性 | 类型 | 描述 |
---|---|---|
|
| labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算来确定其对应拓扑域中的 pod 数量。 |
|
| maxSkew 描述了 pod 可能不均匀分布的程度。它是给定拓扑类型的任意拓扑域中的匹配 pod 数量之间允许的最大差别。例如,在 3 区集群中,MaxSkew 设置为 1,且具有与 1/1/0: | zone1 | zone2 | zone2 | zone2 | zone2 | zone3 的相同 labelSelector 分布的 pod;如果 MaxSkew 为 1,则传入的 pod 只能调度到 zone3,使其调度到 zone1 (zone2) 将在 zone1 (zone2)上使 ActualSkew (2-0)违反 MaxSkew (1). - 如果 MaxSkew 为 2, 传入的 pod 可以调度到任何区域。这是必填字段。默认值为 1,不允许使用 0。 |
|
| topologyKey 是节点标签的密钥。带有具有此键和相同值标签的节点被视为在同一拓扑中。我们考虑每个 <key, value> 作为 "bucket",并尝试将 pod 数量放置到每个存储桶中。这是必填字段。 |
|
| whenUnsatisfiable 指示在没有满足分布约束时如何处理 pod。- DoNotSchedule (默认)告知调度程序不调度它 - ScheduleAnyway 会告知调度程序仍然在调度它时被视为 "Unsatisfiable",只有将传入的 pod 放置到任何拓扑上违反了 "MaxSkew"。例如,在 3 区集群中,MaxSkew 设置为 1,并且具有与 3/1/1: | zone1 | zone2 | zone3 | zone3 | zone2 | zone3 | zone3 的相同 labelSelector 分布的 pod,则传入的 pod 只能调度到 zone2 (zone3) 在 zone2 (zone3)满足 MaxSkew (1)上成为 3/2/1 (3/1/2)作为 ActualSkew (2-1)。换句话说,集群仍然可以进行平衡,但调度程序不会使其更不平衡。这是必填字段。 |
- 描述
- labelSelector 用于查找匹配的 pod。与此标签选择器匹配的 Pod 被计算来确定其对应拓扑域中的 pod 数量。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。 |
|
| 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。 |
|
| matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。 |
- 描述
- matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
- 类型
-
array
- 描述
- 标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
- 类型
-
对象
- 必填
-
key
-
operator
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是选择器应用到的标签键。 |
|
| 运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。 |
|
| 值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。 |
14.2.1.187. .spec.volumeMounts 复制链接链接已复制到粘贴板!
- 描述
- volumeMounts 允许在输出 StatefulSet 定义上配置额外的 VolumeMounts。指定 volumeMounts 将附加到 alertmanager 容器中的其他 VolumeMounts 中,后者由 StorageSpec 对象生成。
- 类型
-
array
14.2.1.188. .spec.volumeMounts[] 复制链接链接已复制到粘贴板!
- 描述
- VolumeMount 描述了容器内卷的挂载。
- 类型
-
对象
- 必填
-
mountPath
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| 应该挂载卷的容器内的路径。不得包含 ':'。 |
|
| mountPropagation 决定如何将挂载从主机传播到容器,以及传输的其他方式。如果没有设置,则使用 MountPropagationNone。此字段在 1.10 中是 beta。 |
|
| 这必须与卷的名称匹配。 |
|
| 如果为 true,则以只读形式挂载,否则为读写(false 或未指定)。默认为false。 |
|
| 应该从中挂载容器卷的卷内的路径。默认为 "" (卷的 root)。 |
|
| 在卷中应该挂载容器的卷的扩展路径。的行为与 SubPath 类似,但环境变量引用 $(VAR_NAME)使用容器的环境扩展。默认为 "" (卷的 root)。SubPathExpr 和 SubPath 是互斥的。 |
14.2.1.189. .spec.volumes 复制链接链接已复制到粘贴板!
- 描述
- 卷允许在输出 StatefulSet 定义中配置额外的卷。指定的卷将附加到因为 StorageSpec 对象生成的其他卷中。
- 类型
-
array
14.2.1.190. .spec.volumes[] 复制链接链接已复制到粘贴板!
- 描述
- 卷代表 pod 中可以被 pod 中任何容器访问的命名卷。
- 类型
-
对象
- 必填
-
name
-
属性 | 类型 | 描述 |
---|---|---|
|
| awsElasticBlockStore 代表附加到 kubelet 主机机器的 AWS Disk 资源,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。 |
|
| azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。 |
|
| CephFS 代表共享 pod 生命周期的主机上 Ceph FS 挂载 |
|
| Cinder 代表在 kubelet 主机上附加并挂载的 cinder 卷。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| ConfigMap 代表应该填充这个卷的 configMap |
|
| CSI (容器存储接口)代表由外部 CSI 驱动程序(Alpha 功能)处理的存储。 |
|
| downwardAPI 代表有关应该填充此卷的 pod 的 Downward API |
|
| emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。 |
|
| FlexVolume 代表一个通用卷资源,它使用基于 exec 的插件置备/附加。 |
|
| flocker 代表附加到 kubelet 主机的 Flocker 卷。这取决于 Flocker 控制服务正在运行 |
|
| gcePersistentDisk 代表一个 GCE Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| gitRepo 代表特定修订版本上的 git 存储库。DEPRECATED: GitRepo 已被弃用。要使用 git 仓库置备容器,请将 EmptyDir 挂载到 InitContainer 中,以使用 git 克隆存储库,然后将 EmptyDir 挂载到 Pod 的容器中。 |
|
| GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md |
|
| hostpath 代表主机上直接公开给容器的机器上已存在的文件或目录。这通常用于系统代理或允许查看主机的其他特权操作。大多数容器都不需要此操作。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath ---ö(jonesdl)需要限制谁可以使用主机目录挂载,以及谁可以以读/写形式挂载主机目录。 |
|
| ISCSI 代表附加到 kubelet 主机机器的 ISCSI 磁盘资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md |
|
| 卷的名称。必须是 pod 中的 DNS_LABEL 和 unique。更多信息: 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 |
|
| PhotnPersistentDisk 代表附加并挂载到 kubelet 主机上的 PhotonController 持久磁盘 |
|
| portworxVolume 代表附加并挂载到 kubelet 主机上的 portworx 卷 |
|
| 在一个资源 secret、configmaps 和 Downward API 中所有的项目 |
|
| quobyte 代表共享 pod 生命周期的主机上的 Quobyte 挂载 |
|
| rbd 代表共享 pod 生命周期的主机上 Rados 块设备挂载。更多信息: https://examples.k8s.io/volumes/rbd/README.md |
|
| scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。 |
|
| Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret |
|
| Storageos 代表在 Kubernetes 节点上附加并挂载的 StorageOS 卷。 |
|
| vsphereVolume 代表附加并挂载到 kubelet 主机上的 vSphere 卷 |
14.2.1.191. .spec.volumes[].awsElasticBlockStore 复制链接链接已复制到粘贴板!
- 描述
- awsElasticBlockStore 代表附加到 kubelet 主机机器的 AWS Disk 资源,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
- 类型
-
对象
- 必填
-
volumeID
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore 114: 如何阻止文件系统中的错误破坏机器 |
|
| 要挂载的卷中的分区。如果省略,则默认由卷名称挂载。示例:对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷快照是"0" (或者您可以将属性留空)。 |
|
| 指定 "true" 来强制并将 VolumeMounts 中的 ReadOnly 属性设置为 "true"。如果省略,则默认为 "false"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| AWS (Amazon EBS 卷)中持久磁盘资源的唯一 ID。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
14.2.1.192. .spec.volumes[].azureDisk 复制链接链接已复制到粘贴板!
- 描述
- azureDisk 代表主机上的 Azure Data Disk 挂载,并绑定到 pod。
- 类型
-
对象
- 必填
-
diskName
-
diskURI
-
属性 | 类型 | 描述 |
---|---|---|
|
| 主机缓存模式:无、只读、读写。 |
|
| blob 存储中的数据磁盘的名称 |
|
| blob 存储中的数据磁盘的 URI |
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。 |
|
| 预期值 Shared: 每个存储帐户 Dedicated 多个 blob 磁盘:每个存储帐户 Managed: azure managed data disk (仅限受管可用性集中)。默认为 shared |
|
| 默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
14.2.1.193. .spec.volumes[].azureFile 复制链接链接已复制到粘贴板!
- 描述
- azureFile 代表主机上的 Azure File Service 挂载,并绑定到 pod。
- 类型
-
对象
- 必填
-
secretName
-
shareName
-
属性 | 类型 | 描述 |
---|---|---|
|
| 默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| 包含 Azure 存储帐户名称和密钥的 secret 名称 |
|
| 共享名称 |
14.2.1.194. .spec.volumes[].cephfs 复制链接链接已复制到粘贴板!
- 描述
- CephFS 代表共享 pod 生命周期的主机上 Ceph FS 挂载
- 类型
-
对象
- 必填
-
monitor
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需: monitor 是 Ceph 监视器更多信息的集合: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| 可选:用作挂载的 root,而不是完整的 Ceph 树,默认为 / |
|
| 可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| 可选: SecretFile 是用户密钥环的路径,默认为 /etc/ceph/user.secret more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| 可选: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| 可选: User 是 rados 用户名,默认为 admin more info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
14.2.1.195. .spec.volumes[].cephfs.secretRef 复制链接链接已复制到粘贴板!
- 描述
- 可选: SecretRef 对 User 的身份验证 secret 的引用,默认为空。更多信息: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.196. .spec.volumes[].cinder 复制链接链接已复制到粘贴板!
- 描述
- Cinder 代表在 kubelet 主机上附加并挂载的 cinder 卷。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md
- 类型
-
对象
- 必填
-
volumeID
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| 可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| 可选:指向包含用于连接 OpenStack 的参数的 secret 对象。 |
|
| 用于识别 cinder 中卷的卷 ID。更多信息: https://examples.k8s.io/mysql-cinder-pd/README.md |
14.2.1.197. .spec.volumes[].cinder.secretRef 复制链接链接已复制到粘贴板!
- 描述
- 可选:指向包含用于连接 OpenStack 的参数的 secret 对象。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.198. .spec.volumes[].configMap 复制链接链接已复制到粘贴板!
- 描述
- ConfigMap 代表应该填充这个卷的 configMap
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:默认在创建的文件中使用模式位。必须是 0 到 0777 之间的值。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。 |
|
| 将字符串键映射到卷内的路径。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap 还是其密钥 |
14.2.1.199. .spec.volumes[].configMap.items 复制链接链接已复制到粘贴板!
- 描述
- 如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
- 类型
-
array
14.2.1.200. .spec.volumes[].configMap.items[] 复制链接链接已复制到粘贴板!
- 描述
- 将字符串键映射到卷内的路径。
- 类型
-
对象
- 必填
-
key
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 项目的密钥。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。 |
14.2.1.201. .spec.volumes[].csi 复制链接链接已复制到粘贴板!
- 描述
- CSI (容器存储接口)代表由外部 CSI 驱动程序(Alpha 功能)处理的存储。
- 类型
-
对象
- 必填
-
driver
-
属性 | 类型 | 描述 |
---|---|---|
|
| driver 是处理这个卷的 CSI 驱动程序的名称。请咨询您的管理员以获取在集群中注册的正确名称。 |
|
| 要挂载的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果没有提供,空值会被传递给相关的 CSI 驱动程序,该驱动程序将决定要应用的默认文件系统。 |
|
| NodePublishSecretRef 是对包含敏感信息的 secret 对象的引用,用于传递给 CSI 驱动程序来完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果没有 secret,则可能为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。 |
|
| 为卷指定只读配置。默认为 false (读/写)。 |
|
| volumeAttributes 存储传递给 CSI 驱动程序的特定于驱动程序的属性。如需支持的值,请参考您的驱动程序文档。 |
14.2.1.202. .spec.volumes[].csi.nodePublishSecretRef 复制链接链接已复制到粘贴板!
- 描述
- NodePublishSecretRef 是对包含敏感信息的 secret 对象的引用,用于传递给 CSI 驱动程序来完成 CSI NodePublishVolume 和 NodeUnpublishVolume 调用。此字段是可选的,如果没有 secret,则可能为空。如果 secret 对象包含多个 secret,则会传递所有 secret 引用。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.203. .spec.volumes[].downwardAPI 复制链接链接已复制到粘贴板!
- 描述
- downwardAPI 代表有关应该填充此卷的 pod 的 Downward API
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:默认在创建的文件中使用模式位。必须是 0 到 0777 之间的值。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| items 是 Downward API 卷文件列表 |
|
| DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息 |
14.2.1.204. .spec.volumes[].downwardAPI.items 复制链接链接已复制到粘贴板!
- 描述
- items 是 Downward API 卷文件列表
- 类型
-
array
14.2.1.205. .spec.volumes[].downwardAPI.items[] 复制链接链接已复制到粘贴板!
- 描述
- DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
- 类型
-
对象
- 必填
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 必需:path 是要创建的文件的相对路径名称。不得是绝对的,或包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不得以 '.' 开头 |
|
| 选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。 |
14.2.1.206. .spec.volumes[].downwardAPI.items[].fieldRef 复制链接链接已复制到粘贴板!
- 描述
- 必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。
- 类型
-
对象
- 必填
-
fieldPath
-
属性 | 类型 | 描述 |
---|---|---|
|
| FieldPath 编写的模式版本,默认为 "v1"。 |
|
| 要在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。
- 类型
-
对象
- 必填
-
resource
-
属性 | 类型 | 描述 |
---|---|---|
|
| 容器名称:卷需要,对于 env vars 是可选的 |
|
| 指定公开资源的输出格式,默认为 "1" |
|
| 必需:要选择的资源 |
14.2.1.208. .spec.volumes[].emptyDir 复制链接链接已复制到粘贴板!
- 描述
- emptyDir 代表共享 pod 生命周期的临时目录。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 哪个类型的存储介质应该支持此目录。默认值为 "",这意味着使用节点的默认介质。必须是空字符串(默认)或内存。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
|
| 此 EmptyDir 卷所需的本地存储总量。大小限制也适用于内存介质。内存介质 EmptyDir 的最大使用量是此处指定的 SizeLimit 和 pod 中所有容器的总和之间的最小值。默认值为 nil,这意味着限制未定义。更多信息: http://kubernetes.io/docs/user-guide/volumes#emptydir |
14.2.1.209. .spec.volumes[].fc 复制链接链接已复制到粘贴板!
- 描述
- FC 代表附加到 kubelet 主机机器的光纤通道资源,然后公开给 pod。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。ado: 如何防止文件系统中的错误破坏机器 |
|
| 可选: FC 目标 lun 号 |
|
| 可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| 可选: FC 目标全球名称(WWN) |
|
| 可选: FC 卷全局识别符(wwids) Either wwids 或 targetWWN 和 lun 的组合都必须被设置,但不能同时设置。 |
14.2.1.210. .spec.volumes[].flexVolume 复制链接链接已复制到粘贴板!
- 描述
- FlexVolume 代表一个通用卷资源,它使用基于 exec 的插件置备/附加。
- 类型
-
对象
- 必填
-
driver
-
属性 | 类型 | 描述 |
---|---|---|
|
| driver 是此卷要使用的驱动程序名称。 |
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认文件系统依赖于 FlexVolume 脚本。 |
|
| 可选:额外的命令选项(若有)。 |
|
| 可选:默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| 可选: SecretRef 引用包含要传递给插件脚本的敏感信息的 secret 对象。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。 |
14.2.1.211. .spec.volumes[].flexVolume.secretRef 复制链接链接已复制到粘贴板!
- 描述
- 可选: SecretRef 引用包含要传递给插件脚本的敏感信息的 secret 对象。如果没有指定 secret 对象,这可能为空。如果 secret 对象包含多个 secret,则所有 secret 都会传递给插件脚本。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.212. .spec.volumes[].flocker 复制链接链接已复制到粘贴板!
- 描述
- flocker 代表附加到 kubelet 主机的 Flocker 卷。这取决于 Flocker 控制服务正在运行
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
在 Flocker 的 dataset 上作为 metadata |
|
| dataset 的 UUID。这是 Flocker 数据集的唯一标识符 |
14.2.1.213. .spec.volumes[].gcePersistentDisk 复制链接链接已复制到粘贴板!
- 描述
- gcePersistentDisk 代表一个 GCE Disk 资源,附加到 kubelet 的主机机器,然后公开给 pod。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- 类型
-
对象
- 必填
-
pdName
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk 114: 如何阻止文件系统中的错误破坏机器 |
|
| 要挂载的卷中的分区。如果省略,则默认由卷名称挂载。示例:对于卷 /dev/sda1,您可以将分区指定为 "1"。同样,/dev/sda 的卷快照是"0" (或者您可以将属性留空)。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| GCE 中 PD 资源的唯一名称。用于识别 GCE 中的磁盘。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| 此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
14.2.1.214. .spec.volumes[].gitRepo 复制链接链接已复制到粘贴板!
- 描述
- gitRepo 代表特定修订版本上的 git 存储库。DEPRECATED: GitRepo 已被弃用。要使用 git 仓库置备容器,请将 EmptyDir 挂载到 InitContainer 中,以使用 git 克隆存储库,然后将 EmptyDir 挂载到 Pod 的容器中。
- 类型
-
对象
- 必填
-
软件仓库
-
属性 | 类型 | 描述 |
---|---|---|
|
| 目标目录名称。不得包含或以 '.' 开头。如果提供了 '.',则卷目录将是 git 存储库。否则,卷将在具有指定名称的子目录中包含 git 存储库。 |
|
| 仓库 URL |
|
| 指定修订版本的提交哈希。 |
14.2.1.215. .spec.volumes[].glusterfs 复制链接链接已复制到粘贴板!
- 描述
- GlusterFS 代表共享 pod 生命周期的主机上的 Glusterfs 挂载。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md
- 类型
-
对象
- 必填
-
端点
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| endpointName 是详细说明 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 |
|
| 此处的只读将强制使用只读权限挂载 Glusterfs 卷。默认为false。更多信息: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
14.2.1.216. .spec.volumes[].hostPath 复制链接链接已复制到粘贴板!
- 描述
- hostpath 代表主机上直接公开给容器的机器上已存在的文件或目录。这通常用于系统代理或允许查看主机的其他特权操作。大多数容器都不需要此操作。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath ---ö(jonesdl)需要限制谁可以使用主机目录挂载,以及谁可以以读/写形式挂载主机目录。
- 类型
-
对象
- 必填
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 主机上目录的路径。如果路径是符号链接,它将遵循到实际路径的链接。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| HostPath Volume Defaults 为 "" more information: https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
14.2.1.217. .spec.volumes[].iscsi 复制链接链接已复制到粘贴板!
- 描述
- ISCSI 代表附加到 kubelet 主机机器的 ISCSI 磁盘资源,然后公开给 pod。更多信息: https://examples.k8s.io/volumes/iscsi/README.md
- 类型
-
对象
- 必填
-
iqn
-
lun
-
targetPortal
-
属性 | 类型 | 描述 |
---|---|---|
|
| 是否支持 iSCSI 发现 CHAP 身份验证 |
|
| 是否支持 iSCSI 会话 CHAP 身份验证 |
|
| 要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#iscsi 114: 如何阻止文件系统中的错误破坏机器 |
|
| 自定义 iSCSI 启动器名称。如果同时使用 iscsiInterface 指定 initiatorName,则会为连接创建新的 iSCSI 接口 <target portal>:<volume name>。 |
|
| 目标 iSCSI 限定名称。 |
|
| 使用 iSCSI 传输的 iSCSI 接口名称。默认为 'default'(tcp)。 |
|
| iSCSI 目标 Lun 号。 |
|
| iSCSI 目标门户列表.如果端口不是默认端口(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。 |
|
| 此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。默认为false。 |
|
| 用于 iSCSI 目标和发起方身份验证的 CHAP Secret |
|
| iSCSI 目标门户.如果端口不是默认端口(通常为 TCP 端口 860 和 3260),则门户是 IP 或 ip_addr:port。 |
14.2.1.218. .spec.volumes[].iscsi.secretRef 复制链接链接已复制到粘贴板!
- 描述
- 用于 iSCSI 目标和发起方身份验证的 CHAP Secret
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.219. .spec.volumes[].nfs 复制链接链接已复制到粘贴板!
- 描述
- NFS 代表共享 pod 生命周期的主机上的 NFS 挂载: https://kubernetes.io/docs/concepts/storage/volumes#nfs
- 类型
-
对象
- 必填
-
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 |
14.2.1.220. .spec.volumes[].persistentVolumeClaim 复制链接链接已复制到粘贴板!
- 描述
- PersistentVolumeClaimVolumeSource 代表对同一命名空间中的 PersistentVolumeClaim 的引用。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
- 类型
-
对象
- 必填
-
claimName
-
属性 | 类型 | 描述 |
---|---|---|
|
| claimName 是与使用此卷的 pod 相同的命名空间中的 PersistentVolumeClaim 的名称。更多信息: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| 将强制 VolumeMount 中的 ReadOnly 设置。默认 false。 |
14.2.1.221. .spec.volumes[].photonPersistentDisk 复制链接链接已复制到粘贴板!
- 描述
- PhotnPersistentDisk 代表附加并挂载到 kubelet 主机上的 PhotonController 持久磁盘
- 类型
-
对象
- 必填
-
pdID
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。 |
|
| 标识 Photon Controller 持久磁盘的 ID |
14.2.1.222. .spec.volumes[].portworxVolume 复制链接链接已复制到粘贴板!
- 描述
- portworxVolume 代表附加并挂载到 kubelet 主机上的 portworx 卷
- 类型
-
对象
- 必填
-
volumeID
-
属性 | 类型 | 描述 |
---|---|---|
|
| fstype 代表要挂载 Must 的文件系统类型,是主机操作系统支持的文件系统类型。EX. "ext4", "xfs"。如果未指定,则隐式推断为"ext4"。 |
|
| 默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| VolumeId 唯一标识 Portworx 卷 |
14.2.1.223. .spec.volumes[].projected 复制链接链接已复制到粘贴板!
- 描述
- 在一个资源 secret、configmaps 和 Downward API 中所有的项目
- 类型
-
对象
- 必填
-
sources
-
属性 | 类型 | 描述 |
---|---|---|
|
| 默认用于创建文件的模式位。必须是 0 到 0777 之间的值。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 卷投射列表 |
|
| 可以投射与其他支持的卷类型进行投射 |
14.2.1.224. .spec.volumes[].projected.sources 复制链接链接已复制到粘贴板!
- 描述
- 卷投射列表
- 类型
-
array
14.2.1.225. .spec.volumes[].projected.sources[] 复制链接链接已复制到粘贴板!
- 描述
- 可以投射与其他支持的卷类型进行投射
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 有关项目的 configMap 数据的信息 |
|
| 有关项目 downwardAPI 数据的信息 |
|
| 有关项目 secret 数据的信息 |
|
| 有关项目的 serviceAccountToken 数据的信息 |
- 描述
- 有关项目的 configMap 数据的信息
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。 |
|
| 将字符串键映射到卷内的路径。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 ConfigMap 还是其密钥 |
- 描述
- 如果未指定,引用的 ConfigMap 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了 ConfigMap 中不存在的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
- 类型
-
array
- 描述
- 将字符串键映射到卷内的路径。
- 类型
-
对象
- 必填
-
key
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 项目的密钥。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。 |
- 描述
- 有关项目 downwardAPI 数据的信息
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| items 是 DownwardAPIVolume 文件的列表 |
|
| DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息 |
- 描述
- items 是 DownwardAPIVolume 文件的列表
- 类型
-
array
- 描述
- DownwardAPIVolumeFile 代表创建包含 pod 字段的文件的信息
- 类型
-
对象
- 必填
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 必需:path 是要创建的文件的相对路径名称。不得是绝对的,或包含 '..' 路径。必须经过 utf-8 编码。相对路径的第一个项不得以 '.' 开头 |
|
| 选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。 |
- 描述
- 必需: 选择 pod 的字段:只支持注解、标签、名称和命名空间。
- 类型
-
对象
- 必填
-
fieldPath
-
属性 | 类型 | 描述 |
---|---|---|
|
| FieldPath 编写的模式版本,默认为 "v1"。 |
|
| 要在指定 API 版本中选择的字段路径。 |
- 描述
- 选择容器的资源:当前仅支持资源限制和请求(limits.cpu、limit.memory、request.cpu 和 requests.memory)。
- 类型
-
对象
- 必填
-
resource
-
属性 | 类型 | 描述 |
---|---|---|
|
| 容器名称:卷需要,对于 env vars 是可选的 |
|
| 指定公开资源的输出格式,默认为 "1" |
|
| 必需:要选择的资源 |
14.2.1.234. .spec.volumes[].projected.sources[].secret 复制链接链接已复制到粘贴板!
- 描述
- 有关项目 secret 数据的信息
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。 |
|
| 将字符串键映射到卷内的路径。 |
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
|
| 指定是否必须定义 Secret 还是其密钥 |
- 描述
- 如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
- 类型
-
array
- 描述
- 将字符串键映射到卷内的路径。
- 类型
-
对象
- 必填
-
key
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 项目的密钥。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。 |
- 描述
- 有关项目的 serviceAccountToken 数据的信息
- 类型
-
对象
- 必填
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| Audience 是令牌的预期使用者。令牌的接收者必须使用令牌使用者中指定的标识符来识别自己,否则应拒绝令牌。使用者默认为 apiserver 的标识符。 |
|
| ExpirationSeconds 是服务帐户令牌的有效持续时间。当令牌方法过期时,kubelet 卷插件会主动轮转服务帐户令牌。如果令牌存在的时间超过这个值的 80%,或者超过 24 小时,则 kubelet 将开始尝试轮转令牌,且必须至少 10 分钟。 |
|
| path 是相对于文件挂载点的路径,用于将令牌项目到其中。 |
14.2.1.238. .spec.volumes[].quobyte 复制链接链接已复制到粘贴板!
- 描述
- quobyte 代表共享 pod 生命周期的主机上的 Quobyte 挂载
- 类型
-
对象
- 必填
-
registry
-
卷
-
属性 | 类型 | 描述 |
---|---|---|
|
| 将卷访问映射到 Default 的组 |
|
| 此处的只读将强制使用只读权限挂载 Quobyte 卷。默认为false。 |
|
| registry 代表单个或多个 Quobyte Registry 服务,指定为 host:port 对(多个条目用逗号分开),它充当卷的中央 registry |
|
| 在带有动态置备的 Quobyte 卷的后端中拥有给定 Quobyte 卷的租户,值由插件设置 |
|
| 将卷访问权限映射到 Defaults 到 serivceaccount 用户 |
|
| 卷是一个字符串,它按名称引用已创建 Quobyte 卷。 |
14.2.1.239. .spec.volumes[].rbd 复制链接链接已复制到粘贴板!
- 描述
- rbd 代表共享 pod 生命周期的主机上 Rados 块设备挂载。更多信息: https://examples.k8s.io/volumes/rbd/README.md
- 类型
-
对象
- 必填
-
image
-
monitor
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的卷的文件系统类型。提示: 确保主机操作系统支持文件系统类型。示例:"ext4", "xfs", "ntfs"。如果未指定,则隐式推断为"ext4"。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#rbd 114: 如何阻止文件系统中的错误破坏机器 |
|
| 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 |
|
| Ceph 监视器的集合。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 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 |
|
| rados 用户名。默认为 admin。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
14.2.1.240. .spec.volumes[].rbd.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 是 RBDUser 的身份验证 secret 的名称。如果提供覆盖密钥环,则提供。默认为 nil。更多信息: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.241. .spec.volumes[].scaleIO 复制链接链接已复制到粘贴板!
- 描述
- scaleIO 代表附加并挂载到 Kubernetes 节点上的 ScaleIO 持久性卷。
- 类型
-
对象
- 必填
-
gateway
-
secretRef
-
system
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".默认为 "xfs"。 |
|
| ScaleIO API 网关的主机地址。 |
|
| 配置存储的 ScaleIO 保护域的名称。 |
|
| 默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| secretRef 引用 ScaleIO 用户和其他敏感信息的机密。如果没有提供此功能,则登录操作将失败。 |
|
| 启用/禁用与网关的 SSL 通信的标志,默认为 false |
|
| 指明卷的存储是否应是 ThickProvisioned 或 ThinProvisioned。默认为 ThinProvisioned。 |
|
| 与保护域关联的 ScaleIO 存储池。 |
|
| 存储系统的名称,如 ScaleIO 中配置的。 |
|
| 已在与这个卷源关联的 ScaleIO 系统中创建的卷名称。 |
14.2.1.242. .spec.volumes[].scaleIO.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 引用 ScaleIO 用户和其他敏感信息的机密。如果没有提供此功能,则登录操作将失败。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.243. .spec.volumes[].secret 复制链接链接已复制到粘贴板!
- 描述
- Secret 代表应填充此卷的 secret。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 可选:默认在创建的文件中使用模式位。必须是 0 到 0777 之间的值。默认值为 0644。路径中的目录不受此设置的影响。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。 |
|
| 将字符串键映射到卷内的路径。 |
|
| 指定是否必须定义 Secret 还是其密钥 |
|
| 要使用的 pod 命名空间中的 secret 名称。更多信息: https://kubernetes.io/docs/concepts/storage/volumes#secret |
14.2.1.244. .spec.volumes[].secret.items 复制链接链接已复制到粘贴板!
- 描述
- 如果未指定,引用的 Secret 的 Data 字段中的每个键值对都将作为键为键的文件投射到卷中,内容是值。如果指定,列出的密钥将投射到指定路径中,并且不存在未列出的密钥。如果指定了没有存在于 Secret 中的键,则卷设置将出错,除非它被标记为可选。路径必须相对,且可能不包含 '..' 路径,或者以 '..' 开头。
- 类型
-
array
14.2.1.245. .spec.volumes[].secret.items[] 复制链接链接已复制到粘贴板!
- 描述
- 将字符串键映射到卷内的路径。
- 类型
-
对象
- 必填
-
key
-
path
-
属性 | 类型 | 描述 |
---|---|---|
|
| 项目的密钥。 |
|
| 可选: 在此文件中要使用的模式位,必须是 0 到 0777 之间的值。如果没有指定,则使用卷 defaultMode。这可能会与影响文件模式的其他选项冲突,如 fsGroup,结果可以是其他模式位集。 |
|
| 要将密钥映射到的文件的相对路径。可能不是绝对路径。可能不包含 path 元素 '..'。可能无法以字符串 '..' 开头。 |
14.2.1.246. .spec.volumes[].storageos 复制链接链接已复制到粘贴板!
- 描述
- Storageos 代表在 Kubernetes 节点上附加并挂载的 StorageOS 卷。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。 |
|
| 默认为 false (读/写)。此处的 ReadOnly 将强制 VolumeMount 中的 ReadOnly 设置。 |
|
| secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。 |
|
| volumeName 是 StorageOS 卷的人类可读名称。卷名称只在命名空间中唯一。 |
|
| VolumeNamespace 指定 StorageOS 中的卷范围。如果没有指定命名空间,则使用 Pod 的命名空间。这允许 Kubernetes 名称范围在 StorageOS 中进行镜像,以便更好地集成。将 VolumeName 设置为任何名称来覆盖默认行为。如果没有在 StorageOS 中使用命名空间,则设置为 "default"。将创建没有在 StorageOS 中预先存在的命名空间。 |
14.2.1.247. .spec.volumes[].storageos.secretRef 复制链接链接已复制到粘贴板!
- 描述
- secretRef 指定用于获取 StorageOS API 凭证的 secret。如果没有指定,则会尝试默认值。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 引用的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names,添加其他有用的字段。api、kind、uid? |
14.2.1.248. .spec.volumes[].vsphereVolume 复制链接链接已复制到粘贴板!
- 描述
- vsphereVolume 代表附加并挂载到 kubelet 主机上的 vSphere 卷
- 类型
-
对象
- 必填
-
volumePath
-
属性 | 类型 | 描述 |
---|---|---|
|
| 要挂载的文件系统类型。必须是主机操作系统支持的文件系统类型。Ex. "ext4", "xfs", "ntfs".如果未指定,则隐式推断为"ext4"。 |
|
| 与 StoragePolicyName 关联的基于存储策略的管理(SPBM)配置集 ID。 |
|
| 基于存储策略的管理(SPBM)配置集名称。 |
|
| 标识 vSphere 卷 vmdk 的路径 |
14.2.1.249. .status 复制链接链接已复制到粘贴板!
- 描述
- Alertmanager 集群最近观察到的状态。只读。从 apiserver 请求时不包括,仅来自 Prometheus Operator API 本身。更多信息: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 类型
-
对象
- 必填
-
availableReplicas
-
paused
-
replicas
-
unavailableReplicas
-
updatedReplicas
-
属性 | 类型 | 描述 |
---|---|---|
|
| 此 Alertmanager 集群的目标可用 pod 的总数(至少为 minReadySeconds)。 |
|
| 代表是否在底层受管对象上执行任何操作。仅执行 delete 操作。 |
|
| 此 Alertmanager 集群的目标非终端 pod 的总数(标签与选择器匹配)。 |
|
| 此 Alertmanager 集群的目标不可用 pod 总数。 |
|
| 此 Alertmanager 集群具有所需版本 spec 的非终端 pod 总数。 |
14.2.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/monitoring.coreos.com/v1/alertmanagers
-
GET
: 列出 Alertmanager 类型的对象
-
/apis/monitoring.coreos.com/v1/namespaces/{namespace}/alertmanagers
-
DELETE
:删除 Alertmanager 的集合 -
GET
: 列出 Alertmanager 类型的对象 -
POST
:创建 Alertmanager
-
/apis/monitoring.coreos.com/v1/namespaces/{namespace}/alertmanagers/{name}
-
DELETE
:删除 Alertmanager -
GET
:读取指定的 Alertmanager -
PATCH
:部分更新指定的 Alertmanager -
PUT
:替换指定的 Alertmanager
-
14.2.2.1. /apis/monitoring.coreos.com/v1/alertmanagers 复制链接链接已复制到粘贴板!
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 如果 'true',则输出被用户友善。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET
- 描述
- 列出 Alertmanager 类型的对象
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| 对象名称和身份验证范围,如团队和项目 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除 Alertmanager 集合
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
GET
- 描述
- 列出 Alertmanager 类型的对象
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
POST
- 描述
- 创建 Alertmanager
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| Alertmanager 的名称 |
|
| 对象名称和身份验证范围,如团队和项目 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除 Alertmanager
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| 应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。 |
|
| 弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。 |
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
GET
- 描述
- 读取指定的 Alertmanager
参数 | 类型 | 描述 |
---|---|---|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH
- 描述
- 部分更新指定的 Alertmanager
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
PUT
- 描述
- 替换指定的 Alertmanager
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | 空 |