Files
knowledge-governance/internal/appconfig/library_role_test.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

84 lines
3.1 KiB
Go

package appconfig
import "testing"
func TestParseLibraryWorkerRole(t *testing.T) {
cases := []struct {
raw string
want LibraryWorkerRole
release bool
source bool
wantFail bool
}{
{raw: "", want: LibraryWorkerRoleFull, release: true, source: true},
{raw: "full", want: LibraryWorkerRoleFull, release: true, source: true},
{raw: " release-executor ", want: LibraryWorkerRoleReleaseExecutor, release: true, source: false},
{raw: "capture", want: LibraryWorkerRoleCapture, release: false, source: true},
{raw: "release", wantFail: true},
{raw: "worker", wantFail: true},
}
for _, test := range cases {
got, err := parseLibraryWorkerRole(test.raw)
if test.wantFail {
if err == nil {
t.Fatalf("parseLibraryWorkerRole(%q) accepted an unknown role", test.raw)
}
continue
}
if err != nil {
t.Fatalf("parseLibraryWorkerRole(%q) error = %v", test.raw, err)
}
if got != test.want {
t.Fatalf("parseLibraryWorkerRole(%q) = %q, want %q", test.raw, got, test.want)
}
if got.ExecutesRelease() != test.release || got.ExecutesSourceWork() != test.source {
t.Fatalf("role %q release=%t source=%t, want release=%t source=%t",
got, got.ExecutesRelease(), got.ExecutesSourceWork(), test.release, test.source)
}
if got.ExecutesRelease() && got.ExecutesSourceWork() && got != LibraryWorkerRoleFull {
t.Fatalf("role %q claims both domains without being full", got)
}
}
}
// 非法角色必须让进程起不来:静默回到 full 会让两套执行器抢同一批 release 作业。
func TestLoadRejectsUnknownLibraryWorkerRole(t *testing.T) {
env := map[string]string{
"DATABASE_URL": "postgres://user:pass@127.0.0.1:5432/governance?sslmode=disable",
"LIBRARY_WORKER_ROLE": "release",
}
if _, err := Load(func(key string) string { return env[key] }); err == nil {
t.Fatal("Load() accepted LIBRARY_WORKER_ROLE=release")
}
env["LIBRARY_WORKER_ROLE"] = "release-executor"
config, err := Load(func(key string) string { return env[key] })
if err != nil {
t.Fatalf("Load() error = %v", err)
}
if !config.LibraryWorkerRole.ExecutesRelease() || config.LibraryWorkerRole.ExecutesSourceWork() {
t.Fatalf("release-executor role mapping is wrong: %#v", config.LibraryWorkerRole)
}
}
// 每个角色收拾哪些 kind、谁拥有 DDL,都必须互斥且覆盖完整。
func TestLibraryWorkerRoleOwnershipMaps(t *testing.T) {
release := LibraryWorkerRoleReleaseExecutor
if got := release.LibraryJobKinds(); len(got) != 4 || got[0] != "sync" || got[1] != "restore" || got[2] != "recover" || got[3] != "baseline" {
t.Fatalf("release-executor kinds = %v", got)
}
if got := LibraryWorkerRoleCapture.LibraryJobKinds(); len(got) != 1 || got[0] != "seal" {
t.Fatalf("capture kinds = %v", got)
}
if got := LibraryWorkerRoleFull.LibraryJobKinds(); len(got) != 5 {
t.Fatalf("full kinds = %v", got)
}
for _, role := range []LibraryWorkerRole{LibraryWorkerRoleFull, LibraryWorkerRoleCapture} {
if !role.ExecutesMigrations() {
t.Fatalf("role %q must own DDL", role)
}
}
if release.ExecutesMigrations() {
t.Fatal("release-executor must not own governance DDL")
}
}