Bitnami Grafana Operator 软件包

Grafana Operator是一个Kubernetes操作器（Operator），支持Grafana实例、仪表板和插件的安装与管理。

Grafana Operator概述

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

快速入门

helm install my-release oci://registry-1.docker.io/bitnamicharts/grafana-operator

希望在生产环境中使用Grafana Operator？请尝试VMware Tanzu应用目录，即Bitnami目录的商业版本。

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

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

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

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，改善所有Bitnami用户的安全状况。更多详情，请访问Bitnami安全镜像公告。

简介

Bitnami Helm图表经过精心设计、积极维护，是在Kubernetes集群上部署容器的最快、最简单方式，可直接用于生产工作负载。

本图表使用Helm包管理器在Kubernetes集群上引导部署Grafana Operator。

Bitnami Grafana图表与Bitnami Grafana Operator图表的区别

Bitnami目录同时提供bitnami/grafana和bitnami/grafana-operator两种图表。每种解决方案适用于不同的需求和场景。

• bitnami/grafana图表通过Kubernetes Deployment对象（以及Service、PVC、ConfigMap等）部署单个Grafana实例（含Grafana Image Renderer）。其生命周期通过Helm管理，在Grafana容器层面自动化以下操作：持久化管理、基于环境变量的配置以及插件初始化。该图表还支持通过ConfigMap部署仪表板和数据源。部署不需要任何具有特殊RBAC权限的ServiceAccount，因此更适合权限受限的Kubernetes环境。

                    +--------------+             +-----+
                    |              |             |     |
  Service & Ingress |    Grafana   +<------------+ PVC |
<-------------------+              |             |     |
                    |  Deployment  |             +-----+
                    |              |
                    +-----------+--+
                                ^                +------------+
                                |                |            |
                                +----------------+ Configmaps |
                                                 |   Secrets  |
                                                 |            |
                                                 +------------+

• bitnami/grafana-operator图表通过Kubernetes Deployment部署Grafana Operator。该Operator将通过以下对象扩展Kubernetes API：Grafana、GrafanaDashboard和GrafanaDataSource。此后，用户可部署这些类型的对象，Operator将负责部署运行Grafana实例所需的所有Deployment、ConfigMap和Service。其生命周期通过kubectl在Grafana、GrafanaDashboard和GrafanaDataSource对象上管理。

+--------------------+
|                    |      +---------------+
|  Grafana Operator  |      |               |
|                    |      |     RBAC      |
|    Deployment      |      |   Privileges  |
|                    |      |               |
+-------+------------+      +-------+-------+
        ^                           |
        |   +-----------------+     |
        +---+ Service Account +<----+
            +-----------------+

下图展示了使用kubectl部署Grafana对象后创建的资源：

+--------------------+
|                    |      +---------------+
|  Grafana Operator  |      |               |
|                    |      |     RBAC      |
|    Deployment      |      |   Privileges  |
|                    |      |               |
+--+----+------------+      +-------+-------+
   |    ^                           |
   |    |   +-----------------+     |
   |    +---+ Service Account +<----+
   |        +-----------------+
   |
   |
   |
   |
   |                                                   Grafana
   |                     +---------------------------------------------------------------------------+
   |                     |                                                                           |
   |                     |                          +--------------+             +-----+             |
   |                     |                          |              |             |     |             |
   +-------------------->+       Service & Ingress  |    Grafana   +<------------+ PVC |             |
                         |      <-------------------+              |             |     |             |
                         |                          |  Deployment  |             +-----+             |
                         |                          |              |                                 |
                         |                          +-----------+--+                                 |
                         |                                      ^                +------------+      |
                         |                                      |                |            |      |
                         |                                      +----------------+ Configmaps |      |
                         |                                                       |   Secrets  |      |
                         |                                                       |            |      |
                         |                                                       +------------+      |
                         |                                                                           |
                         +---------------------------------------------------------------------------+

注意：由于Operator自动部署Grafana实例，Grafana Operator Pod需要具有创建和销毁多个Kubernetes对象权限的ServiceAccount。这在具有严格基于角色访问策略的Kubernetes集群中可能存在问题。

先决条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装图表

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

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/grafana-operator

注意：需将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和仓库名称。例如，Bitnami的情况下，使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

上述命令使用默认配置在Kubernetes集群上部署grafana-operator。参数部分列出了可在安装过程中配置的参数。

提示：使用helm list查看所有发布

配置与安装详情

资源请求与限制

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

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

滚动标签与不可变标签

在生产环境中强烈建议使用不可变标签。这可确保即使相同标签的镜像更新，部署也不会自动变更。

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

备份与恢复

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

Prometheus指标

默认情况下，该图表通过metrics服务暴露Prometheus指标，该服务包含可被Prometheus自动抓取的必要注解。

Prometheus要求

要实现集成，需安装Prometheus或Prometheus Operator。安装Bitnami Prometheus Helm图表或Bitnami Kube Prometheus Helm图表可轻松在集群中部署Prometheus。

与Prometheus Operator集成

该图表支持部署ServiceMonitor对象以与Prometheus Operator集成。为此，需设置值operator.prometheus.serviceMonitor.enabled=true。确保集群中已安装Prometheus Operator的CustomResourceDefinitions，否则将失败并显示以下错误：

no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装Bitnami Kube Prometheus Helm图表可获取必要的CRD和Prometheus Operator。

创建Grafana仪表板

安装后，可在Kubernetes集群的CRD下创建仪表板。

有关这些CRD功能的更多详情，请参见使用仪表板。

部署额外的Grafana资源或对象

在某些情况下，可能需要部署额外对象，如自定义的Grafana、GrafanaDashboard或GrafanaDataSource对象。为此，该图表允许使用extraDeploy参数添加其他对象的完整规范。

例如，要部署自定义Grafana定义，可使用以下值安装Grafana Operator图表：

grafana:
  enabled: false
extraDeploy:
  - apiVersion: integreatly.org/v1alpha1
    baseImage: docker.io/bitnami/grafana:7
    kind: Grafana
    metadata:
      name: grafana
    spec:
      deployment:
        securityContext:
          runAsUser: 1001
          fsGroup: 1001
        containerSecurityContext:
          runAsUser: 1001
          fsGroup: 1001
          allowPrivilegeEscalation: false
      service:
        type: Load***
      ingress:
        enabled: false
      config:
        log:
          mode: "console"
          level: "warn"
        security:
          admin_user: "admin"
          admin_password: "hello"
        auth.anonymous:
          enabled: true
      dashboardLabelSelector:
        - matchExpressions:
            - { key: app, operator: In, values: [grafana] }

参数

全局参数

通用参数

Grafana Operator参数

注意：本图表的README超出了DockerHub的25000字符限制，因此已被截断。完整README可在[***]