Bitnami VictoriaMetrics Alert 镜像文档

1. 镜像概述和主要用途

VictoriaMetrics是一款快速、经济高效且可扩展的监控解决方案及时序数据库，兼容Prometheus和Graphite。Bitnami VictoriaMetrics Alert镜像为VictoriaMetrics的告警组件（vmalert）提供打包部署，用于在监控系统中定义、评估告警规则并触发通知。该镜像基于Bitnami Secure Images标准构建，聚焦安全性与可维护性。

2. 核心功能和特性

2.1 VictoriaMetrics Alert 核心功能

• 兼容Prometheus告警规则格式，支持无缝集成现有监控生态。
• 提供告警规则评估与触发机制，支持多渠道通知（需配置通知端点）。
• 与VictoriaMetrics时序数据库深度集成，高效处理监控数据告警逻辑。

2.2 Bitnami 镜像特性

• 安全加固：基于Photon Linux最小化操作系统，减少攻击面；通过SLSA-3合规流程构建，包含签名验证（Notation）和病毒扫描报告。
• 漏洞透明管理：提供VEX/KEV标准漏洞披露、EPSS风险评分及SBOMs（软件物料清单）。
• 持续更新：上游安全补丁发布后数小时内完成镜像更新，保障组件安全性。
• 跨环境一致性：与Bitnami虚拟机、云镜像使用统一配置策略，支持多部署格式切换。

3. 使用场景和适用范围

• 监控告警配置：适用于基于VictoriaMetrics或Prometheus的监控系统，需实现自定义告警规则的场景。
• 开发环境：免费版latest标签镜像适用于开发、测试及演示环境。
• 生产环境：需采用Bitnami Secure Images商业版，以获取企业级支持、长期更新及合规保障（如CVE修复、技术支持）。
• Prometheus生态集成：可与Prometheus Alertmanager、Grafana等工具联动，构建完整监控告警链路。

4. 获取镜像

4.1 拉取预构建镜像

推荐从Docker Hub拉取最新版：

docker pull bitnami/victoriametrics-vmalert:latest

指定版本标签（注意：2025年8月28日后，旧版本标签将迁移至bitnamilegacy仓库）：

docker pull bitnami/victoriametrics-vmalert:[TAG]  # 例如：2.50.0

4.2 源码构建

如需自定义构建，可克隆仓库并执行构建命令：

git clone [***]
cd containers/bitnami/victoriametrics-vmalert/[VERSION]/[OS]  # 替换VERSION和OS（如1.91.0/linux）
docker build -t bitnami/victoriametrics-vmalert:latest .

5. 部署与使用方法

5.1 快速启动（TL;DR）

docker run --name victoriametrics-vmalert bitnami/victoriametrics-vmalert:latest

5.2 Docker Compose 部署示例

创建docker-compose.yml文件：

version: '3.8'
services:
  vmalert:
    image: bitnami/victoriametrics-vmalert:latest
    container_name: victoriametrics-vmalert
    command:
      - --datasource.url=[***]  # 连接VictoriaMetrics数据库地址
      - --rule=/etc/vmalert/rules.yml                 # 挂载告警规则文件（需通过volume映射）
    volumes:
      - ./rules:/etc/vmalert  # 本地规则目录映射至容器
    restart: unless-stopped

启动服务：

docker-compose up -d

5.3 配置参数

通过命令行参数配置vmalert，常用参数包括：

• --datasource.url：指定VictoriaMetrics或Prometheus数据源地址（必填）。
• --rule：告警规则文件路径（支持本地文件或HTTP URL）。
• --notifier.url：告警通知端点地址（如Alertmanager）。
• --web.listen-address：服务监听地址（默认:8880）。

示例：查看完整参数列表

docker run --rm bitnami/victoriametrics-vmalert:latest -- --help

6. 重要注意事项（2025年8月28日起生效）

6.1 镜像仓库变更

• 原docker.io/bitnami仓库的旧版本标签（如2.50.0、10.6）将迁移至docker.io/bitnamilegacy仓库，且不再更新。
• docker.io/bitnami仅保留latest标签的安全加固镜像，供开发使用。

6.2 环境适配建议

• 开发环境：使用免费版latest标签镜像，仅保障基础功能，无长期支持。
• 生产环境：需订阅Bitnami Secure Images商业版，获取企业级支持、CVE修复及合规保障。

7. 支持的标签

• latest：最新安全加固版本，仅适用于开发环境。
• 历史版本标签（如2.50.0）：2025年8月28日后迁移至bitnamilegacy仓库，不再维护。

标签策略详情参见Bitnami标签文档。

8. 许可证

Copyright © 2025 Broadcom. 术语“Broadcom”指Broadcom Inc.及其子公司。

本软件根据Apache License 2.0许可分发。您可在<[***]>获取许可证副本。除非适用法律要求或书面同意，软件按“原样”分发，不附带任何明示或暗示担保。