victoriametrics/vmrestore

vmrestore

!VictoriaMetrics Logo

![加入SLACK社区]([***]

镜像概述和主要用途

vmrestore 是一款命令行工具，用于管理 VictoriaMetrics 数据的生命周期。它能够从存储系统下载备份数据，并将其恢复到 VictoriaMetrics 的数据目录中，是 VictoriaMetrics 数据备份恢复流程的关键组件。

核心功能和特性

• 多存储方案支持：支持从本地文件系统（fs）、Google Cloud Storage（gcs）、Amazon S3（s3）及 Azure Blob Storage（azblob）等多种存储源恢复备份
• 命令行配置：通过命令行标志灵活配置恢复参数
• 轻量高效：专注于数据恢复功能，操作简洁，资源占用低

使用场景和适用范围

• 数据恢复：当 VictoriaMetrics 数据丢失或损坏时，从备份恢复数据
• 数据迁移：将备份数据迁移到新的 VictoriaMetrics 实例或环境
• 环境重建：在新部署的 VictoriaMetrics 环境中恢复历史数据

注意：执行恢复操作前，需确保目标 VictoriaMetrics 服务已停止，避免数据冲突。

使用方法和配置说明

Docker 拉取命令

bash
docker pull victoriametrics/vmrestore:{TAG}

其中 {TAG} 为具体版本标签，可从 https://github.com/VictoriaMetrics/VictoriaMetrics/releases 获取。

从备份恢复数据

基本步骤

1. 停止目标 VictoriaMetrics 服务
2. 执行以下命令恢复数据：

bash
docker run --rm \
  -v /本地备份路径:/backups \  # 挂载本地备份目录到容器内/backups
  -v /目标vm数据目录:/restore \  # 挂载目标VictoriaMetrics数据目录到容器内/restore
  victoriametrics/vmrestore:latest \
  -src=fs:///backups/<备份名称> \  # 指定备份源路径
  -dst=/restore  # 指定恢复目标目录

参数说明

• -v /本地备份路径:/backups：将本地存储备份文件的目录挂载到容器内的 /backups 路径，确保容器可访问备份文件
• -v /目标vm数据目录:/restore：将目标 VictoriaMetrics 的数据目录挂载到容器内的 /restore 路径，恢复后的数据将写入此目录
• -src：备份源路径，格式为 <存储方案>://<路径>，例如 s3://my-bucket/backups/vm-20240101
• -dst：恢复目标目录，需对应容器内挂载的 VictoriaMetrics 数据目录（如示例中的 /restore）

配置参数

vmrestore 通过命令行标志进行配置，核心参数如下：

执行 docker run --rm victoriametrics/vmrestore:latest --help 获取完整参数列表及说明。

获取帮助

• Slack 社区：加入 Slack 社区，参与讨论和获取实时支持
• GitHub Discussions：https://github.com/VictoriaMetrics/VictoriaMetrics/discussions
• Bug 报告：如发现问题，可在 https://github.com/VictoriaMetrics/VictoriaMetrics/issues 提交报告

源代码

vmrestore 是开源项目，源代码托管于 GitHub：

• https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/app/vmrestore

更多详情可参考 官方文档。配套备份工具 https://hub.docker.com/r/victoriametrics/vmbackup 可用于创建备份。