feat(release): 发布前快照硬门禁 + 云内快照 + ES/OSS 保护
按生产级备份组合落地:
- internal/releasesnapshot:新增门禁包,要求 root 下存在覆盖目标库、未过期
(默认 24h)、含 wiki_pages.jsonl 与 sha256 的快照;本地文件再校验哈希。
7 条单测(过期/换库/篡改/缺页/未接线/半成品)。
- 发布器:写目标库之前(Publish/Delete/Rollback 三条路)先过门禁;映射目标
(源库→目标库,共享真实库)或 policy=always 时必须有快照;门禁未接线
同样拒绝(fail-closed)。新错误码 release_target_snapshot_missing(不可重试)
+ 页面中文提示。6 条发布器单测。
- worker 配置新增 target_snapshot{root,max_age_hours,policy},校验 policy/
max_age/绝对路径;compose.release-sim.yaml 只读挂载快照目录。
- scripts/target_kb_snapshot.sh:默认云内执行(与 DB 同 VPC,凭据取自 WeKnora
容器)+ 默认不导 chunks(44s 出 8 张表);修复 \copy 不能跨行/不能带 WITH、
ES 计数改用 knowledge_base_id.keyword。
- ES:注册 kb_backup 仓库(path.repo),首个快照 36s/4.7GB/0 分片失败,
SLM kb-hourly(3d)+kb-daily(7d) 已建并执行成功。
- OSS:目标桶开启版本控制(此前未开启)。
- 文档 P6 增补硬门禁与云内执行;真实快照目录上门禁实测:两个绑定库通过、
未覆盖库拒绝、未接线拒绝。
This commit is contained in:
@@ -301,7 +301,33 @@ INCLUDE_CHUNKS=0 bash scripts/target_kb_snapshot.sh # 不导 chunks(快照
|
||||
|
||||
约定:对**共享真实知识库**发布、撤权、回滚前必须先跑一次快照,并把快照目录与
|
||||
`MANIFEST.json` 的 sha256 记进发布单;`previous_production_revision=absent` 时必须写明
|
||||
"无前版可回退,只有这份快照"。待办:把"快照存在"从人工约定做成发布前置硬门禁。
|
||||
"无前版可回退,只有这份快照"。
|
||||
|
||||
#### 硬门禁(写目标库之前)
|
||||
|
||||
"必须有快照"已从人工约定升级为**发布前置硬门禁**(`internal/releasesnapshot`):
|
||||
|
||||
- Worker 配置新增:
|
||||
|
||||
```json
|
||||
"target_snapshot": {
|
||||
"root": "/var/lib/knowledge-governance/target-kb-snapshots",
|
||||
"max_age_hours": 24,
|
||||
"policy": "mapped"
|
||||
}
|
||||
```
|
||||
|
||||
`root` 由 `compose.release-sim.yaml` 以只读方式挂载快照目录;`policy=mapped`(默认)
|
||||
只对**源库 → 目标库**映射的项强制(同 ID 目标的本地演练不受影响),`always` 则一律强制,
|
||||
且此时 `root` 缺失直接判定配置非法。
|
||||
- `Publish` / `Delete` / `Rollback` 在**任何写目标库的动作之前**检查:存在覆盖目标库、
|
||||
未过期(`max_age_hours`,默认 24h)、且含 `wiki_pages.jsonl` 及其 sha256 的快照;
|
||||
本地文件会再按哈希校验一次("可恢复"的最低证明)。任一条不满足——
|
||||
**包括门禁本身未接线**——都以 `release_target_snapshot_missing`(不可重试)拒绝发布,
|
||||
且不触碰目标库一行。页面把该码显示为"缺少目标知识库的发布前快照留档,已拒绝发布"。
|
||||
- 云内执行:`bash scripts/target_kb_snapshot.sh` 默认在与 DB 同 VPC 的云主机上跑
|
||||
(凭据取自已部署的 WeKnora 容器,不经家用带宽),实测 **44 秒**产出 8 张表 + 清单;
|
||||
隧道模式保留为 `EXECUTION=tunnel` 兜底。
|
||||
|
||||
## Elasticsearch 通道
|
||||
|
||||
|
||||
Reference in New Issue
Block a user