// command librarydrill 是恢复演练的**命令行入口**,实现在 internal/libraryverify: // // 维护隔离(关入口/停写入者/证明排空) // → 捕获目标整库(真预备份,落归档) // → 校验目标 == 预备份(基线一致) // → 写入一个 canary(证明"校验确实能发现内容变化") // → 按预备份恢复 // → 逐表/索引/资源/Wiki 再校验一次,必须完全一致 // → 关窗口(按原运行状态恢复服务、开入口、验证健康) // // 为什么只剩薄封装:页面要能点一次"恢复验证",worker 必须在进程内跑同一份实现。 // 两份实现意味着"CLI 通过、页面失败"或反过来,演练结论就不可信了。 // 它只读/写**被测目标自己**,绝不触碰封存源;所有凭据来自进程环境。 package main import ( "context" "encoding/json" "flag" "fmt" "log" "os" "path/filepath" "time" "knowledge-governance/internal/appconfig" "knowledge-governance/internal/libraryverify" ) // 报告类型直接复用共享实现:命令行与页面/worker 的证据字段完全一致。 type drillVerification = libraryverify.Verification type drillReport = libraryverify.Report func main() { scope := flag.String("scope", "internal", "internal|external") reportPath := flag.String("report", "", "write the JSON report here (0600)") jobID := flag.String("job", "", "maintenance job id (default drill--)") recoverOnly := flag.Bool("recover", false, "only recover non-terminal maintenance windows (restore services), then exit") flag.Parse() if *recoverOnly { if err := recoverWindows(); err != nil { log.Fatalf("recover failed: %v", err) } return } report, err := run(*scope, *jobID) if *reportPath != "" && report != nil { if writeErr := writeReport(*reportPath, report); writeErr != nil { log.Printf("drill report write failed: %v", writeErr) } } if err != nil { log.Fatalf("drill failed: %v", err) } log.Printf("drill passed: snapshot=%s", report.SnapshotID) } // recoverWindows 只做一件事:把非终态的维护窗口按原运行状态恢复(服务起来、入口验证)。 // 演练失败但还没写目标内容时,用它把目标从"停住"状态救回来;它不改治理记录, // 治理记录由作业/接口那一侧负责。 func recoverWindows() error { config, err := appconfig.Load(os.Getenv) if err != nil { return fmt.Errorf("load config: %w", err) } if err := libraryverify.RecoverWindows(config); err != nil { return err } log.Printf("maintenance windows recovered; target should be back to its original service state") return nil } func run(scope, jobID string) (*drillReport, error) { config, err := appconfig.Load(os.Getenv) if err != nil { return nil, fmt.Errorf("load config: %w", err) } if jobID == "" { jobID = fmt.Sprintf("drill-%s-%d", scope, time.Now().UTC().UnixNano()) } // 主机侧 CLI 不持有治理库连接:维护记录由调用它的作业/运维流程负责。 // 页面发起的验证走 worker,那里 Options 同时接治理生命周期与写集合登记。 return libraryverify.Run(context.TODO(), config, scope, jobID, libraryverify.Options{ Progress: func(stage, state, detail string) { log.Printf("stage=%s state=%s %s", stage, state, detail) }, }) } func writeReport(path string, report *drillReport) error { raw, err := json.MarshalIndent(report, "", " ") if err != nil { return err } if dir := filepath.Dir(path); dir != "" { if err := os.MkdirAll(dir, 0o700); err != nil { return err } } return os.WriteFile(path, append(raw, '\n'), 0o600) }