第 8 章 Prometheus [monitoring.coreos.com/v1]

additionalAlertManagerConfigs

object

additionalAlertmanagerConfigs 指定包含额外 Prometheus Alertmanager 配置的 Secret 的密钥。Alertmanager 配置附加到 Prometheus Operator 生成的配置中。它们必须根据官方 Prometheus 文档进行格式化：https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config 用户负责确保配置有效注意，使用此功能可能会破坏 Prometheus 的升级。https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config建议查看 Prometheus 发行注记，以确保升级后没有不兼容的 AlertManager 配置会破坏 Prometheus。

additionalAlertRelabelConfigs

object

additionalAlertRelabelConfigs 指定包含额外 Prometheus 警报重新标记配置的 Secret 的键。警报重新标记配置附加到 Prometheus Operator 生成的配置中。它们必须根据官方 Prometheus 文档进行格式化：https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs 用户负责确保配置有效注意，使用此功能可能会破坏 Prometheus 的升级。https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alert_relabel_configs建议查看 Prometheus 发行注记，以确保升级后没有不兼容的警报重新标记配置中断 Prometheus。

additionalArgs

数组

AdditionalArgs 允许为 'prometheus' 容器设置额外的参数。它旨在激活被专用配置选项不支持的隐藏标志。参数按原样传递给 Prometheus 容器，如果给定 Prometheus 版本无效或不支持它们，则可能会导致问题。如果参数冲突（例如，已由 Operator 本身设置的参数）或在提供无效参数时，协调将失败，并会记录错误。

additionalArgs[]

object

参数作为 AdditionalArgs 列表的一部分。

additionalScrapeConfigs

对象

additionalScrapeConfigs 允许指定包含额外 Prometheus scrape 配置的 Secret 的密钥。指定的提取配置附加到 Prometheus Operator 生成的配置中。指定的作业配置必须具有官方 Prometheus 文档中指定的表单： https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config。附加提取配置后，用户负责确保它有效。请注意，使用此功能可能会公开可能会破坏 Prometheus 的升级。建议查看 Prometheus 发行注记，以确保升级后没有不兼容的提取配置中断 Prometheus。

关联性

object

如果指定，定义 Pod 的关联性调度规则。

警报

object

定义与 Alertmanager 相关的设置。

allowOverlappingBlocks

布尔值

AllowOverlappingBlocks 在 Prometheus 中启用垂直压缩和垂直查询合并。弃用：此标志对 Prometheus >= 2.39.0 没有作用，其中默认启用重叠块。

apiserverConfig

object

apiserverConfig 允许指定主机和 auth 方法来访问 Kuberntees API 服务器。如果为 null，Prometheus 被认为在集群内运行：它将自动发现 API 服务器，并在 /var/run/secrets/kubernetes.io/serviceaccount/ 中使用 Pod 的 CA 证书和 bearer 令牌文件。

arbitraryFSAccessThroughSMs

object

为 true、ServiceMonitor、PodMonitor 和 Probe 对象被禁止引用"prometheus"容器文件系统上的任意文件。当 ServiceMonitor 的端点指定了 bearerTokenFile 值（如 '/var/run/secrets/kubernetes.io/serviceaccount/token'），恶意目标可以在 Prometheus' scrape 请求中获取 Prometheus 服务帐户的令牌的访问权限。将 spec.arbitraryFSAccessThroughSM 设置为 'true' 可防止攻击。用户应该使用 spec.bearerTokenSecret 字段提供凭证。

baseImage

string

deprecated: 使用 'spec.image' 替代。

bodySizeLimit

string

BodySizeLimit 对响应正文大小定义 per-scrape。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

configMaps

数组（字符串）

ConfigMap 是与 Prometheus 对象相同的命名空间中的 ConfigMap 列表，它应该被挂载到 Prometheus Pod 中。每个 ConfigMap 都作为名为 configmap-<configmap-name> 的卷添加到 StatefulSet 定义中。ConfigMap 被挂载到 'prometheus' 容器中的 /etc/prometheus/configmaps/<configmap-name> 中。

