corehelpers/azurebackup

Azure存储表备份恢复容器

镜像概述

本Docker镜像提供了一个简易解决方案，用于实现Azure存储表的备份和恢复操作。该镜像基于清单文件驱动，支持在单个清单中定义多个备份或恢复任务，适用于Azure存储表的数据保护和迁移需求。

核心功能与特性

• 支持Azure存储表的备份和恢复两种核心操作
• 基于JSON格式的清单文件进行任务配置，可同时定义多个任务
• 备份操作支持通过正则表达式排除特定表
• 提供可选的完成钩子（FinishedHook）用于监控备份任务状态
• 轻量级预编译容器，无需额外依赖即可运行

使用场景

• Azure存储表的定期数据备份
• 从备份数据恢复受损或误删的Azure存储表
• 跨Azure存储账户或环境的表数据迁移
• 自动化数据保护流程集成

使用方法

执行表备份

1. 创建备份清单文件

创建JSON格式的清单文件，定义备份任务：

json
{
    "Id": "<<uuid>>",
    "Items": [
        {
            "Id": "<<uuid>>",          // 任务唯一标识符
            "Name": "<<显示名称>>",    // 任务显示名称
            "Enabled": true,           // 是否启用该任务
            "Operation": "backup",     // 操作类型：backup
            "StorageType": "table",    // 存储类型：table
            "TargetConnectionString": "<<存储备份的连接字符串>>",  // 备份存储连接字符串
            "TargetContainer": "<<存储备份的容器>>",              // 备份存储容器名称
            "SourceConnectionString": "<<读取数据的源连接字符串>>", // 源数据连接字符串
            "Excludes": [
                "<<排除表的正则表达式>>"  // 可选，排除表的正则表达式列表
            ],
            "FinishedHook": "<<可选的监控完成钩子>>"  // 可选，任务完成后调用的钩子URL
        }
    ]
}

2. 运行备份容器

bash
docker run \
-e MANIFEST={{清单文件路径或URL}} \
docker.xuanyuan.run/corehelpers/azurebackup:<<版本>>

执行表恢复

1. 创建恢复清单文件

创建JSON格式的清单文件，定义恢复任务：

json
{
    "Id": "<<uuid>>",
    "Items": [
        {
            "Id": "<<uuid>>",          // 任务唯一标识符
            "Name": "<<显示名称>>",    // 任务显示名称
            "Enabled": true,           // 是否启用该任务
            "Operation": "restore",    // 操作类型：restore
            "StorageType": "table",    // 存储类型：table
            "SourceConnectionString": "<<存储备份的连接字符串>>",  // 备份存储连接字符串
            "SourceContainer": "<<备份所在的容器>>",              // 备份所在容器名称
            "TargetConnectionString": "<<恢复数据的目标连接字符串>>" // 恢复目标连接字符串
        }
    ]
}

2. 运行恢复容器

bash
docker run \
-e MANIFEST={{清单文件路径或URL}} \
docker.xuanyuan.run/corehelpers/azurebackup:<<版本>>

手动构建容器

步骤1：发布runner到专用目录

bash
dotnet publish ./backup.runner/ -c Release -o ../publish/runner

步骤2：构建Docker容器

bash
docker build -t corehelpers/azurebackup:manual -f ./Dockerfile ./publish/runner