Bitnami Grafana Alloy 镜像文档

镜像概述和主要用途

Grafana Alloy 是一个开源的 OpenTelemetry Collector 发行版，内置 Prometheus 管道，支持指标、日志、追踪和剖析功能。Bitnami 提供的 Grafana Alloy 镜像将这一强大工具打包为容器化解决方案，便于快速部署和集成到监控系统中。

Grafana Alloy 概述
商标声明：本软件列表由 Bitnami 打包。产品中提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

核心功能和特性

• 完整集成 OpenTelemetry Collector 功能
• 内置 Prometheus 数据处理管道
• 多信号支持：指标、日志、追踪和剖析
• 安全加固的容器环境
• 非 root 用户运行，减少安全风险
• 支持 FIPS 模式配置（Bitnami 安全镜像版本）
• 与 Bitnami 其他容器、虚拟机和云镜像使用一致的组件和配置方法

使用场景和适用范围

• 构建统一可观测性平台，集中收集和处理监控数据
• 作为 Prometheus 和 OpenTelemetry 的替代方案或补充
• 微服务架构中的分布式追踪和性能监控
• DevOps 环境中的日志聚合和分析
• 需要符合安全标准（如 FIPS）的企业级监控部署
• 开发环境快速搭建和测试监控配置

快速启动

docker run --name grafana-alloy bitnami/grafana-alloy:latest

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

自 2025 年 8 月 28 日起，Bitnami 将改进其公共目录，通过新的 Bitnami Secure Images 计划 提供精选的强化安全型镜像集。此次转型包括：

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

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全态势。更多详情，请访问 Bitnami Secure Images 公告。

为什么使用 Bitnami Secure Images？

• Bitnami 安全镜像和 Helm 图表旨在使开源软件更安全且适合企业使用
• 使用行业标准漏洞可利用性交换 (VEX)、KEV 和 EPSS 分数，更快地分类安全漏洞，提高 CVE 风险透明度
• 强化镜像使用最小化操作系统 (Photon Linux)，减少攻击面，同时通过行业标准包格式保持可扩展性
• 通过持续构建的镜像在 upstream 补丁发布后数小时内更新，保持更高的安全性和合规性
• Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方法，便于根据项目需求在不同格式之间切换
• 强化镜像附带证明签名 (Notation)、SBOM、病毒扫描报告和其他元数据，这些元数据在符合 SLSA-3 标准的软件工厂中生成

只有部分 BSI 应用程序可免费使用。想要访问完整的应用程序目录以及企业支持？立即尝试 Bitnami Secure Images 商业版。

支持的标签和对应的 Dockerfile 链接

了解有关 Bitnami 标签政策以及滚动标签和不可变标签之间区别的更多信息，请参阅 文档页面。

您可以通过查看分支文件夹中的 tags-info.yaml 文件来了解不同标签之间的对应关系，例如 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml。

通过关注 bitnami/containers GitHub 仓库 订阅项目更新。

获取此镜像

获取 Bitnami Grafana Alloy Docker 镜像的推荐方法是从 Docker Hub 注册表 拉取预构建镜像。

docker pull bitnami/grafana-alloy:latest

要使用特定版本，您可以拉取带版本的标签。您可以在 Docker Hub 注册表中查看 可用版本列表。

docker pull bitnami/grafana-alloy:[TAG]

如果需要，您也可以通过克隆仓库、切换到包含 Dockerfile 的目录并执行 docker build 命令来自行构建镜像。请记得将下面示例命令中的 APP、VERSION 和 OPERATING-SYSTEM 路径占位符替换为正确的值。

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

为什么使用非 root 容器？

非 root 容器镜像增加了一层额外的安全性，通常推荐用于生产环境。然而，由于它们以非 root 用户身份运行，通常无法执行特权任务。在我们的 文档 中了解更多关于非 root 容器的信息。

详细配置说明

运行命令

要在此容器内运行命令，您可以使用 docker run，例如执行 alloy --help，可按照以下示例操作：

docker run --rm --name grafana-alloy bitnami/grafana-alloy:latest -- --help

有关更多信息，请查看 官方 Grafana Alloy 文档。

Bitnami 安全镜像中的 FIPS 配置

来自 Bitnami Secure Images 目录的 Bitnami Grafana Alloy Docker 镜像包含额外功能和设置，可将容器配置为具有 FIPS 功能。您可以配置以下环境变量：

• OPENSSL_FIPS: OpenSSL 是否以 FIPS 模式运行。可选值：yes（默认）、no

贡献指南

我们欢迎您为此容器做出贡献。您可以通过创建 issue 请求新功能，或提交 pull request 贡献代码。

问题反馈

如果您在运行此容器时遇到问题，可以提交 issue。为了让我们提供更好的支持，请务必填写 issue 模板。

许可证

Copyright © 2025 Broadcom。术语 "Broadcom" 指 Broadcom Inc. 和/或其子公司。

根据 Apache 许可证 2.0 版（"许可证"）授权；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获取许可证副本：

<[***]>

除非适用法律要求或书面同意，否则根据许可证分发的软件按 "原样" 分发，不附带任何明示或暗示的担保或条件。有关许可证下权限和限制的具体语言，请参阅许可证。