feat(ops): 目标知识库只读行级快照工具 + 发布前备份约定
发布链不做发布前备份(Prepare 只归档本包、previousRevision 首次为 absent), 门禁 PRODUCTION_BACKUP_RESTORE_VERIFIED 只是人工开关 —— 目标库覆盖前没有现场。 - scripts/target_kb_snapshot.sh:KB 维度只读导出(SELECT + \copy),输出 JSONL + MANIFEST.json(行数/字节/sha256/覆盖范围/ES 文档数)+ export.sql + README.md(恢复步骤)。支持指定或读取已绑定目标库,INCLUDE_CHUNKS=0 出小快照。 - 文档 P6 新增「发布前备份」:覆盖范围、边界(不含 ES/OSS 本体,整库级走 RDS PITR)、以及共享真实库发布/撤权/回滚前必跑快照并记入发布单的约定。
This commit is contained in:
@@ -276,6 +276,33 @@ WeKnora 的 wiki 图谱与页面同表(`wiki_pages`,节点/边靠 slug + `in
|
||||
- 已知取舍:降级路径上共享页的正文仍由目标库的库级合成结果决定,无法在不重算(不额外烧 token)的
|
||||
前提下与本包一致;这类页只做引用级差集,并在作用域日志里计入 `foreign_ref_stripped`。
|
||||
|
||||
### 发布前备份(2026-10-08 起)
|
||||
|
||||
发布链本身**不做**发布前备份:`DocumentTarget.Prepare` 只归档本包、解析 `previousRevision`
|
||||
(首次发布为 `absent`,此时回滚只能停用、无法恢复),`PRODUCTION_BACKUP_RESTORE_VERIFIED`
|
||||
只是"备份/恢复能力已验证"的人工开关。目标库现场必须显式留档:
|
||||
|
||||
```bash
|
||||
bash scripts/target_kb_snapshot.sh # 用 production_kb_bindings 里绑定的目标库
|
||||
bash scripts/target_kb_snapshot.sh <kb_id> [<kb_id>] # 指定目标库
|
||||
INCLUDE_CHUNKS=0 bash scripts/target_kb_snapshot.sh # 不导 chunks(快照很小,适合每次发布前)
|
||||
```
|
||||
|
||||
输出 `backups/target-kb-snapshots/<UTC>-<kb前8位>/`:KB 维度行级 JSONL(`to_jsonb(row)`,
|
||||
含软删行)+ `MANIFEST.json`(行数/字节/sha256/覆盖范围/ES 文档数)+ `export.sql`(原始查询)
|
||||
+ `README.md`(恢复步骤)。全过程只有 SELECT + `\copy`,不修改目标库;`backups/` 已在 .gitignore。
|
||||
|
||||
覆盖范围与边界:
|
||||
|
||||
- 覆盖:`knowledge_bases`、`knowledges`、`chunks`、`knowledge_tags`、`knowledge_tag_relations`、
|
||||
`resources`、`resource_bindings`、`wiki_pages`、`wiki_folders`(PG 行;不含表结构)。
|
||||
- 不覆盖:Elasticsearch 文档与向量、OSS 对象本体(`resources.jsonl` 只给路径/大小/哈希清单)、
|
||||
列出的知识库之外的行。整库级恢复用阿里云 RDS 快照/按时间点恢复(PITR),恢复到临时实例后按 KB 取行。
|
||||
|
||||
约定:对**共享真实知识库**发布、撤权、回滚前必须先跑一次快照,并把快照目录与
|
||||
`MANIFEST.json` 的 sha256 记进发布单;`previous_production_revision=absent` 时必须写明
|
||||
"无前版可回退,只有这份快照"。待办:把"快照存在"从人工约定做成发布前置硬门禁。
|
||||
|
||||
## Elasticsearch 通道
|
||||
|
||||
源导出:
|
||||
|
||||
Reference in New Issue
Block a user