bitnami/hubble-relay

Bitnami Hubble Relay 镜像文档

1. 镜像概述

Bitnami Hubble Relay 镜像是 Bitnami 打包的 Hubble Relay 容器化部署方案。Hubble Relay 是 Cilium 项目的组件，用于通过连接集群中所有运行的 Hubble 服务器的 gRPC API，收集基于 eBPF 的网络可见性数据，并提供统一的 API 接口来访问聚合后的所有数据。

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

2. 核心功能与特性

• 数据聚合：连接集群中多个 Hubble 服务器的 gRPC API，聚合分布式 eBPF 可见性数据
• 统一接口：提供单一 API 端点，简化对集群网络数据的访问与管理
• 轻量部署：容器化设计，适合 Kubernetes 环境集成，作为 Cilium 网络方案的一部分
• 安全优化：支持 Bitnami Secure Images 标准，包含硬化配置与最小化***面（适用于 Secure Images 版本）

3. 使用场景与适用范围

• Kubernetes 网络监控：在 Kubernetes 集群中部署，用于收集、聚合和展示网络流量与服务通信的 eBPF 监控数据
• Cilium 生态集成：作为 Bitnami Cilium Helm Chart 的组件，与 Cilium CNI 协同工作，提供网络可见性能力
• 开发与测试环境：通过容器化部署快速搭建网络监控原型，验证集群网络策略与流量模型

4. 安装与部署

4.1 获取镜像

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

console
# 拉取最新版本（默认指向 Bitnami Secure Images 硬化版本）
docker pull bitnami/hubble-relay:latest

# 拉取指定版本（仅 legacy 仓库提供，详见「重要通知」）
docker pull bitnamilegacy/hubble-relay:[TAG]  # 例如：2.50.0、10.6

如需手动构建镜像，可克隆 Bitnami 容器仓库并执行构建：

console
git clone https://github.com/bitnami/containers.git
cd containers/bitnami/hubble-relay/[VERSION]/[操作系统]
docker build -t bitnami/hubble-relay:latest .

4.2 Docker 部署

使用 docker run 快速启动容器：

console
docker run --name hubble-relay bitnami/hubble-relay:latest

4.3 Kubernetes 部署

推荐通过 Bitnami Cilium Helm Chart 部署，该镜像作为 Chart 的一部分预集成：

console
# 添加 Bitnami Helm 仓库
helm repo add bitnami https://charts.bitnami.com/bitnami

# 部署 Cilium（包含 Hubble Relay）
helm install cilium bitnami/cilium --namespace kube-system

详细部署说明参见 https://github.com/bitnami/charts/tree/main/bitnami/cilium%E3%80%82

5. 配置说明

5.1 运行命令

通过 docker run 执行容器内命令（如查看帮助）：

console
docker run --rm --name hubble-relay bitnami/hubble-relay:latest help

更多配置选项参见 Hubble Relay 官方文档。

5.2 FIPS 模式配置（Bitnami Secure Images）

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

示例：禁用 FIPS 模式启动容器

console
docker run --name hubble-relay -e OPENSSL_FIPS=no bitnami/hubble-relay:latest

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

自 2025 年 8 月 28 日起，Bitnami 将启动 Bitnami Secure Images 计划，调整公共镜像目录策略：

变更内容

• 非硬化镜像迁移：所有现有容器镜像（含历史版本标签，如 2.50.0、10.6）将在两周内从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新
• 免费 tier 调整：免费用户仅可访问硬化版本的 latest 标签镜像（用于开发目的），非硬化 Debian 镜像将逐步弃用
• 生产环境建议：生产环境需使用 Bitnami Secure Images，包含硬化容器、CVE 透明度（VEX/KEV）、SBOMs 及企业支持

影响与建议

• 开发环境：继续使用 bitnami/hubble-relay:latest（硬化版本）
• 生产环境：迁移至 Bitnami Secure Images，获取长期支持与安全更新
• 历史版本：如需旧版本，需从 bitnamilegacy 仓库拉取（无更新）

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

7. 贡献与支持

7.1 贡献代码

通过 GitHub 提交 issue 或 PR 参与改进：

• https://github.com/bitnami/containers/issues
• https://github.com/bitnami/containers/pulls

7.2 问题反馈

如遇部署或运行问题，请通过 https://github.com/bitnami/containers/issues/new/choose 提交详细信息，以便快速定位问题。

8. 许可信息

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本软件基于 Apache License 2.0 许可协议分发：

您可以在遵循许可协议的前提下使用本软件。
许可协议副本可从 [***] 获取。
除非***要求或书面同意，软件按"原样"分发，不提供任何明示或暗示的担保或条件。