Files
knowledge-governance/internal/appconfig/library_role.go
T
姚章浩 5e1482e349
build / build (push) Successful in 1m40s
feat(library): 恢复验证成为可页面发起的真实作业
根因:生产可恢复性只有 PRODUCTION_BACKUP_RESTORE_VERIFIED 这个手填 env 开关,
页面没有任何入口去真跑一次恢复;CLI(librarydrill)又不是 worker 能复用的实现,
所以"已验证"既证明不了跑过、也证明不了跑的是当前目标。

改动:
- 共享实现 internal/libraryverify(维护隔离→捕获→基线校验→canary→恢复→复核→关窗口),
  cmd/librarydrill 改为薄封装,CLI 与 worker 只允许一份执行体。
- verify 成为独立业务作业:kind + VerifyStages(capture/verify/canary/restore/finalize),
  与 sync/restore/baseline 共用同一把写互斥;迁移 79 加 kind 约束、重建部分唯一索引、
  新建 library_restore_verifications(按 target_id 绑定,换库/索引/桶旧证据自动失效,
  同 target+scope+job 幂等)。
- worker:admitLibraryJob + runOwnedLibraryAttempt 之后调用共享实现,阶段实时写
  library_job_stages,结束后写真实终态;通过写 passed 证据,失败写 failed+原因(不伪成功);
  中断接管按同一作业 id 收掉维护窗口。
- API:POST/GET /api/v1/library/verifications(管理员;闸口关闭/维护中拒绝;返回完整
  整库目标、最近证据、失败原因),OpenAPI 同步。
- 闸口:同步/恢复/续作的证据判断改为读当前目标证据;历史 env 仅在证据缺失时兜底,
  证据存在时以证据为准。
- 页面:生产保护与恢复面板加「恢复验证」块(完整 KB/索引/桶、状态、最近证据、失败原因、
  管理员按钮、5s 轮询),作业类型补 verify 文案。

测试:make verify 16/16 全绿(go 1387 例 + web 454 例 + 契约/迁移/密钥/依赖锁定);
新增用例覆盖证据四条件、闸口证据优先、页面无证据/失败/通过三种呈现与管理员可见性。
2026-11-03 10:14:08 +08:00

86 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),
string(governance.LibraryJobVerify)}
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), string(governance.LibraryJobVerify)}
}
}