Skip to content

备份与恢复 ​

完整备份包含 MySQL 数据、内置 MinIO 对象、仍被数据库引用的外部 OSS 文件和实例密钥。备份文件含敏感信息,请至少保留一份在部署机器之外。升级脚本会自动创建备份;日常也可手动备份。

以下命令在实际安装目录执行;默认先运行 cd ~/cuecast。

创建备份 ​

bash
./scripts/backup.sh

脚本会短暂停止前后端写入,完成后恢复服务。备份默认保存到安装目录的 backups/,脚本会输出文件路径。若不能暂停服务,可使用 ./scripts/backup.sh --online,但数据库与对象文件可能不在同一时间点,不适合作为可靠的升级前备份。

使用过外部 OSS 时,即使当前已切回 MinIO,备份仍会读取历史记录引用的 OSS 文件。请保留所有历史 Bucket 的读取权限和网络连接;任何引用文件无法读取时,脚本会报错,不会生成成功的完整备份。数据库和实例密钥共同保存加密的存储凭据;请与对象文件一起保管。

恢复备份 ​

恢复会覆盖当前数据库、内置 MinIO 对象和实例密钥,并写回备份中引用的外部 OSS 对象。 确认备份来自正确实例,并先保存需要保留的当前数据:

bash
./scripts/restore.sh --backup backups/cuecast-backup-YYYYmmdd-HHMMSS.tar.gz

将示例文件名替换为实际备份。脚本会要求确认、校验文件并检查服务。恢复的是备份中的业务数据;当前镜像版本、访问地址和基础设施密码保持不变。完成后检查登录、历史用例和附件;需要进一步排障时运行 ./scripts/verify.sh。

若要回退含数据库迁移的升级,请使用与目标版本匹配的安装包和完整备份,不能只切换旧镜像。

外部 OSS 恢复使用备份中的存储配置和凭据,需要对应服务可访问且具有写入权限。脚本只写回清单中的对象,不清空外部 Bucket;同名对象会被覆盖。恢复失败时请修复权限或连接后重试,不能将该次运行视为成功。完整备份不包含外部 Bucket 中未被数据库引用的其他文件,建议另行开启云端备份或版本管理。

回演 CueCast 产品文档