containers

array

容器允许注入其他容器或修改操作器生成的容器。这可用于允许向 Pod 添加身份验证代理或更改 Operator 生成的容器的行为。这里描述的容器如果操作器共享相同的名称和修改，则修改通过战略合并补丁来完成。由 Operator 管理的容器的名称是：* prometheus * config-reloader * thanos-sidecar Overriding 容器完全超出维护者将支持什么范围，您可以接受这个行为，而无需通知。

containers[]

对象

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

disableCompaction

布尔值

为 true 时，Prometheus 压缩会被禁用。

enableAdminAPI

布尔值

启用对 Prometheus web admin API 的访问。警告：启用管理 API 可启用变异端点，以删除数据、关闭 Prometheus 等。应谨慎启用此功能，并且建议用户通过代理添加额外的身份验证授权，以确保只有授权执行这些操作的客户端可以这样做。更多信息： https://prometheus.io/docs/prometheus/latest/querying/api/#tsdb-admin-apis

enableFeatures

数组（字符串）

启用对 Prometheus 功能标记的访问。默认情况下，不启用任何功能。启用默认情况下禁用的功能完全超出了维护人员将支持什么范围，通过这样做，您接受的行为可能随时中断，而无需通知。更多信息请参阅 https://prometheus.io/docs/prometheus/latest/feature_flags/

enableRemoteWriteReceiver

布尔值

启用 Prometheus 作为 Prometheus 远程写入协议的接收器。警告：这不被视为嵌套示例的有效方法。对于特定的低卷用例，请谨慎使用。它不适用于通过提取替换 ingestion，并将 Prometheus 转换成基于推送的指标集合系统。如需更多信息，请参阅 https://prometheus.io/docs/prometheus/latest/querying/api/#remote-write-receiver 它需要 Prometheus >= v2.33.0。

enforcedBodySizeLimit

string

定义后，EnforceBodySizeLimit 指定 Prometheus 接受的未压缩响应正文大小的全局限制。使用大于这个字节的正文响应的目标会导致提取失败。它需要 Prometheus >= v2.28.0。

enforcedLabelLimit

整数

定义后，enforcedLabelLimit 为所有示例的标签数指定一个全局限制。该值覆盖由 ServiceMonitor, PodMonitor, Probe 对象设置的任何 spec.labelLimit，除非 spec.labelLimit 大于零，且小于 spec.enforcedLabelLimit。它需要 Prometheus >= v2.27.0。

enforcedLabelNameLengthLimit

整数

定义后，EnforceLabelNameLengthLimit 指定每个示例标签名称长度的全局限制。该值覆盖由 ServiceMonitor, PodMonitor, Probe 对象设置的 spec.labelNameLengthLimit，除非 spec.labelNameLengthLimit 大于零，且小于 spec.enforcedLabelNameLengthLimit。它需要 Prometheus >= v2.27.0。

enforcedLabelValueLengthLimit

整数

如果没有 null，则 enforcedLabelValueLengthLimit 会为每个示例定义标签值长度的全局限制。该值覆盖由 ServiceMonitor, PodMonitor, Probe 对象设置的 spec.labelValueLengthLimit，除非 spec.labelValueLengthLimit 大于零，且小于 spec.enforcedLabelValueLengthLimit。它需要 Prometheus >= v2.27.0。

enforcedNamespaceLabel

string

如果没有为空，则会将标签添加到 1。所有从 ServiceMonitor、PodMonitor ing、Probe 和 ScrapeConfig 对象中提取的指标。2.所有从 PrometheusRule 对象中定义的记录规则生成的指标。3.从 PrometheusRule 对象中定义的警报规则生成的所有警报。4.PrometheusRule 对象中定义的 PromQL 表达式的所有向量选择器。该标签不会为 spec.excludedFromEnforcement 中引用的对象添加。标签的名称是此字段的值。标签的值是 ServiceMonitor、PodPod、Probe 或 PrometheusRule 对象的命名空间。

enforcedSampleLimit

整数

