Files
2026-11-15 05:47:14 +09:00

135 lines
4.0 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 {
backend, err := configuredDatabaseBackend()
if err != nil {
return err
}
if backend != "sqlite" {
return errors.New("DR commands require the SQLite backend; use PostgreSQL backup/restore for native instances")
}
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")
}