Bitnami Push Gateway 镜像文档

1. 镜像概述和主要用途

什么是 Push Gateway？

Push Gateway 是一个中间服务，允许无法被 Prometheus 抓取的任务推送指标。

Push Gateway 作为 Prometheus 生态的关键组件，主要用途是接收来自短期运行任务、临时性服务或网络隔离环境中任务的指标数据，并将其缓存，供 Prometheus 定期抓取。这解决了 Prometheus 主动抓取模式下无法监控短生命周期或不可访问目标的问题。

2. 核心功能与特性

• 非 root 容器运行：采用非特权用户运行，减少安全风险，符合生产环境最佳实践
• 安全加固：基于 Bitnami Secure Images 构建，使用最小化 Photon Linux 系统，降低攻击面
• FIPS 合规支持：可配置 FIPS 模式，满足企业级安全合规要求
• 无缝集成 Prometheus：支持 Prometheus 标准指标格式，需配置 honor_labels: true 确保指标正确性
• 供应链安全：提供 SBOMs（软件物料清单）、漏洞扫描报告及 SLSA-3 合规的构建元数据
• 跨环境一致性：与 Bitnami 虚拟机、云镜像使用相同组件和配置策略，便于多环境迁移

3. 使用场景和适用范围

• 短生命周期任务：如 CI/CD 流水线、批处理作业等一次性任务，无法被 Prometheus 持续抓取
• 网络隔离环境：运行在防火墙后或私有网络中的任务，Prometheus 无法直接访问
• 动态扩展服务：自动扩缩容的容器或实例，IP 地址频繁变化，难以预先配置抓取目标
• 边缘计算场景：边缘设备或弱网环境中的任务，需主动推送指标而非被动抓取
• 开发测试环境：快速验证指标收集逻辑，无需配置复杂的 Prometheus 抓取规则

4. 快速开始

docker run --name pushgateway bitnami/pushgateway:latest

5. 获取镜像

推荐方式：从 Docker Hub 拉取

# 拉取最新版本
docker pull bitnami/pushgateway:latest

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

手动构建镜像

git clone [***]
cd bitnami/pushgateway/[VERSION]/[OPERATING-SYSTEM]  # 替换为实际版本和系统
docker build -t bitnami/pushgateway:latest .

6. 使用方法

基本运行配置

# 启动 Push Gateway 容器并映射默认端口（9091）
docker run -d --name pushgateway -p 9091:9091 bitnami/pushgateway:latest

容器网络配置

步骤 1：创建自定义网络

docker network create pushgateway-network --driver bridge

步骤 2：在自定义网络中启动容器

docker run -d \
  --name pushgateway \
  --network pushgateway-network \
  bitnami/pushgateway:latest

步骤 3：连接其他容器

同一网络中的容器可通过容器名访问 Push Gateway：

# 示例：在同一网络中启动 Prometheus 容器
docker run -d \
  --name prometheus \
  --network pushgateway-network \
  prom/prometheus

7. 配置说明

Prometheus 集成配置

需在 Prometheus 配置文件中添加如下抓取规则，确保 honor_labels: true：

scrape_configs:
  - job_name: 'pushgateway'
    honor_labels: true  # 必须设置，避免推送指标的标签被覆盖
    static_configs:
      - targets: ['pushgateway:9091']  # 使用容器名或 IP 地址

环境变量配置

FIPS 模式配置示例

docker run -d \
  --name pushgateway \
  -e OPENSSL_FIPS=no \  # 禁用 FIPS 模式
  bitnami/pushgateway:latest

8. 日志管理

查看容器日志

docker logs pushgateway

配置日志驱动

可通过 --log-driver 自定义日志驱动（默认使用 json-file）：

docker run -d \
  --name pushgateway \
  --log-driver=syslog \  # 使用 syslog 驱动
  bitnami/pushgateway:latest

9. 维护操作

升级镜像

步骤 1：拉取最新镜像

docker pull bitnami/pushgateway:latest

步骤 2：停止并备份当前容器

# 停止容器
docker stop pushgateway

# 备份数据（若挂载持久卷）
rsync -a /path/to/pushgateway-data /path/to/pushgateway-data.bkp.$(date +%Y%m%d-%H.%M.%S)

步骤 3：移除旧容器

docker rm -v pushgateway

步骤 4：启动新容器

docker run -d --name pushgateway bitnami/pushgateway:latest

10. 重要变更

2024 年 1 月 16 日起

• 移除 docker-compose.yaml 文件，该文件仅用于内部测试，生产环境推荐使用 Kubernetes 或自定义编排方案。

11. 重要注意事项：Bitnami 镜像目录即将变更

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

• 首次向社区用户开放安全优化版容器镜像
• 逐步弃用非加固的 Debian 基础镜像（免费 tier），并从公共目录中移除非最新标签，社区用户将只能访问有限的加固镜像（仅 latest 标签，用于开发目的）
• 2025 年 8 月 28 日起，所有现有容器镜像（包括历史版本标签，如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至 "Bitnami Legacy" 仓库（docker.io/bitnamilegacy），且不再接收更新
• 生产环境和长期支持建议采用 Bitnami Secure Images，包含加固容器、更小攻击面、CVE 透明度（通过 VEX/KEV）、SBOMs 及企业级支持

更多详情请参见 Bitnami Secure Images 公告。

12. Bitnami 安全镜像优势

• 企业级安全就绪：安全加固的镜像和 Helm 图表，使开源软件更安全、更适合企业环境
• 漏洞响应加速：通过 VEX、KEV 和 EPSS 评分提供 CVE 风险透明度，加速漏洞修复
• 最小化系统：基于 Photon Linux 的精简 OS，减少攻击面同时保持通过标准包格式的可扩展性
• 持续更新：上游补丁发布后数小时内更新镜像，保持安全合规
• 跨格式一致性：容器、虚拟机和云镜像使用相同组件和配置策略，便于跨格式迁移
• 完整安全元数据：提供 Notation 签名、SBOMs、病毒扫描报告等 SLSA-3 合规元数据

免费版仅提供部分应用，如需完整目录和企业支持，请尝试 Bitnami Secure Images 商业版。

13. 支持的标签

Bitnami 镜像采用滚动标签（如 latest）和固定版本标签（如 1.6.0）策略。详细标签说明及版本列表请参见：

• Bitnami 标签策略文档
• Docker Hub 标签列表

14. 贡献与问题反馈

• 提交贡献：通过 bitnami/containers GitHub 仓库提交 Pull Request
• 问题反馈：通过 GitHub Issues 提交问题，建议使用模板提供详细信息

15. 许可

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

本软件根据 Apache License 2.0 许可条款分发。您可在 <[***]> 获取许可副本。

除非适用法律要求或书面同意，软件按 "原样" 分发，不提供任何明示或暗示的保证或条件。