定义后，EnforcedSampleLimit 指定提取示例数量的全局限制。这会覆盖由 ServiceMonitor, PodMonitorLimit 设置的任何 spec.sampleLimit，除非 spec.sampleLimit 大于零，且小于 spec.enforcedSampleLimit。管理员用来保持在所需限制下的样本/系列总数。

enforcedTargetLimit

整数

定义后，EnforcedTargetLimit 指定提取目标数量的全局限制。该值覆盖由 ServiceMonitor, PodMonitor, Probe 对象设置的任何 spec.targetLimit，除非 spec.targetLimit 大于零，且小于 spec.enforcedTargetLimit。管理员用来使目标总数保持在所需限制下。

evaluationInterval

string

规则评估之间的间隔。默认："30s"

excludedFromEnforcement

数组

对 PodMonitor、ServiceMonitor、Probe 和 PrometheusRule 对象的引用列表，以便从强制空间标签 origin 中排除。只有在 spec.enforcedNamespaceLabel 设置为 true 时才适用。

excludedFromEnforcement[]

object

ObjectReference 引用 PodMonitor、ServiceMonitor、Probe 或 PrometheusRule 对象。

exemplars

object

Exemplars 相关设置可重新加载。它需要启用 exemplar-storage 功能标记才能生效。

externalLabels

对象（字符串）

与外部系统通信时要添加到任何时间序列或警报的标签(federation、remote storage、Alertmanager)。spec.replicaExternalLabelName 和 spec.prometheusExternalLabelName 定义的标签优先于这个列表。

externalUrl

string

Prometheus 服务外部可用的外部 URL。这是生成正确 URL 所必需的（例如，如果 Prometheus 可在 Ingress 资源后面访问）。

hostAliases

数组

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

hostAliases[]

对象

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

hostNetwork

布尔值

