e6472b0ec6
为什么改:发布执行链是"与目标同机"假设写死的(本机 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、云端归档根未建),未部署、未改云端任何状态。
85 lines
3.8 KiB
Go
85 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)}
|
||
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)}
|
||
}
|
||
}
|