bitnamicharts/grafana-mimir

Bitnami Grafana Mimir Helm Chart 文档

镜像概述和主要用途

Grafana Mimir 是一款开源的、水平可扩展的、高可用的、多租户的 Prometheus 长期存储解决方案。Bitnami 提供的此 Helm Chart 用于在 Kubernetes 集群中快速部署和配置 Grafana Mimir，简化其在容器化环境中的部署流程，适用于开发和生产环境的监控数据存储需求。

核心功能和特性

• 水平扩展能力：支持通过增加节点实现集群水平扩展，满足不断增长的监控数据存储需求。
• 高可用性：多副本部署架构，确保服务持续可用，避免单点故障。
• 多租户支持：原生支持多租户隔离，适合团队或组织内的资源共享与隔离。
• 长期数据存储：为 Prometheus 提供长期数据存储能力，解决 Prometheus 本地存储的容量和生命周期限制。
• 灵活的存储后端：支持多种存储后端（如 S3、GCS 等），可根据需求配置块存储。
• Prometheus 兼容：提供与 Prometheus 兼容的 API，无缝集成现有 Prometheus 生态工具。
• 监控指标集成：支持通过 Prometheus 采集自身运行指标，便于监控系统状态。
• 可配置的缓存：支持集成外部 Memcached 服务，优化数据查询性能。

使用场景和适用范围

• Prometheus 长期数据存储：替代 Prometheus 本地存储，实现监控数据的长期留存（如数月或数年）。
• 多租户监控环境：企业或团队内部多项目、多团队共享监控基础设施，需租户隔离的场景。
• Kubernetes 集群监控：在 Kubernetes 集群中部署，存储集群内应用和基础设施的监控数据。
• 大规模监控系统：适用于监控指标量大、需要水平扩展能力的场景（如大型分布式系统）。
• 开发与生产环境：支持开发环境的快速部署，同时可通过配置优化满足生产环境的稳定性和安全性要求。

前提条件

• Kubernetes 集群版本 1.23 及以上
• Helm 版本 3.8.0 及以上
• 集群支持持久卷（PV）动态供应

安装指南

快速安装（TL;DR）

通过 Helm 快速安装默认配置的 Grafana Mimir：

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

详细安装步骤

1. 添加 Bitnami Helm 仓库（如未添加）

console
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

2. 安装 Chart

使用自定义 release 名称（如 my-grafana-mimir）安装：

console
helm install my-grafana-mimir oci://registry-1.docker.io/bitnamicharts/grafana-mimir

注意：如需指定自定义配置，可通过 -f values.yaml 参数传入配置文件，或使用 --set 覆盖单个参数（如 --set mimir.replicaCount=3）。

重要注意事项：Bitnami 镜像计划变更

自 2025 年 8 月 28 日起，Bitnami 将调整其公共镜像目录，推出 Bitnami Secure Images 计划，主要变更包括：

• 安全镜像开放：首次向社区用户提供安全优化版本的容器镜像，减少***面并提供 CVE 透明度。
• 非硬化镜像逐步弃用：免费 tier 中将逐步停止支持非硬化的 Debian 基础镜像，仅保留“latest”标签的硬化镜像（用于开发目的）。
• 旧镜像迁移：现有所有镜像（含历史版本标签，如 2.50.0、10.6）将迁移至 docker.io/bitnamilegacy 仓库，不再接收更新。
• 生产环境建议：生产环境需使用 Bitnami Secure Images，获取硬化容器、企业支持及长期维护。

详情参见 https://github.com/bitnami/containers/issues/83267%E3%80%82

详细配置说明

资源配置

通过 resources 参数配置容器的 CPU 和内存资源请求与限制，建议根据实际负载调整。示例：

yaml
mimir:
  resources:
    requests:
      cpu: 100m
      memory: 256Mi
    limits:
      cpu: 1000m
      memory: 1Gi

生产环境注意：避免使用 resourcesPreset（预设资源配置），需根据实际需求手动调整资源参数，确保性能稳定。

持久化存储

Grafana Mimir 数据默认存储在容器的 /bitnami/grafana-mimir 路径，通过 Persistent Volume Claim（PVC）实现数据持久化。可通过以下参数配置存储：

yaml
mimir:
  persistence:
    enabled: true
    storageClass: "standard"  # 指定存储类
    size: 10Gi                # 存储容量

Mimir 配置

Mimir 核心配置通过 mimir.configuration 参数定义，支持模板化配置（可引用其他 Chart 参数）。配置示例（S3 存储后端）：

yaml
mimir:
  configuration: |
    multitenancy_enabled: true
    limits:
      global:
        max_label_names_per_series: 30
    block_storage:
      backend: s3
      s3:
        bucket_name: mimir-data
        endpoint: s3.us-east-1.amazonaws.com
        insecure: false

配置参数参考 Grafana Mimir 官方文档。

外部缓存集成

如需使用外部 Memcached 而非内置实例，需禁用内置 Memcached 并配置外部服务参数：

yaml
memcachedchunks:
  enabled: false  # 禁用内置 Memcached

externalMemcachedChunks:
  host: "external-memcached.example.com"  # 外部 Memcached 主机
  port: 11211                             # 外部 Memcached 端口

Prometheus 指标集成

启用 Prometheus 指标采集，需设置 metrics.enabled: true，自动暴露指标端口并添加 Prometheus 抓取注解：

yaml
metrics:
  enabled: true
  serviceMonitor:
    enabled: true  # 如需 Prometheus Operator 自动发现，需启用 ServiceMonitor

环境变量配置

通过 extraEnvVars 为各组件（如 distributor、ingester 等）添加环境变量，用于配置敏感信息（如存储密钥）：

yaml
storeGateway:
  extraEnvVars:
    - name: S3_ACCESS_KEY_ID
      valueFrom:
        secretKeyRef:
          name: s3-credentials  # 存储密钥的 Secret 名称
          key: access-key
    - name: S3_SECRET_ACCESS_KEY
      valueFrom:
        secretKeyRef:
          name: s3-credentials
          key: secret-key

参数参考

全局参数

通用参数

Mimir 核心参数

备份与恢复

使用 Velero 工具备份和恢复 Kubernetes 集群中的 Grafana Mimir 部署，核心步骤包括：

1. 备份 Mimir 的 PVC 数据；
2. 在目标集群中恢复 PVC 并关联新部署。

详细操作参考 Bitnami 备份恢复指南。

卸载

通过 Helm 卸载 release：

console
helm uninstall my-release

注意：卸载不会自动删除 PVC，需手动清理残留数据：kubectl delete pvc -l app.kubernetes.io/instance=my-release。