Files
knowledge-governance/cmd/worker/library_capture_identity_test.go
T
姚章浩 47eb23cf68 feat(library): 封存执行器可用性与还原条件来自真实观测
页面上的"可发起封存"原来只判 LIBRARY_AGENT_SOCKET 非空:正式栈的 API 根本没挂
那个 socket,而 agent 曾顶着正式单元名冻结候选实例——配置非空、页面可点、真发起
却封错库。

现在:agent 新增 health 动作(不占封存操作锁、不跑子进程,只回答身份/降级/忙),
worker 每 30 秒探测并写入迁移 074 的 library_executor_status;overview、快照列表与
POST /library/captures 共用同一份判定(过期、不可达、实例不符、降级、正忙都拒绝并
给原因)。封存结果由 agent 附上自报身份,worker 在停写入者之前再探测一次、执行后
用结果复核,不一致就不登记测试封存——心跳只能证明"刚才"。

期望身份用 LIBRARY_SOURCE_*(封存源),不是 LIBRARY_TARGET_*(同步目标),否则
正确的执行器会被判成不匹配。另加 GET /library/restore-availability:恢复能否执行由
双闸、该快照的恢复授权与实例维护状态决定,页面不再写死 disabled。

真跑(候选隔离栈,两处 socket 隔离不变):overview 返回 executor
{kgmaint-weknora/kgmaint-app};停 agent 后转不可达并 503 带原因;重启后恢复。
2026-10-29 13:01:37 +08:00

99 lines
3.6 KiB
Go

package main
import (
"context"
"encoding/json"
"net"
"os"
"path/filepath"
"strings"
"testing"
"time"
"knowledge-governance/internal/libraryagent"
)
func shortDir(t *testing.T) string {
t.Helper()
// unix socket 路径有长度上限,测试目录要短。
dir, err := os.MkdirTemp("/tmp", "kgcap-")
if err != nil {
t.Fatal(err)
}
t.Cleanup(func() { os.RemoveAll(dir) })
return dir
}
func fakeAgent(t *testing.T, payload map[string]any) string {
t.Helper()
socket := filepath.Join(shortDir(t), "agent.sock")
listener, err := net.Listen("unix", socket)
if err != nil {
t.Fatal(err)
}
t.Cleanup(func() { listener.Close() })
go func() {
for {
conn, acceptErr := listener.Accept()
if acceptErr != nil {
return
}
var request map[string]any
_ = json.NewDecoder(conn).Decode(&request)
body, _ := json.Marshal(payload)
_ = json.NewEncoder(conn).Encode(map[string]any{"ok": true, "action": "health", "payload": json.RawMessage(body)})
conn.Close()
}
}()
return socket
}
// 心跳说"可用"不等于执行时还是那个实例:执行前的探测必须能挡住换过的 socket。
func TestCaptureExecutorPrecheckRejectsAWrongInstance(t *testing.T) {
socket := fakeAgent(t, map[string]any{"project": "weknora071full", "source_app": "WKNFull-app"})
client := libraryagent.ClientConfig{Socket: socket, Timeout: 2 * time.Second}
err := captureExecutorPrecheck(context.Background(), client, "kgmaint-weknora", 2*time.Second)
if err == nil || !strings.Contains(err.Error(), "指向的实例不匹配") {
t.Fatalf("err = %v", err)
}
if !strings.Contains(err.Error(), "weknora071full") {
t.Fatalf("err should name the actual agent project: %v", err)
}
}
func TestCaptureExecutorPrecheckAcceptsTheExpectedInstance(t *testing.T) {
socket := fakeAgent(t, map[string]any{"project": "kgmaint-weknora", "source_app": "kgmaint-app"})
client := libraryagent.ClientConfig{Socket: socket, Timeout: 2 * time.Second}
if err := captureExecutorPrecheck(context.Background(), client, "kgmaint-weknora", 2*time.Second); err != nil {
t.Fatal(err)
}
// 没有期望身份就不许停写入者:那不是"跳过检查",是不能动生产。
if err := captureExecutorPrecheck(context.Background(), client, "", 2*time.Second); err == nil ||
!strings.Contains(err.Error(), "LIBRARY_SOURCE_PROJECT") {
t.Fatalf("empty expectation accepted: %v", err)
}
// 降级同样挡住。
degraded := fakeAgent(t, map[string]any{"project": "kgmaint-weknora", "degraded": "写入者恢复失败"})
if err := captureExecutorPrecheck(context.Background(), libraryagent.ClientConfig{Socket: degraded, Timeout: 2 * time.Second},
"kgmaint-weknora", 2*time.Second); err == nil || !strings.Contains(err.Error(), "降级") {
t.Fatalf("degraded executor accepted: %v", err)
}
}
// 执行后复核:结果里自报的身份不符,这次封存就不能被登记成测试封存。
func TestCaptureExecutorPostcheckUsesTheIdentityInTheResult(t *testing.T) {
good := json.RawMessage(`{"snapshot_id":"abc","agent_identity":{"project":"kgmaint-weknora"}}`)
if err := captureExecutorPostcheck(good, "kgmaint-weknora"); err != nil {
t.Fatalf("matching identity rejected: %v", err)
}
swapped := json.RawMessage(`{"snapshot_id":"abc","agent_identity":{"project":"weknora071full"}}`)
err := captureExecutorPostcheck(swapped, "kgmaint-weknora")
if err == nil || !strings.Contains(err.Error(), "另一个实例") {
t.Fatalf("err = %v", err)
}
if err := captureExecutorPostcheck(json.RawMessage(`{"snapshot_id":"abc"}`), "kgmaint-weknora"); err == nil ||
!strings.Contains(err.Error(), "没有执行器身份") {
t.Fatalf("missing identity accepted: %v", err)
}
}