如果为 true，请使用主机的网络命名空间。如果要启用它，请确保了解安全隐患(https://kubernetes.io/docs/concepts/configuration/overview/)。启用 hostNetwork 时，这将自动将 DNS 策略设置为 ClusterFirstWithHostNet。

ignoreNamespaceSelectors

布尔值

为 true 时，所有 PodMonitor 的 spec.namespaceSelector 会被忽略。它们只会发现 PodMonitor、ServiceMonitor 和 Probe objec 命名空间内的目标。

image

string

Prometheus 的容器镜像名称。如果指定，它优先于 spec.baseImage、spec.tag 和 spec.sha 字段。仍然需要指定 spec.version，以确保 Prometheus Operator 知道正在配置哪个版本的 Prometheus。如果没有定义 spec.image 和 spec.baseImage，则 operator 会在 Operator 发布时使用最新的 Prometheus 上游版本。

imagePullPolicy

string

'prometheus'、'init-config-reloader' 和 'config-reloader' 容器的镜像拉取策略。详情请查看 https://kubernetes.io/docs/concepts/containers/images/#image-pull-policy。

imagePullSecrets

数组

可选引用同一命名空间中的 Secret 列表，用于从 registry 中拉取镜像。See http://kubernetes.io/docs/user-guide/images#specifying-imagepullsecrets-on-a-pod

imagePullSecrets[]

对象

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

initContainers

数组

initContainers 允许将 initContainers 注入 Pod 定义。它们可用于从外部来源获取用于注入 Prometheus 配置的 secret。执行 initContainer 期间的任何错误将导致重启 Pod。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ InitContainers如果操作器共享相同的名称和修改，则修改 Operator 生成的 init 容器（如果它们通过策略合并补丁完成）。由 Operator 管理的 init 容器名称的名称有：* init-config-reloader。覆盖 init 容器完全超出维护人员将支持什么范围，通过这样做，您接受的行为可能随时中断，而无需通知。

initContainers[]

对象

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

labelLimit

整数

对示例接受的标签数的 per-scrape 限制。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

labelNameLengthLimit

整数

对示例接受的标签名称长度的 per-scrape 限制。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

labelValueLengthLimit

整数

对示例接受的标签值长度的 per-scrape 限制。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

listenLocal

布尔值

为 true 时，Prometheus 服务器侦听回环地址，而不是 Pod IP 地址。

logFormat

string

Prometheus 和 config-reloader sidecar 的日志级别的日志格式。

logLevel

string

Prometheus 和 config-reloader sidecar 的日志级别。

minReadySeconds

整数

新创建的 Pod 应该在不出现任何容器崩溃的情况下变为可用状态的最小秒数。默认值为 0 (pod 会在就绪时被视为可用)。这是 kubernetes 1.22 的一个 alpha 字段，直到 1.24 （需要启用 StatefulSetMinReadySeconds 功能门）。

nodeSelector

对象（字符串）

定义 Pod 调度到哪些节点上。

overrideHonorLabels

布尔值

为 true 时，Prometheus 通过将提取数据中的标签重命名为 "exported_<label value>" 来解决标签冲突。否则，会应用服务或 pod 监视器的 HonorLabels 字段。

overrideHonorTimestamps

布尔值

为 true 时，Prometheus 会忽略从服务和 pod 监视器创建的所有目标的时间戳。否则，应用服务或 pod 监视器的 HonorTimestamps 字段。

paused

布尔值

当 Prometheus 部署暂停时，不会对底层对象执行除删除外的操作。

podMetadata

object

podMetadata 配置传播到 Prometheus pod 的标签和注解。

podMonitorNamespaceSelector

object

用于与 PodMonitor 发现匹配的命名空间。空标签选择器与所有命名空间匹配。null 标签选择器仅与当前命名空间匹配。

podMonitorSelector

对象

为目标发现选择 实验性 PodMonitor。空标签选择器匹配所有对象。null 标签选择器不匹配任何对象。如果 spec.serviceMonitorSelector,spec.podMonitorSelector,spec.probeSelector 和 spec.scrapeConfigSelector 为 null，则 Prometheus 配置为非受管。Prometheus operator 将确保 Prometheus 配置的 Secret 存在，但负责用户在 prometheus.yaml.gz 键下提供原始 gzip Prometheus 配置。这个行为 已弃用，并将在自定义资源定义的下一个主版本中删除。建议您使用 spec.additionalScrapeConfigs 替代。

podTargetLabels

数组（字符串）

PodTargetLabels 会附加到所有 PodMonitor 和 ServiceMonitor 对象的 spec.podTargetLabels 字段中。

portName

字符串

用于 pod 和监管服务的端口名称。默认："web"

priorityClassName

string

分配给 Pod 的优先级类。

probeNamespaceSelector

object

用于探测发现的 实验性 命名空间。空标签选择器与所有命名空间匹配。null 标签选择器仅与当前命名空间匹配。

probeSelector

对象

为目标发现选择 实验性 探测。空标签选择器匹配所有对象。null 标签选择器不匹配任何对象。如果 spec.serviceMonitorSelector,spec.podMonitorSelector,spec.probeSelector 和 spec.scrapeConfigSelector 为 null，则 Prometheus 配置为非受管。Prometheus operator 将确保 Prometheus 配置的 Secret 存在，但负责用户在 prometheus.yaml.gz 键下提供原始 gzip Prometheus 配置。这个行为 已弃用，并将在自定义资源定义的下一个主版本中删除。建议您使用 spec.additionalScrapeConfigs 替代。

prometheusExternalLabelName

string

用于表示 Prometheus 实例名称的 Prometheus 外部标签名称。当字段设置为空字符串时，不会添加 external 标签("")。默认："prometheus"

prometheusRulesExcludedFromEnforce

数组

定义命名空间标签强制不应用到的 PrometheusRule 对象列表。这只有在 spec.enforcedNamespaceLabel 设置为 true 时才相关。deprecated: 使用 spec.excludedFromEnforcement 替代。

prometheusRulesExcludedFromEnforce[]

对象

PrometheusRuleExcludeConfig 允许用户配置排除的 PrometheusRule 名称及其命名空间，同时为警报和指标强制执行命名空间标签。

query

object

QuerySpec 定义 Promethus 查询服务的配置。

queryLogFile

string

queryLogFile 指定 PromQL 查询要记录到的文件。如果文件名有空路径，如 'query.log'，Prometheus Pod 会将该文件挂载到位于 /var/log/prometheus 的 emptyDir 卷中。如果提供了完整路径，如 '/var/log/prometheus/query.log'，您必须将卷挂载到指定的目录中，且必须可写。这是因为 prometheus 容器因为安全原因使用只读根文件系统运行。或者，位置可以设置为标准 I/O 流，如 /dev/stdout 将查询信息记录到默认的 Prometheus 日志流。

remoteRead

数组

定义远程读取配置的列表。

remoteRead[]

object

RemoteReadSpec 定义 Prometheus 的配置，以从远程端点读取后端示例。

remoteWrite

数组

定义远程写入配置的列表。

remoteWrite[]

object

RemoteWriteSpec 定义将示例从 Prometheus 写入远程端点的配置。

replicaExternalLabelName

string

用于表示副本名称的 Prometheus 外部标签的名称。当字段设置为空字符串时，不会添加 external 标签("")。默认："prometheus_replica"

replicas

整数

为 Prometheus 部署部署的每个分片的副本数。spec.replicas 与 spec.shards 乘以创建的 Pod 总数。默认： 1

resources

object

定义 'prometheus' 容器的资源请求和限值。

保留

string

保留 Prometheus 数据的时长。默认："24h"如果 spec.retention 和 spec.retentionSize 为空。

retentionSize

string

Prometheus 数据使用的最大字节数。

routePrefix

字符串

Prometheus 注册 HTTP 处理程序的路由前缀。这在使用 spec.externalURL 时很有用，并且代理被重写请求的 HTTP 路由，并且实际的 ExternalURL 仍为 true，但服务器在不同的路由前缀下提供请求。例如，用于 kubectl proxy。

ruleNamespaceSelector

object

用于与 PrometheusRule 发现匹配的命名空间。空标签选择器与所有命名空间匹配。null 标签选择器仅与当前命名空间匹配。

ruleSelector

object

为规则评估选择的 PrometheusRule 对象。空标签选择器匹配所有对象。null 标签选择器不匹配任何对象。

rules

object

定义 Prometheus 规则引擎的配置。

sampleLimit

整数

SampleLimit 对将接受的提取示例数量定义 per-scrape 限制。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

scrapeConfigNamespaceSelector

object

命名空间以匹配 ScrapeConfig 发现。空标签选择器与所有命名空间匹配。null 标签选择器仅与当前命名空间匹配。

scrapeConfigSelector

object

为目标发现选择 实验性 ScrapeConfigs。空标签选择器匹配所有对象。null 标签选择器不匹配任何对象。如果 spec.serviceMonitorSelector,spec.podMonitorSelector,spec.probeSelector 和 spec.scrapeConfigSelector 为 null，则 Prometheus 配置为非受管。Prometheus operator 将确保 Prometheus 配置的 Secret 存在，但负责用户在 prometheus.yaml.gz 键下提供原始 gzip Prometheus 配置。这个行为 已弃用，并将在自定义资源定义的下一个主版本中删除。建议您使用 spec.additionalScrapeConfigs 替代。

scrapeInterval

字符串

连续提取之间的间隔。默认："30s"

scrapeTimeout

string

等待提取请求超时的秒数。

secrets

数组（字符串）

secret 是与 Prometheus 对象相同的命名空间中的 Secret 列表，它应该被挂载到 Prometheus Pod 中。每个 Secret 都作为名为 secret-<secret-name> 的卷添加到 StatefulSet 定义中。Secret 被挂载到 'prometheus' 容器中的 /etc/prometheus/secrets/<secret-name> 中。

securityContext

对象

securityContext 包含 pod 级别的安全属性和通用容器设置。默认为默认的 PodSecurityContext。

serviceAccountName

字符串

serviceAccountName 是用于运行 Prometheus Pod 的 ServiceAccount 的名称。

serviceMonitorNamespaceSelector

object

用于与 ServicedMonitors 发现匹配的命名空间。空标签选择器与所有命名空间匹配。null 标签选择器仅与当前命名空间匹配。

serviceMonitorSelector

对象

为目标发现选择的 ServiceMonitor。空标签选择器匹配所有对象。null 标签选择器不匹配任何对象。如果 spec.serviceMonitorSelector,spec.podMonitorSelector,spec.probeSelector 和 spec.scrapeConfigSelector 为 null，则 Prometheus 配置为非受管。Prometheus operator 将确保 Prometheus 配置的 Secret 存在，但负责用户在 prometheus.yaml.gz 键下提供原始 gzip Prometheus 配置。这个行为 已弃用，并将在自定义资源定义的下一个主版本中删除。建议您使用 spec.additionalScrapeConfigs 替代。

sha

string

deprecated: 使用 'spec.image' 替代。镜像摘要可以指定为镜像名称的一部分。

分片

整数

EXPERIMENTAL：要分发目标的分片数量。spec.replicas 与 spec.shards 乘以创建的 Pod 总数。请注意，缩减分片不会在剩余的实例上重新划分数据，必须手动移动。增加分片不会重新划分数据，但将继续从同一实例获得。要全局查询，请使用 Thanos sidecar 和 Thanos querier 或远程写入数据到中央位置。分片在 PodMonitors 和 ServiceMonitors 和 param_targets 的地址 目标 meta-label 的内容上执行。默认： 1

storage

object

Storage 定义 Prometheus 使用的存储。

tag

string

deprecated: 使用 'spec.image' 替代。镜像标签可以指定为镜像名称的一部分。

targetLimit

整数

TargetLimit 定义了接受的提取目标数量的限制。仅在 Prometheus 版本 2.45.0 及更新版本中有效。

thanos

object

定义可选 Thanos sidecar 的配置。本节是实验性的，可能会在任何发行版本中没有弃用通知的情况下有很大变化。

容限（tolerations）

数组

如果指定，定义 Pod 的容限。

tolerations[]

对象

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

topologySpreadConstraints

数组

如果指定，定义 pod 的拓扑分布约束。

topologySpreadConstraints[]

对象

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

tracingConfig

object

EXPERIMENTAL：跟踪 Prometheus 中的配置追踪。这是一个实验性功能，可能会以中断的方式改变任何即将推出的发行版本。

tsdb

object

定义时间序列数据库(TSDB)的运行时重新加载配置。

version

string

正在部署的 Prometheus 版本。Operator 使用此信息来生成 Prometheus StatefulSet + 配置文件。如果没有指定，Operator 会假定发布 Operator 版本时可用的 Prometheus 的最新上游版本。

volumeMounts

数组

volumeMounts 允许配置额外的 VolumeMount。volumeMounts 将附加到"prometheus"容器中的其他 VolumeMount 中，这些 VolumeMount 因 StorageSpec 对象而生成。

volumeMounts[]

对象

VolumeMount 描述了容器内卷挂载。

卷

数组

卷允许在输出 StatefulSet 定义中配置额外的卷。指定的卷将附加到作为 StorageSpec 对象生成的其他卷。

volumes[]

对象

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

walCompression

布尔值

使用 Snappy 配置 write-ahead 日志(WAL)的压缩。Prometheus >= 2.20.0 需要 Prometheus v2.11.0 及更高版本默认启用 WAL 压缩。

web

object

定义 Prometheus web 服务器的配置。

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

name

string

参数的名称，如 "scrape.discovery-reload-interval"。

value

string

参数值，如 30s。对于仅限名称的参数（如 --storage.tsdb.no-lockfile）可以为空。

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

nodeAffinity

对象

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

podAffinity

对象

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

podAntiAffinity

对象

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

对象

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

preference

对象

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

weight

整数

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

nodeSelectorTerms

array

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

nodeSelectorTerms[]

对象

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchFields

array

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

matchFields[]

对象

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

key

字符串

选择器应用到的标签键。

operator

字符串

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

值

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

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

podAffinityTerm

对象

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

weight

整数

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

labelSelector

对象

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

labelSelector

对象

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

preferredDuringSchedulingIgnoredDuringExecution

array

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

preferredDuringSchedulingIgnoredDuringExecution[]

对象

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

requiredDuringSchedulingIgnoredDuringExecution

array

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

requiredDuringSchedulingIgnoredDuringExecution[]

对象

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

podAffinityTerm

对象

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

weight

整数

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

labelSelector

对象

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

labelSelector

对象

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

namespaceSelector

对象

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

命名空间

数组（字符串）

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

topologyKey

字符串

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

matchExpressions

array

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

matchExpressions[]

对象

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

matchLabels

对象（字符串）

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

key

字符串

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

operator

字符串

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

值

数组（字符串）

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

alertmanagers

array

AlertmanagerEndpoints Prometheus 应触发警报。

alertmanagers[]

object

AlertmanagerEndpoints 定义单个 Endpoints 对象，其中包含 Alertmanager IP 以触发警报。

apiVersion

字符串

Prometheus 用来发送警报的 Alertmanager API 版本。它可以是 "v1" 或 "v2"。

授权

object

Alertmanager 的授权部分。不可与 basicAuth、或 bearerTokenFile 同时设置。

basicAuth

object

Alertmanager 的 basicAuth 配置。不可与 bearerTokenFile 或 授权 同时设置。

bearerTokenFile

string

用于读取 Alertmanager 的 bearer 令牌的文件。不可与 basicAuth 或 授权 同时设置。弃用：这会在以后的版本中删除。首选使用 授权。

enableHttp2

布尔值

是否启用 HTTP2。

name

string

命名空间中的 Endpoints 对象的名称。

namespace

string

Endpoints 对象的命名空间。

pathPrefix

字符串

HTTP 路径警报的前缀被推送到。

port

integer-or-string

公开 Alertmanager API 的端口。

scheme

字符串

触发警报时要使用的方案。

timeout

字符串

timeout 是推送警报时每个目标 Alertmanager 超时。

tlsConfig

object

用于 Alertmanager 的 TLS Config。

credentials

object

选择命名空间中包含用于身份验证的凭证的 Secret 的键。

type

string

定义身份验证类型。该值不区分大小写。"basic"不是受支持的值。默认："Bearer"

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

password

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的密码。

username

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的用户名。

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

ca

object

验证服务器证书时使用的证书颁发机构。

cafile

字符串

Prometheus 容器中用于目标的 CA 证书的路径。

cert

object

执行 client-authentication 时要出现的客户端证书。

certFile

字符串

目标的 Prometheus 容器中客户端证书文件的路径。

insecureSkipVerify

布尔值

禁用目标证书验证。

keyFile

字符串

目标的 Prometheus 容器中客户端密钥文件的路径。

keySecret

对象

包含目标客户端密钥文件的 secret。

serverName

字符串

用于验证目标的主机名。

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

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

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

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

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

授权

object

API 服务器的授权部分。无法同时设置 basicAuth、bearerToken 或 bearerTokenFile。

basicAuth

object

API 服务器的 basicAuth 配置。无法同时设置授权、bearerToken 或 bearerToken File。

bearerToken

string

警告：不应使用这个字段，因为令牌值会出现在明文中。首选使用 授权。弃用：这会在以后的版本中删除。

bearerTokenFile

字符串

文件读取用于访问 apiserver 的 bearer 令牌。不可与 basicAuth、授权 或 bearerToken 同时设置。弃用：这会在以后的版本中删除。首选使用 授权。

主机

string

由主机名或 IP 地址组成的 Kubernetes API 地址，后跟可选的端口号。

tlsConfig

object

用于 API 服务器的 TLS 配置。

credentials

object

选择命名空间中包含用于身份验证的凭证的 Secret 的键。

credentialsFile

string

从中读取 secret 的文件，与 凭证 相互排斥。

type

string

定义身份验证类型。该值不区分大小写。"basic"不是受支持的值。默认："Bearer"

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

password

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的密码。

username

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的用户名。

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

ca

object

验证服务器证书时使用的证书颁发机构。

cafile

字符串

Prometheus 容器中用于目标的 CA 证书的路径。

cert

object

执行 client-authentication 时要出现的客户端证书。

certFile

字符串

目标的 Prometheus 容器中客户端证书文件的路径。

insecureSkipVerify

布尔值

禁用目标证书验证。

keyFile

字符串

目标的 Prometheus 容器中客户端密钥文件的路径。

keySecret

对象

包含目标客户端密钥文件的 secret。

serverName

字符串

用于验证目标的主机名。

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

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

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

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

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

deny

布尔值

args

数组（字符串）

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

命令

数组（字符串）

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

env

array

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

env[]

对象

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

envFrom

array

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

envFrom[]

对象

EnvFromSource 代表一组 ConfigMap 的源

image

string

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

imagePullPolicy

字符串

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

生命周期

对象

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

livenessProbe

对象

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

name

字符串

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

ports

array

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

ports[]

对象

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

readinessProbe

对象

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

resizePolicy

数组

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

resizePolicy[]

object

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

resources

对象

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

securityContext

对象

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

startupProbe

对象

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

stdin

布尔值

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

stdinOnce

布尔值

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

terminationMessagePath

字符串

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

terminationMessagePolicy

字符串

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

tty

布尔值

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

volumeDevices

array

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

volumeDevices[]

对象

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

volumeMounts

array

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

volumeMounts[]

对象

VolumeMount 描述了容器内卷挂载。

workingDir

字符串

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

name

字符串

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

value

字符串

变量引用 $(VAR_NAME)使用容器中之前定义的环境变量以及任何服务环境变量进行扩展。如果无法解析变量，则输入字符串中的引用将保持不变。双引号被缩减为一个单个 $，它用于转义 $(VAR_NAME)语法：即 " (VAR_NAME) " 将生成字符串 "$(VAR_NAME) "。转义的引用永远不会扩展，无论变量是否存在。默认为 ""。

valueFrom

对象

环境变量的值的源。如果值不为空，则无法使用。

configMapKeyRef

对象

选择 ConfigMap 的键。

fieldRef

对象

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

resourceFieldRef

对象

选择容器的资源：当前仅支持资源限值和请求(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage)。

secretKeyRef

对象

在 pod 命名空间中选择 secret 的键

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

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

apiVersion

字符串

模式的版本是按术语编写的 FieldPath，默认为 "v1"。

fieldPath

字符串

在指定 API 版本中选择的字段路径。

containerName

字符串

容器名称：卷需要，对于 env vars是可选的

divisor

integer-or-string

指定公开资源的输出格式，默认为 "1"

resource

字符串

必需：要选择的资源

key

字符串

要从中选择的 secret 的密钥。必须是一个有效的 secret 密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

configMapRef

对象

要从中选择的 ConfigMap

prefix

字符串

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

secretRef

对象

要从中选择的 Secret

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否必须定义 ConfigMap

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否必须定义 Secret

postStart

对象

postStart 在容器被创建后立即调用。如果处理程序失败，则容器将根据其重启策略终止并重启。容器块的其他管理，直到 hook 完成为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

preStop

对象

preStop 在因为 API 请求或管理事件而终止容器前马上调用，如存活度/启动探测失败、抢占、资源争用等。如果容器崩溃或退出，则不会调用处理程序。Pod 的终止宽限期倒计时开始，然后再执行 PreStop hook。无论处理程序的结果是什么，容器最终都会在 Pod 的终止宽限期内终止（除非被终结器造成延迟）。容器的其他管理块直到 hook 完成或直至到达终止宽限期为止。更多信息： https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks

exec

object

exec 指定要执行的操作。

httpGet

对象

httpGet 指定要执行的 http 请求。

tcpSocket

object

已弃用。tcpSocket 不支持作为 LifecycleHandler，并且保持向后兼容性。指定 tcp 处理程序时，没有此字段的验证和生命周期 hook 将在运行时失败。

命令

数组（字符串）

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

主机

字符串

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

httpHeaders

array

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

httpHeaders[]

对象

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

path

字符串

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

port

integer-or-string

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

scheme