Bitnami Grafana Tempo Query 镜像文档

镜像概述和主要用途

Grafana Tempo Query 是 Bitnami Grafana Tempo 图表的组件，专门与 jaeger-query 工具和 Jaeger 追踪协议配合工作，用于查询和检索分布式系统中的追踪数据。该镜像由 Bitnami 打包，提供安全优化的容器化部署方案，适用于开发环境中的分布式追踪数据查询场景。

核心功能和特性

Jaeger 协议兼容：无缝集成 jaeger-query 工具，支持 Jaeger 追踪协议，实现追踪数据的查询与可视化
安全加固：基于 Bitnami Secure Images 标准构建，采用最小化操作系统（Photon Linux），减少***面
配置灵活性：支持通过自定义配置文件调整查询服务参数，适配不同的 Tempo 后端部署
FIPS 合规性：提供 FIPS 模式配置选项，满足安全合规要求
非 root 用户运行：默认以非特权用户执行，增强容器运行时安全性
标准化部署：与 Bitnami 其他镜像（虚拟机、云镜像）采用一致的组件和配置方式，便于跨环境迁移

使用场景和适用范围

开发环境追踪查询：用于开发阶段调试分布式系统，查询 Tempo 存储的追踪数据
Jaeger 协议适配：需要通过 Jaeger 协议访问追踪数据的应用场景
Grafana Tempo 配套组件：作为 Grafana Tempo 后端的查询服务，配合 Grafana UI 实现追踪数据可视化
安全合规场景：需满足 FIPS 加密标准或最小***面要求的开发环境部署

快速开始 (TL;DR)

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

镜像获取

推荐方式：从 Docker Hub 拉取

console
# 拉取最新版本
docker pull bitnami/grafana-tempo-query:latest

# 拉取特定版本（需替换 [TAG] 为具体版本号）
docker pull bitnami/grafana-tempo-query:[TAG]

构建镜像（可选）

console
git clone [***]
cd bitnami/grafana-tempo-query/[VERSION]/[OPERATING-SYSTEM]
docker build -t bitnami/grafana-tempo-query:latest .

注：请将 [VERSION] 和 [OPERATING-SYSTEM] 替换为实际分支路径中的版本号和操作系统名称。

使用方法

基本运行

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

自定义配置

通过挂载自定义 tempo-query.yaml 配置文件来自定义服务行为：

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

配置文件格式参考 Grafana Tempo ***文档和 Jaeger Query 文档。

执行命令

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

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

配置说明

环境变量

环境变量	描述	默认值
`OPENSSL_FIPS`	启用/禁用 OpenSSL FIPS 模式（仅 Bitnami Secure Images 支持）	`yes`

FIPS 配置

Bitnami Secure Images 版本支持 FIPS 模式配置，通过环境变量 OPENSSL_FIPS 控制：

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

重要说明：Bitnami Catalog 变更通知

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

安全镜像开放：首次向社区用户提供安全优化版本的容器镜像
非加固镜像 deprecation：逐步停止对非加固 Debian 基础镜像的免费支持，公共目录将仅保留少量加固镜像的 latest 标签（用于开发目的）
镜像迁移：现有所有镜像（含历史版本标签，如 2.50.0、10.6）将在两周内迁移至 docker.io/bitnamilegacy 仓库，且不再更新
生产环境建议：生产环境推荐使用 Bitnami Secure Images，包含加固容器、CVE 透明度（VEX/KEV）、SBOM 和企业支持

详细信息请参见 Bitnami Secure Images 公告。