Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts. Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation. Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
128 lines
3.8 KiB
Go
128 lines
3.8 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"flag"
|
|
"fmt"
|
|
"io"
|
|
"os"
|
|
"time"
|
|
|
|
"pageswiki/internal/dr"
|
|
)
|
|
|
|
// All role changes are operator-only and offline. Never expose this as a
|
|
// domain-admin API: a data directory contains multiple campuses and domains.
|
|
func runDR(args []string, out io.Writer) error {
|
|
const usage = "pageswiki dr {init|status|snapshot|verify|restore|promote|resume-workers} [flags]\nUse COMMAND --help. Snapshot requires all writers stopped; promotion requires external fencing."
|
|
if len(args) == 0 || args[0] == "--help" {
|
|
_, err := fmt.Fprintln(out, usage)
|
|
return err
|
|
}
|
|
cmd := args[0]
|
|
switch cmd {
|
|
case "init", "status", "snapshot", "verify", "restore", "promote", "resume-workers":
|
|
default:
|
|
return errors.New(usage)
|
|
}
|
|
f := flag.NewFlagSet("dr "+cmd, flag.ContinueOnError)
|
|
f.SetOutput(out)
|
|
defaultDir := os.Getenv("PAGESWIKI_DATA_DIR")
|
|
if defaultDir == "" {
|
|
defaultDir = "./data"
|
|
}
|
|
dir := f.String("data-dir", defaultDir, "instance data directory")
|
|
var output, snapshot, hash, target, fenced, reference *string
|
|
var stopped, loss, reviewed *bool
|
|
switch cmd {
|
|
case "resume-workers":
|
|
reviewed = f.Bool("reviewed-restored-jobs", false, "attest restored queues and federation state have been reviewed for replay/duplicate effects")
|
|
case "snapshot":
|
|
output = f.String("output", "", "new snapshot directory outside data directory")
|
|
stopped = f.Bool("writers-stopped", false, "attest ALL servers, CLIs and external writers are stopped")
|
|
case "verify", "restore":
|
|
snapshot = f.String("snapshot", "", "snapshot directory")
|
|
hash = f.String("manifest-sha256", "", "manifest SHA-256 received over an authenticated channel")
|
|
if cmd == "restore" {
|
|
target = f.String("target", "", "new, nonexistent data directory (always standby)")
|
|
}
|
|
case "promote":
|
|
fenced = f.String("fenced-node", "", "exact former primary node UUID")
|
|
reference = f.String("fence-reference", "", "operator evidence/ticket for verified power/storage/network fencing")
|
|
loss = f.Bool("accept-data-loss", false, "accept loss of writes since the snapshot cutoff")
|
|
}
|
|
if err := f.Parse(args[1:]); err != nil {
|
|
if errors.Is(err, flag.ErrHelp) {
|
|
return nil
|
|
}
|
|
return err
|
|
}
|
|
if f.NArg() != 0 {
|
|
return errors.New("unexpected positional arguments")
|
|
}
|
|
encode := func(v any) error { e := json.NewEncoder(out); e.SetIndent("", " "); return e.Encode(v) }
|
|
ctx := context.Background()
|
|
switch cmd {
|
|
case "resume-workers":
|
|
c, err := dr.ResumeWorkers(*dir, *reviewed)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(c)
|
|
case "init":
|
|
c, err := dr.Init(*dir)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(c)
|
|
case "status":
|
|
c, err := dr.Load(*dir)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(struct {
|
|
Node *dr.Config `json:"node"`
|
|
StandbyReadable bool `json:"standby_readable"`
|
|
}{c, c != nil && c.Readable(time.Now())})
|
|
case "snapshot":
|
|
if *output == "" || !*stopped {
|
|
return errors.New("snapshot requires --output and --writers-stopped; stop every writer first")
|
|
}
|
|
m, sum, err := dr.Snapshot(ctx, *dir, *output)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(struct {
|
|
Manifest *dr.Manifest `json:"manifest"`
|
|
SHA256 string `json:"manifest_sha256"`
|
|
}{m, sum})
|
|
case "verify":
|
|
if *snapshot == "" {
|
|
return errors.New("--snapshot is required")
|
|
}
|
|
m, err := dr.Verify(ctx, *snapshot, *hash)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(m)
|
|
case "restore":
|
|
if *snapshot == "" || *target == "" {
|
|
return errors.New("--snapshot and --target are required")
|
|
}
|
|
c, err := dr.Restore(ctx, *snapshot, *hash, *target)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(c)
|
|
case "promote":
|
|
c, err := dr.Promote(*dir, *fenced, *reference, *loss)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return encode(c)
|
|
}
|
|
return errors.New("unknown DR command")
|
|
}
|