jcoffey-dev
77e80cb9f2
119 SPDX-FileCopyrightText headers and the README's licence line. The distinction that matters here: LINUXexpert-org appears in this repository in two completely different roles. As a copyright holder in the SPDX headers, which is what changes, and as the GitHub organisation in the module path and 64 import statements, which does not -- the repository still lives at github.com/LINUXexpert-org/stalwart-migrator, and rewriting that would not be a licence change, it would break the build. Both replacements are anchored to their copyright forms, so an import path cannot match either. Import count is 64 before and after, and go.mod is untouched. LICENSE untouched: the FSF's copyright on the GPL text and the "<name of author>" placeholders are not ours to edit. go vet, go build and go test all clean.
67 lines
2.2 KiB
Go
67 lines
2.2 KiB
Go
// SPDX-FileCopyrightText: 2026 Coffey Labs
|
|
// SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
package backup
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"os/exec"
|
|
)
|
|
|
|
// FDBOptions configures a FoundationDB backup via fdbbackup, FDB's own
|
|
// backup CLI (not something Stalwart-specific) - see ARCHITECTURE.md §4.2.
|
|
type FDBOptions struct {
|
|
ClusterFile string // -C; empty uses fdbbackup's own default cluster file
|
|
Destination string // -d, a backup URL e.g. "file:///var/backups/stalwart-fdb"
|
|
Tag string // -t; defaults to "default" if empty
|
|
}
|
|
|
|
func (o FDBOptions) tag() string {
|
|
if o.Tag == "" {
|
|
return "default"
|
|
}
|
|
return o.Tag
|
|
}
|
|
|
|
// BuildFDBBackupStartArgs returns the fdbbackup argv for starting a backup,
|
|
// without the leading "fdbbackup".
|
|
func BuildFDBBackupStartArgs(o FDBOptions) []string {
|
|
args := []string{"start"}
|
|
if o.ClusterFile != "" {
|
|
args = append(args, "-C", o.ClusterFile)
|
|
}
|
|
args = append(args, "-d", o.Destination, "-t", o.tag())
|
|
return args
|
|
}
|
|
|
|
// StartFDBBackup kicks off an fdbbackup run. fdbbackup start returns as soon
|
|
// as the backup job is registered, not when it finishes - callers that need
|
|
// to know it's done should poll FDBBackupStatus and look for their own
|
|
// definition of "complete" in its output, since this wrapper doesn't parse
|
|
// fdbbackup's status text (that format isn't stable enough here to depend
|
|
// on without verifying it against the fdbbackup version actually in use).
|
|
func StartFDBBackup(ctx context.Context, o FDBOptions) error {
|
|
cmd := exec.CommandContext(ctx, "fdbbackup", BuildFDBBackupStartArgs(o)...)
|
|
out, err := cmd.CombinedOutput()
|
|
if err != nil {
|
|
return fmt.Errorf("backup: fdbbackup start failed: %w (output: %s)", err, out)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// FDBBackupStatus returns fdbbackup's raw status output for the given tag,
|
|
// for a human or a caller-supplied parser to interpret.
|
|
func FDBBackupStatus(ctx context.Context, o FDBOptions) (string, error) {
|
|
args := []string{"status", "-t", o.tag()}
|
|
if o.ClusterFile != "" {
|
|
args = append(args, "-C", o.ClusterFile)
|
|
}
|
|
cmd := exec.CommandContext(ctx, "fdbbackup", args...)
|
|
out, err := cmd.CombinedOutput()
|
|
if err != nil {
|
|
return string(out), fmt.Errorf("backup: fdbbackup status failed: %w (output: %s)", err, out)
|
|
}
|
|
return string(out), nil
|
|
}
|