此为预览文档，正式版本尚未发布。
Docker 备份
安排维护窗口，先停止四个应用组件，保留数据库运行：workspaces、artifacts 命名卷制作快照，保存 .env，并记录 SERVICE_VERSION、镜像 digest 和快照时间。备份目录应位于安装目录之外的受保护持久存储中。确认数据库备份与文件快照属于同一维护窗口后再启动应用。
升级
阅读新版本的迁移与兼容性说明，先在测试数据库副本上演练。完成备份后，Docker 修改.env 中的 SERVICE_VERSION，拉取镜像并重建容器；Helm 使用指定版本的 Chart 执行 upgrade。
Go 在启动时执行产品与运行状态迁移，Java 当前通过 Hibernate 更新表结构。组件镜像回退不保证旧版本可以读取新 schema。
恢复
需要回退数据时，先停止应用写入。在独立空数据库中恢复备份，恢复同一批 Workspace / Artifact 快照与原 Vault 密钥，再用备份对应的组件版本启动。不要把pg_restore --clean 指向仍在使用的业务数据库。
对新建的恢复数据库执行示例：
.env 设置 POSTGRES_DB 为恢复库名称，并使用原密钥和同批文件快照启动。数据库容器只在数据目录为空时初始化数据库；已有实例中的恢复库需要预先创建。
恢复验收
检查管理员登录、已有 Agent 与 Session 历史、Workspace 文件、Vault 凭据解密、运行时连接，以及一项新的小任务。Task/Issue 的验收状态应与备份时刻相符。 只有数据库、文件和密钥都能共同恢复，备份才算通过验证。升级按维护窗口执行；单副本安装不提供多副本 HA 或无停机升级保证。恢复后重新开放服务
先保持定时规则和外部入口受控，在测试工作上验证登录、历史、文件和凭据。确认 Runtime Host 重新上线，再逐个恢复计划触发与业务流量。数据库快照恢复不会撤销备份之后已经发出的消息或外部写入；对照业务系统核对幂等记录和未完成工作后再重跑。用固定案例做升级回归
在升级前保存售前方案团队的样例知识与验收结果，在隔离的恢复环境中执行同一组问题。模型措辞可以不同，下面的事实和持久化结果应可核对：
记录升级前后版本、备份批次、用例输入、执行 ID 和差异。只在需要对应集成时验证其凭据可用性；知识读取案例本身没有外部凭据，不能证明 Vault 解密路径也已验证。