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)

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

镜像获取

推荐方式：从 Docker Hub 拉取

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

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

构建镜像（可选）

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

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

使用方法

基本运行

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

自定义配置

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

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 文档。

执行命令

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

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

配置说明

环境变量

FIPS 配置

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

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 公告。

为什么选择 Bitnami Secure Images？

• 安全优化：提供安全加固容器，减少攻击面，支持 CVE 透明度（VEX/KEV）和 EPSS 评分
• 最小化基础：基于 Photon Linux 构建，保持行业标准包格式的同时减少系统组件
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全漏洞快速修复
• 跨格式一致性：容器、虚拟机和云镜像采用相同组件和配置方式，便于跨环境迁移
• 合规性支持：提供 SLSA-3 合规的软件供应链，包含签名验证（Notation）、SBOM、病毒扫描报告等元数据

支持的标签

Bitnami 镜像标签遵循标准化命名策略，区分滚动标签（如 latest）和不可变标签（如特定版本号）。具体标签列表可通过 Docker Hub 标签页 查看。

标签信息文件（tags-info.yaml）位于镜像仓库分支目录中，可通过查看 bitnami/grafana-tempo-query/[BRANCH]/[DISTRO]/tags-info.yaml 了解标签对应关系。

非 root 容器说明

该镜像默认以非 root 用户运行，增强运行时安全性。非 root 容器限制特权操作，但通过标准化的文件权限设计确保应用正常运行。更多信息参见 Bitnami 非 root 容器文档。

显著变更

2024 年 1 月 16 日起

• 移除 docker-compose.yaml 文件，该文件仅用于内部测试。

贡献

欢迎通过 GitHub Issues 提出功能需求，或提交 Pull Request 参与镜像改进。

问题反馈

如在使用中遇到问题，请通过 GitHub Issues 提交，并按模板提供详细信息以便快速定位问题。

许可协议

本镜像的使用受 Apache License 2.0 许可约束。详情参见 LICENSE。

商标声明：本软件列表由 Bitnami 打包，提及的商标分属各自公司所有，使用不暗示任何关联或背书。