Bitnami Grafana Tempo 镜像文档

1. 镜像概述和主要用途

Grafana Tempo 是一个分布式追踪系统，与 Grafana 具有开箱即用的集成能力。它专为大规模分布式系统设计，支持多种流行的追踪协议（如 Jaeger、Zipkin、OpenTelemetry 等），并提供高效的数据存储和查询能力。Bitnami grafana-tempo 镜像将 Grafana Tempo 容器化，提供安全、便捷的部署方案，适用于快速构建可观测性平台。

2. 核心功能和特性

2.1 Grafana Tempo 核心功能

分布式追踪：支持追踪请求在分布式系统中的流转路径，定位性能瓶颈。
Grafana 集成：与 Grafana 无缝对接，可直接在 Grafana 界面中查询和可视化追踪数据。
多协议支持：兼容 Jaeger、Zipkin、OpenTelemetry 等主流追踪协议。
高可扩展性：采用分层架构设计，支持水平扩展以应对大规模追踪数据。

2.2 Bitnami 镜像特性

非 root 用户运行：默认使用非特权用户，增强容器安全性。
安全加固：基于 Photon Linux 最小化操作系统，减少***面；支持 FIPS 模式。
供应链安全：提供 SBOM（软件物料清单）、VEX/KEV 漏洞透明度报告，符合 SLSA-3 标准。
持续更新：上游安全补丁发布后几小时内完成镜像更新，保障安全性。
跨环境一致性：容器、虚拟机、云镜像采用相同配置逻辑，便于多环境切换。

3. 使用场景和适用范围

分布式系统可观测性：适用于微服务、云原生等分布式架构，追踪服务间调用链路。
Grafana 生态集成：作为 Grafana 监控平台的补充，构建完整的 metrics + logs + traces 可观测性体系。
开发环境测试：免费版镜像（latest 标签）适合开发阶段快速部署和功能验证。
生产环境部署：建议使用 Bitnami Secure Images 商业版，提供企业级支持、长期维护和合规保障。

4. 使用方法

4.1 获取镜像

推荐从 Docker Hub 拉取预构建镜像：

console
docker pull bitnami/grafana-tempo:latest

如需特定版本，可指定标签（如 2.50.0，注意 2025 年 8 月后旧标签迁移至 bitnamilegacy 仓库）：

console
docker pull bitnami/grafana-tempo:[TAG]

4.2 快速启动

通过以下命令快速启动容器（仅用于开发测试，无持久化配置）：

console
docker run --name grafana-tempo bitnami/grafana-tempo:latest

4.3 Docker Compose 部署

创建 docker-compose.yml 文件，示例如下：

yaml
version: '2'
services:
  grafana-tempo:
    image: bitnami/grafana-tempo:latest
    volumes:
      - ./tempo.yaml:/bitnami/grafana-tempo/conf/tempo.yaml  # 挂载自定义配置文件
    ports:
      - "3200:3200"  # 默认 HTTP 端口

启动服务：

console
docker-compose up -d

4.4 运行命令

在容器内执行命令（如查看版本）：

console
docker run --rm bitnami/grafana-tempo:latest -- --version

5. 配置说明

5.1 自定义配置文件

Grafana Tempo 配置通过 tempo.yaml 文件定义，需挂载至容器内 /bitnami/grafana-tempo/conf/ 目录。示例：

console
docker run --rm -v /本地路径/tempo.yaml:/bitnami/grafana-tempo/conf/tempo.yaml bitnami/grafana-tempo:latest

配置项详情参考 Grafana Tempo ***文档。

5.2 FIPS 模式配置

Bitnami Secure Images 支持 FIPS 加密模式，通过环境变量 OPENSSL_FIPS 控制：

OPENSSL_FIPS=yes：启用 FIPS 模式（默认）
OPENSSL_FIPS=no：禁用 FIPS 模式

示例（Docker run）：

console
docker run --rm -e OPENSSL_FIPS=no bitnami/grafana-tempo:latest

6. 重要通知：Bitnami 镜像目录变更

自 2025 年 8 月 28 日起，Bitnami 将调整公共镜像目录，重点推广 Bitnami Secure Images 安全镜像：

免费版变更：非加固的 Debian 基础镜像将逐步废弃，仅保留 latest 标签供开发使用；旧版本标签（如 2.50.0）迁移至 docker.io/bitnamilegacy 仓库，不再更新。
生产环境建议：生产环境需使用 Bitnami Secure Images 商业版，包含企业级支持、CVE 透明化报告、长期维护等特性。详情参考 Bitnami Secure Images 公告。