G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的
docs/operations/backup-and-rollback.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# 备份与回滚
仓库脚本未形成经过验证的完整灾难恢复方案。生产或共享演示环境变更前至少保存:
- MySQL 一致性备份及恢复验证记录(命名卷
mysql-data) - Redis、Nacos、Kafka 所需的持久化数据或可重建说明
data/milvus/(向量数据、嵌入式 etcd、本地 WAL 与建表标记)data/g2rain-knowledge/(知识原文件与解析产物)data/docling-hf/或实际DOCLING_HF_CACHE(若依赖离线模型)- 当前
.env、Compose 片段、Nginx 与中间件配置的安全副本 - 当前镜像 digest 与组件版本标签
- 应用密钥与证书的安全备份及轮换计划;Nacos 内数据源/Redis 凭据必须与
.env一并备份
回滚应优先恢复已记录的镜像 digest 与配置,再按依赖顺序重建服务。数据库架构或数据发生不可逆迁移时,容器版本回退并不等同于系统回滚。
任何声称“可回滚”的发布,都应在非生产环境实际演练并记录恢复时间和数据一致性结果。