Files
knowledge-governance/internal/appconfig/library_role.go
T
姚章浩 e6472b0ec6 feat(library): 云测试发布目标接入的角色分离、快照搬运与图谱门禁
为什么改:发布执行链是"与目标同机"假设写死的(本机 docker.sock、本机 drain.json、
本机 Redis/PG),把目标换成云测试不能只改展示 URL;直接搬整套 worker 又会抢走
本机封存/QA/周报队列并按本机配置写错目标。所以先把"谁消费哪段队列"变成显式角色,
再补齐跨主机搬运与目标侧门禁。

角色(LIBRARY_WORKER_ROLE=full/release-executor/capture)不只影响 handler 列表,
还决定是否拥有 DDL(release-executor 只读校验迁移版本,落后即拒绝启动)、
收拾哪些 library_jobs.kind、是否跑 release 接管扫描、是否起 scheduler/QA/周报/探测。
capture 保留本机原有全部业务;release-executor 只挂 sync/restore/recover/baseline。

快照跨主机:新增内容寻址的 bundle(版本清单先落、blob 按 sha256 命名、清单最后
Link 作提交点),pack/unpack 幂等且拒绝覆盖与同名不同内容;执行器使用前仍逐 blob
重算 sha256,因此传输不可变有两道证据。

目标侧门禁:目标知识库 graph_enabled=true 时拒绝发布(发布只写 PG/ES/OSS,不写
Neo4j;未知也拒绝),只读检测、不改目标配置、不做图谱迁移。

云端入口:新增 drain 感知的 ingress 闸门(建连超时与读超时分离,半关闭单向传播,
SIGTERM 排空后写 drain.json 并 exit 0/2)、compose 叠加片段(app 不再发布端口、
frontend 与 adapter 的入口收敛到闸门、指向真实网络 weknora-test-v071-network)、
执行器启动脚本与治理 PG 反向隧道脚本(默认 unix socket,不占 TCP)。

验证:deploy/cloud-test/test_gate.py 13 项全 PASS(含 12 秒静默流、半关闭、2MiB 完整、
排空 exit 0/active_at_close=1、排空超时 exit 2、上游不可达不挂住);go test 相关包全绿;
scripts/ci_checks.py 16 项全部 success(EXIT=0,1241 用例通过/0 失败/191 已声明可选集成跳过);
云测试只读预检 17 项 / 6 FAIL,FAIL 项即当前部署缺口(无闸门、app 仍发布端口、
adapter 与 frontend 仍直连 app、云端归档根未建),未部署、未改云端任何状态。
2026-10-30 18:38:38 +08:00

85 lines
3.8 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package appconfig
import (
"fmt"
"strings"
"knowledge-governance/internal/governance"
)
// LibraryWorkerRole 是这个进程在整库发布链上的角色(LIBRARY_WORKER_ROLE)。
//
// 为什么要有显式角色,而不是"配了目标就算这个进程能发布":一条 release 作业
// 只带 scope 与快照 ID,**目标实例来自本进程的部署配置**(LIBRARY_TARGET_* /
// LIBRARY_PRODUCTION_*)。两个执行器同时消费同一队列时,谁抢到就按谁自己的
// 配置执行——本机执行器会把"发往云测试"的作业按本机 kgseal 的维护窗口去停本机
// 容器、往本机目标写。这不是权限问题,是身份问题,只能靠"谁消费哪段队列"
// 在启动时定死。
type LibraryWorkerRole string
const (
// LibraryWorkerRoleFull 是历史行为:本进程消费全部队列(单机部署)。
LibraryWorkerRoleFull LibraryWorkerRole = "full"
// LibraryWorkerRoleReleaseExecutor 只消费整库发布(sync / restore / recover /
// baseline)与它们的接管扫描。不起 scheduler、不接封存 agent、不消费 QA/测试/
// 目录刷新等作业:那些队列归本机那个源侧执行器。
LibraryWorkerRoleReleaseExecutor LibraryWorkerRole = "release-executor"
// LibraryWorkerRoleCapture 消费除整库发布以外的全部队列(封存、QA、测试、
// 目录刷新…),并且**不接管** release 作业。与 release-executor 互斥。
LibraryWorkerRoleCapture LibraryWorkerRole = "capture"
)
func parseLibraryWorkerRole(raw string) (LibraryWorkerRole, error) {
value := LibraryWorkerRole(strings.TrimSpace(raw))
switch value {
case "":
return LibraryWorkerRoleFull, nil
case LibraryWorkerRoleFull, LibraryWorkerRoleReleaseExecutor, LibraryWorkerRoleCapture:
return value, nil
default:
return "", fmt.Errorf("LIBRARY_WORKER_ROLE 只能是 full/release-executor/capture,当前是 %q", string(value))
}
}
func (r LibraryWorkerRole) String() string {
if r == "" {
return string(LibraryWorkerRoleFull)
}
return string(r)
}
// ExecutesRelease:本进程注册整库发布 handler,并接管中断的发布作业。
func (r LibraryWorkerRole) ExecutesRelease() bool {
return r == "" || r == LibraryWorkerRoleFull || r == LibraryWorkerRoleReleaseExecutor
}
// ExecutesSourceWork:本进程注册封存/QA/测试/目录刷新等非发布队列,并起后台调度。
func (r LibraryWorkerRole) ExecutesSourceWork() bool {
return r == "" || r == LibraryWorkerRoleFull || r == LibraryWorkerRoleCapture
}
// ExecutesMigrations:只有控制面所在的那个进程才做 DDL。
//
// 发布执行器是"目标旁边的一个消费者",不是控制面:让它去改治理库 schema,
// 等于把"谁有权决定治理库结构"扩散到第二台机器。云侧只读校验版本,落后就拒绝启动。
func (r LibraryWorkerRole) ExecutesMigrations() bool {
return r == "" || r == LibraryWorkerRoleFull || r == LibraryWorkerRoleCapture
}
// LibraryJobKinds 是这个角色负责收拾孤儿/接管的 library_jobs.kind。
// 分开是因为"收拾"会写终态和恢复责任文案:seal 的恢复责任在封存 agent,
// release 的恢复责任在目标与预备份,混着写会把责任指错人。
func (r LibraryWorkerRole) LibraryJobKinds() []string {
switch r {
case LibraryWorkerRoleReleaseExecutor:
return []string{string(governance.LibraryJobSync), string(governance.LibraryJobRestore),
string(governance.LibraryJobRecover), string(governance.LibraryJobBaseline)}
case LibraryWorkerRoleCapture:
return []string{string(governance.LibraryJobSeal)}
default:
return []string{string(governance.LibraryJobSeal), string(governance.LibraryJobSync),
string(governance.LibraryJobRestore), string(governance.LibraryJobRecover),
string(governance.LibraryJobBaseline)}
}
}