5e1482e349
build / build (push) Successful in 1m40s
根因:生产可恢复性只有 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 例 + 契约/迁移/密钥/依赖锁定); 新增用例覆盖证据四条件、闸口证据优先、页面无证据/失败/通过三种呈现与管理员可见性。
86 lines
3.8 KiB
Go
86 lines
3.8 KiB
Go
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)}
|
||
}
|
||
}
|