bitnami/pushgateway Docker Image Overview

bitnami/pushgateway

自动构建

Bitnami安全镜像，用于部署Prometheus推送网关（pushgateway），支持短暂运行服务或批处理作业向Prometheus推送指标，具备安全加固特性。

1 收藏0 次下载activebitnami镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

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. 快速开始

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

5. 获取镜像

推荐方式：从 Docker Hub 拉取

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

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

手动构建镜像

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

6. 使用方法

基本运行配置

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

容器网络配置

步骤 1：创建自定义网络

console
docker network create pushgateway-network --driver bridge

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

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

步骤 3：连接其他容器

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

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

7. 配置说明

Prometheus 集成配置

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

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

环境变量配置

环境变量	说明	可选值	默认值
`OPENSSL_FIPS`	是否启用 FIPS 模式	`yes` / `no`	`yes`

FIPS 模式配置示例

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

8. 日志管理

查看容器日志

console
docker logs pushgateway

配置日志驱动

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

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

9. 维护操作

升级镜像

步骤 1：拉取最新镜像

console
docker pull bitnami/pushgateway:latest

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

console
# 停止容器
docker stop pushgateway

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

步骤 3：移除旧容器

console
docker rm -v pushgateway

步骤 4：启动新容器

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