bitnamicharts/kube-prometheus

Bitnami的Prometheus Operator Helm图表，用于在Kubernetes上提供简单的监控定义，以及Prometheus实例的部署和管理，包含Prometheus、Alertmanager等组件，便于快速搭建Kubernetes监控系统。

0 次下载activebitnamicharts

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Bitnami Prometheus Operator 软件包

Prometheus Operator为Kubernetes服务提供简单的监控定义，并支持Prometheus实例的部署和管理。

Prometheus Operator 概述

商标声明：本软件列表由Bitnami打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

TL;DR

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/kube-prometheus

提示：您知道此应用也可作为Azure Marketplace上的Kubernetes应用使用吗？Kubernetes应用是在AKS上部署Bitnami的最简单方式。点击此处查看Azure Marketplace上的列表。

希望在生产环境中使用Prometheus Operator？试试VMware Tanzu Application Catalog，这是Bitnami目录的商业版。

⚠️ 重要通知：Bitnami目录即将发生的变更

自2025年8月28日起，Bitnami将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像集。作为此次过渡的一部分：

首次向社区用户提供流行容器镜像的安全优化版本访问权限。
Bitnami将开始在其免费层级中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，适用于开发目的。
从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），迁移后将不再接收更新。
对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，其中包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。有关更多详情，请访问Bitnami Secure Images公告。

介绍

此图表使用Helm包管理器在Kubernetes上引导Prometheus Operator部署。

在默认配置下，该图表会在Kubernetes集群上部署以下组件：

Prometheus Operator
Prometheus
Alertmanager

:warning: 重要

集群中应只运行一个Prometheus Operator组件实例。如果您希望部署此图表以管理集群中的多个Prometheus实例，则必须禁用Prometheus Operator组件的安装，使用operator.enabled=false图表安装参数。

前提条件

Kubernetes 1.23+
Helm 3.8.0+

安装图表

要安装发布名称为my-release的图表：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/kube-prometheus

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

该命令会以默认配置在Kubernetes集群上部署kube-prometheus。配置部分列出了安装过程中可配置的参数。

提示：使用helm list列出所有发布

配置和安装详情

资源请求和限制

Bitnami图表允许为图表部署中的所有容器设置资源请求和限制。这些设置位于resources值中（参见参数表）。为生产工作负载设置请求至关重要，应根据您的具体用例进行调整。

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。查看bitnami/common图表中的这些预设。但是，在生产工作负载中不建议使用resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参见***Kubernetes文档。

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这样可确保如果同一标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami将发布新图表更新其容器。

额外抓取配置

以下值已被弃用。请参见下面的升级部分。

console
prometheus.additionalScrapeConfigsExternal.enabled
prometheus.additionalScrapeConfigsExternal.name
prometheus.additionalScrapeConfigsExternal.key

通过将prometheus.additionalScrapeConfigs.enabled设置为true并将prometheus.additionalScrapeConfigs.type设置为external，可以通过Secret注入外部管理的抓取配置。该Secret必须存在于与图表部署相同的命名空间中。使用参数prometheus.additionalScrapeConfigs.external.name设置Secret名称，并使用prometheus.additionalScrapeConfigs.external.key设置包含额外抓取配置的键。

text
prometheus.additionalScrapeConfigs.enabled=true
prometheus.additionalScrapeConfigs.type=external
prometheus.additionalScrapeConfigs.external.name=kube-prometheus-prometheus-scrape-config
prometheus.additionalScrapeConfigs.external.key=additional-scrape-configs.yaml

还可以通过将prometheus.additionalScrapeConfigs.enabled设置为true并将prometheus.additionalScrapeConfigs.type设置为internal，定义由Helm图表管理的抓取配置。然后可以使用prometheus.additionalScrapeConfigs.internal.jobList定义Prometheus的额外抓取任务列表。

text
prometheus.additionalScrapeConfigs.enabled=true
prometheus.additionalScrapeConfigs.type=internal
prometheus.additionalScrapeConfigs.internal.jobList=
      - job_name: 'opentelemetry-collector'
        # metrics_path默认为'/metrics'
        # scheme默认为'http'。
        static_configs:
          - targets: ['opentelemetry-collector:8889']

有关更多信息，请参见额外抓取配置文档。

额外告警重标签配置

通过将prometheus.additionalAlertRelabelConfigsExternal.enabled设置为true，可以通过Secret注入外部管理的Prometheus告警重标签配置。该Secret必须存在于与图表部署相同的命名空间中。

使用参数prometheus.additionalAlertRelabelConfigsExternal.name设置Secret名称，并使用prometheus.additionalAlertRelabelConfigsExternal.key设置包含额外告警重标签配置的键。例如，如果您创建了一个名为kube-prometheus-prometheus-alert-relabel-config的Secret，其中包含一个名为additional-alert-relabel-configs.yaml的文件，请使用以下参数：

