Files
pages/cmd/pageswiki/dr.go
T
Anya Tokugawa d5d21b7841
Build and publish container images / images (push) Successful in 9m34s
Release container images / release (push) Successful in 36s
Refactor architecture into eight components and consolidate reliability work
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.
2026-11-01 15:23:31 +09:00

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