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)} } }