text
prometheus.additionalAlertRelabelConfigsExternal.enabled=true
prometheus.additionalAlertRelabelConfigsExternal.name=kube-prometheus-prometheus-alert-relabel-config
prometheus.additionalAlertRelabelConfigsExternal.key=additional-alert-relabel-configs.yaml

备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，您需要从源部署备份持久卷，并使用Velero（Kubernetes备份/恢复工具）将其附加到新部署。有关使用Velero的说明，请参见本指南。

设置Pod亲和性

此图表允许使用XXX.affinity参数设置自定义Pod亲和性。有关Pod亲和性的更多信息，请参见Kubernetes文档。

作为替代方案，可以使用bitnami/common图表中提供的Pod亲和性、Pod反亲和性和节点亲和性的预设配置之一。为此，设置XXX.podAffinityPreset、XXX.podAntiAffinityPreset或XXX.nodeAffinityPreset参数。

参数

全局参数

名称	描述	值
`global.imageRegistry`	全局Docker镜像仓库	`""`
`global.imagePullSecrets`	全局Docker仓库密钥名称数组	`[]`
`global.defaultStorageClass`	持久卷的全局默认StorageClass	`""`
`global.security.allowInsecureImages`	允许跳过镜像验证	`false`
`global.compatibility.openshift.adaptSecurityContext`	调整部署的securityContext部分，使其与Openshift restricted-v2 SCC兼容：移除runAsUser、runAsGroup和fsGroup，让平台使用其允许的默认ID。可能的值：auto（如果检测到运行的集群是Openshift则应用）、force（始终执行调整）、disabled（不执行调整）	`auto`

通用参数

名称	描述	值
`kubeVersion`	强制目标Kubernetes版本（如果未设置，则使用Helm能力）	`""`
`nameOverride`	用于部分覆盖`kube-prometheus.name`模板的字符串（将前置发布名称）	`""`
`fullnameOverride`	用于完全覆盖`kube-prometheus.fullname`模板的字符串	`""`
`namespaceOverride`	用于完全覆盖common.names.namespace的字符串	`""`
`commonAnnotations`	要添加到所有部署对象的注解	`{}`
`commonLabels`	要添加到所有部署对象的标签	`{}`
`extraDeploy`	要随发布一起部署的额外对象数组	`[]`
`clusterDomain`	Kubernetes集群域名	`cluster.local`

Prometheus Operator参数

名称	描述	值
`operator.enabled`	部署Prometheus Operator到集群	`true`
`operator.image.registry`	Prometheus Operator镜像仓库	`REGISTRY_NAME`
`operator.image.repository`	Prometheus Operator镜像存储库	`REPOSITORY_NAME/prometheus-operator`
`operator.image.digest`	Prometheus Operator镜像摘要，格式为sha256:aa.... 注意：如果设置此参数，将覆盖标签	`""`
`operator.image.pullPolicy`	Prometheus Operator镜像拉取策略	`IfNotPresent`
`operator.image.pullSecrets`	指定docker-registry密钥名称数组	`[]`
`operator.extraArgs`	传递给Prometheus Operator的额外参数	`[]`
`operator.command`	覆盖默认容器命令（在使用自定义镜像时有用）	`[]`
`operator.args`	覆盖默认容器参数（在使用自定义镜像时有用）	`[]`
`operator.lifecycleHooks`	Prometheus Operator容器的生命周期钩子，用于在启动前后自动配置	`{}`
`operator.extraEnvVars`	要添加到Prometheus Operator节点的额外环境变量数组	`[]`
`operator.extraEnvVarsCM`	包含Prometheus Operator节点额外环境变量的现有ConfigMap名称	`""`
`operator.extraEnvVarsSecret`	包含Prometheus Operator节点额外环境变量的现有Secret名称	`""`
`operator.extraVolumes`	可选地为Prometheus Operator pod指定额外的卷列表	`[]`
`operator.extraVolumeMounts`	可选地为Prometheus Operator容器指定额外的volumeMounts列表	`[]`
`operator.sidecars`	向Prometheus Operator pod添加额外的sidecar容器	`[]`
`operator.initContainers`	向Prometheus Operator pod添加额外的init容器	`[]`
`operator.automountServiceAccountToken`	在pod中挂载服务账户令牌	`true`
`operator.hostAliases`	添加部署主机别名	`[]`
`operator.serviceAccount.create`	指定是否为Prometheus Operator创建ServiceAccount	`true`
`operator.serviceAccount.name`	要创建的ServiceAccount名称	`""`
`operator.serviceAccount.automountServiceAccountToken`	为服务器服务账户自动挂载服务账户令牌	`false`
`operator.serviceAccount.annotations`	服务账户的注解。作为模板计算。仅在`create`为`true`时使用。	`{}`
`operator.schedulerName`	Kubernetes调度器名称（非默认）	`""`
`operator.terminationGracePeriodSeconds`	Prometheus Operator pod优雅终止所需的时间（秒）	`""`
`operator.topologySpreadConstraints`	pod分配的拓扑扩展约束	`[]`
`operator.podSecurityContext.enabled`	启用