f9457fab52
build / build (push) Successful in 1m35s
B1/B2:演练在同一维护切点做两次真实捕获(写前镜像与来源身份), 写集合在写第一笔之前落盘并登记;恢复走限定范围的 RestoreDrill, 复用同一份 DS01 身份合同与 Apply 原语整段回放,不再让同快照必被拒绝。 worker 接治理维护生命周期(实例+scope 行、真实入口状态、成功才释放), held 保留行并由同 job 的 library.recover 收口(kind 过滤贯通 verify)。 B3:证据优先,failed/invalid 与读取错误即使 env=true 也拒绝。 B4/B5:GET 投影在飞作业,子面板回调父页面轮询;观测绑定 scope 与代次, 刷新失败明确过期,不再显示旧的"已验证"。 迁移 79 不自动 down;未部署、未调用业务目标。
100 lines
3.6 KiB
Go
100 lines
3.6 KiB
Go
// 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-<scope>-<timestamp>)")
|
||
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)
|
||
}
|