1. 文档说明

本文说明石墨私有化环境的数据备份范围、恢复要求、执行方式与恢复后验证项。

本文覆盖以下内容：

备份范围与责任边界

数据库备份与恢复要求

对象存储备份与恢复要求

恢复执行前确认项

恢复完成后的验证项

本文不覆盖以下内容：

首次安装部署步骤

升级迁移方案

第三方中间件厂商专属恢复工具说明

生产事故处置流程

2. 备份范围与责任边界

2.1 备份范围

石墨私有化环境中需要纳入备份范围的数据包括：

MySQL 数据

MongoDB 数据

Redis 数据

对象存储数据

安装配置与环境参数文件

数据目录、备份目录、备份保留周期由客户侧统一管理。

2.2 责任边界

备份与恢复责任边界如下：

客户侧负责制定并执行正式备份策略

客户侧负责备份文件保管、介质安全与保留周期管理

客户侧负责恢复演练、恢复审批与恢复结果验收

石墨可提供技术支持与恢复操作指导

涉及外部中间件、自建对象存储或客户自维护基础设施时，备份与恢复策略由客户侧统一承担。

3. 恢复执行前确认

数据恢复属于高风险操作。执行前必须完成以下确认。

3.1 目标确认

恢复前明确以下信息：

目标环境

目标集群、节点、命名空间

恢复数据范围

恢复时间点

执行窗口

3.2 风险确认

恢复前确认以下事项：

本次恢复是否覆盖当前在线数据

本次恢复是否需要停机

当前在线数据是否已追加一次最新备份

恢复失败后的回退时间点是否已明确

3.3 备份有效性确认

恢复前核对以下内容：

备份文件完整可读

备份时间点满足恢复目标

备份目录挂载正确

恢复所需配置文件齐全

备份文件已完成可恢复性验证

4. 备份策略

4.1 数据库备份

数据库备份口径如下：

场景	执行方式	频率	保留周期	说明
使用石墨内置中间件	系统定时备份	每天 1 次	7 天	由集群内定时任务执行
使用客户自维护中间件	客户侧备份	每天 1 次及以上	7 天及以上	按客户制度执行

数据库备份至少覆盖：

MySQL

MongoDB

Redis

4.2 对象存储备份

对象存储备份口径如下：

数据类型	执行方式	频率	保留周期	说明
对象存储业务数据	冷备份或灾备复制	按业务等级执行	按客户制度执行	覆盖文档附件与文件对象
对象存储配置数据	配置备份	变更后同步备份	按客户制度执行	覆盖访问参数与挂载信息

对象存储多副本属于冗余机制，不等同于备份。

4.3 配置文件备份

以下配置纳入备份范围：

安装参数

域名与协议配置

外部依赖地址与端口信息

对象存储访问信息

业务相关配置文件

5. 数据库恢复

本节适用于 MySQL、MongoDB、Redis 数据恢复。

5.1 恢复前准备

执行数据库恢复前完成以下准备：

在目标节点准备恢复目录，例如 /data/restore

将待恢复数据放入恢复目录

核对 global_config.json 与当前环境一致

核对恢复节点、恢复时间点、执行窗口与审批信息

5.2 备份任务检查

检查数据库定时备份任务：

kubectl get cronjob

同时记录以下信息：

CronJob 名称

5.3 恢复执行

数据库恢复通过一次性 Job 执行，恢复脚本位于备份镜像中。

执行步骤如下：

准备恢复任务清单 db-restore.yaml

修改 spec.template.spec.nodeName 为恢复目录所在节点

修改 hostPath.path 为恢复数据所在目录

执行 kubectl apply -f db-restore.yaml

示例清单如下：

5.4 执行说明

数据库恢复任务执行后会回滚以下数据：

MySQL

MongoDB

Redis

恢复期间业务数据可能发生覆盖，执行前完成停机安排与数据确认。

6. 对象存储恢复

本节适用于 MinIO 及兼容 S3 协议的对象存储恢复。

6.1 备份方式

对象存储常用备份方式如下：

方式	适用场景	说明
Rsync 同步复制	单机环境	适用于目录级冷备份
磁盘快照	单机环境	适用于同存储平台快速恢复
`mc mirror`	单机或集群环境	适用于对象数据冷备份与恢复
Site Replication / Bucket Replication	集群环境	适用于灾备复制

6.2 恢复执行

单机环境常用恢复方式如下：

使用 Rsync 备份时，执行反向同步恢复数据目录

rsync -av backup:/data/minio/ /data/minio/

使用 mc mirror 备份时，执行反向镜像恢复

mc mirror backup-minio/ new-minio/

集群环境恢复口径如下：

存在灾备副本时，按主备切换方案执行恢复

使用冷备份时，按对象存储数据目录或镜像仓内容执行恢复

6.3 执行说明

对象存储恢复前需确认以下事项：

恢复目标桶范围

恢复时间点

是否覆盖在线对象

目标存储路径与权限配置

恢复后访问域名与网关配置

7. 恢复后验证

恢复完成后至少验证以下内容：

数据库服务状态正常

对象存储服务状态正常

管理后台可访问

用户登录正常

核心文档创建、编辑、保存、导入、导出正常

恢复数据时间点与预期一致

恢复完成后记录以下信息：

恢复执行时间

恢复数据时间点

执行人、审批人、验收人

恢复后发现的问题

数据备份机制

1. 文档说明#

2. 备份范围与责任边界#

2.1 备份范围#

2.2 责任边界#

3. 恢复执行前确认#

3.1 目标确认#

3.2 风险确认#

3.3 备份有效性确认#

4. 备份策略#

4.1 数据库备份#

4.2 对象存储备份#

4.3 配置文件备份#

5. 数据库恢复#

5.1 恢复前准备#

5.2 备份任务检查#

5.3 恢复执行#

5.4 执行说明#

6. 对象存储恢复#

6.1 备份方式#

6.2 恢复执行#

6.3 执行说明#

7. 恢复后验证#