Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
7cf82cc1d2 |
No files matched your search
@@ -169,7 +169,7 @@ vaultik [--config <path>] config init
|
|||||||
vaultik [--config <path>] config edit
|
vaultik [--config <path>] config edit
|
||||||
vaultik [--config <path>] config get <key>
|
vaultik [--config <path>] config get <key>
|
||||||
vaultik [--config <path>] config set <key> <value>
|
vaultik [--config <path>] config set <key> <value>
|
||||||
vaultik [--config <path>] snapshot create [snapshot-names...] [--cron] [--prune] [--keep-newer-than <duration>] [--dry-run]
|
vaultik [--config <path>] snapshot create [snapshot-names...] [--cron] [--prune] [--keep-newer-than <duration>]
|
||||||
vaultik [--config <path>] snapshot list [--json] # alias: ls
|
vaultik [--config <path>] snapshot list [--json] # alias: ls
|
||||||
vaultik [--config <path>] snapshot files <snapshot-id> [path] [--json]
|
vaultik [--config <path>] snapshot files <snapshot-id> [path] [--json]
|
||||||
vaultik [--config <path>] snapshot verify <snapshot-id> [--deep] [--json]
|
vaultik [--config <path>] snapshot verify <snapshot-id> [--deep] [--json]
|
||||||
@@ -369,17 +369,6 @@ In such a config, an unknown key or a value of the wrong type is refused.
|
|||||||
duration instead of only the latest (e.g. `4w`, `30d`, `6mo`, `1y`). Without
|
duration instead of only the latest (e.g. `4w`, `30d`, `6mo`, `1y`). Without
|
||||||
`--prune`, or with a value that is not a valid duration, the command fails
|
`--prune`, or with a value that is not a valid duration, the command fails
|
||||||
before the backup starts.
|
before the backup starts.
|
||||||
- `--dry-run`: Scan the source paths and print what a backup would store,
|
|
||||||
without storing it. The summary gives the files examined, to back up and
|
|
||||||
unchanged, their sizes, and the count of excluded entries. An excluded
|
|
||||||
directory counts once, since the scan does not enter it. With `--verbose`, it
|
|
||||||
also prints each excluded entry and the exclude pattern that matched it. It
|
|
||||||
writes nothing to the destination and records nothing in the local index, so
|
|
||||||
it does not bind the index to the destination. Like the other commands that
|
|
||||||
read the local index, it creates an empty one if there is none. When the local
|
|
||||||
index holds an incomplete snapshot from an interrupted backup, it says so: the
|
|
||||||
next backup drops that snapshot first and may back up more files than the dry
|
|
||||||
run counts. It cannot be combined with `--prune`.
|
|
||||||
- Fails before it writes anything when a `file://` destination directory does
|
- Fails before it writes anything when a `file://` destination directory does
|
||||||
not exist, or when the local index holds snapshots and the destination answers
|
not exist, or when the local index holds snapshots and the destination answers
|
||||||
that it has no `vaultik-destination.txt`. When that look-up fails for any
|
that it has no `vaultik-destination.txt`. When that look-up fails for any
|
||||||
@@ -565,6 +554,12 @@ count and blob size unknown, `null` in `--json`. A file under `blobs/` whose
|
|||||||
name is not a blob hash is not counted as a blob, since `prune` never deletes
|
name is not a blob hash is not counted as a blob, since `prune` never deletes
|
||||||
it.
|
it.
|
||||||
|
|
||||||
|
A blob that a manifest lists but the destination does not hold is reported as
|
||||||
|
missing, with a count and size. The report names each snapshot that lists a
|
||||||
|
missing blob, since that snapshot cannot be restored. The command then exits
|
||||||
|
non-zero. `--json` gives these in `missing_blob_count`, `missing_blob_size` and
|
||||||
|
`snapshots_missing_blobs`.
|
||||||
|
|
||||||
- `--json`: Output as JSON
|
- `--json`: Output as JSON
|
||||||
|
|
||||||
**`remote nuke`**: Delete every object under `metadata/` and `blobs/` on the
|
**`remote nuke`**: Delete every object under `metadata/` and `blobs/` on the
|
||||||
|
|||||||
+4
-4
@@ -39,10 +39,10 @@ const (
|
|||||||
// hold the PID lock so that at most one runs at a time.
|
// hold the PID lock so that at most one runs at a time.
|
||||||
mutating lockMode = iota
|
mutating lockMode = iota
|
||||||
// readOnly commands (info, snapshot list, snapshot files, snapshot
|
// readOnly commands (info, snapshot list, snapshot files, snapshot
|
||||||
// verify, remote info, snapshot restore, snapshot create --dry-run)
|
// verify, remote info, snapshot restore) do not write the local index
|
||||||
// do not write the local index or the remote store, so they run
|
// or the remote store, so they run without the lock and are never
|
||||||
// without the lock and are never blocked by a running mutator.
|
// blocked by a running mutator. restore writes only to the target
|
||||||
// restore writes only to the target directory it is given.
|
// directory it is given.
|
||||||
readOnly
|
readOnly
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|||||||
@@ -1,89 +0,0 @@
|
|||||||
package cli //nolint:testpackage // shares runEntry and the hermetic config helpers
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"io"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"github.com/stretchr/testify/assert"
|
|
||||||
"github.com/stretchr/testify/require"
|
|
||||||
"sneak.berlin/go/vaultik/internal/database"
|
|
||||||
"sneak.berlin/go/vaultik/internal/ui"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestEntrySnapshotCreateDryRun runs `snapshot create --dry-run
|
|
||||||
// --verbose` on a source directory that holds one kept file, one file an
|
|
||||||
// unanchored pattern excludes and one directory an anchored pattern
|
|
||||||
// excludes. The summary counts the kept file and two excluded entries,
|
|
||||||
// the excluded ones are listed with their patterns, and nothing is
|
|
||||||
// written to the destination or recorded in the local index. See
|
|
||||||
// https://git.eeqj.de/sneak/vaultik/issues/436.
|
|
||||||
//
|
|
||||||
//nolint:paralleltest // replaces os.Args, os.Stdout, os.Stderr and the xdg globals
|
|
||||||
func TestEntrySnapshotCreateDryRun(t *testing.T) {
|
|
||||||
configPath, storeDir := writeBackupConfig(t)
|
|
||||||
sourceDir := filepath.Join(filepath.Dir(configPath), "source")
|
|
||||||
cacheDir := filepath.Join(sourceDir, "cache")
|
|
||||||
|
|
||||||
require.NoError(t, os.WriteFile(
|
|
||||||
filepath.Join(sourceDir, "debug.log"), []byte("log"), 0o600))
|
|
||||||
require.NoError(t, os.Mkdir(cacheDir, 0o750))
|
|
||||||
|
|
||||||
for _, name := range []string{"a", "b"} {
|
|
||||||
require.NoError(t, os.WriteFile(
|
|
||||||
filepath.Join(cacheDir, name), []byte(name), 0o600))
|
|
||||||
}
|
|
||||||
|
|
||||||
out := ui.NewWithColor(io.Discard, false)
|
|
||||||
require.NoError(t, writeConfigSet(out, configPath, "exclude.0", "*.log"))
|
|
||||||
require.NoError(t, writeConfigSet(out, configPath, "exclude.1", "/cache"))
|
|
||||||
|
|
||||||
code, stdout, stderr := runEntry(t, flagConfig, configPath, "--verbose",
|
|
||||||
cmdSnapshot, cmdCreate, "--dry-run")
|
|
||||||
|
|
||||||
require.Equal(t, 0, code, stderr)
|
|
||||||
assert.Contains(t, stdout, "Excluded "+filepath.Join(sourceDir, "debug.log")+
|
|
||||||
`: matches exclude pattern "*.log".`)
|
|
||||||
assert.Contains(t, stdout, "Excluded "+cacheDir+
|
|
||||||
`: matches exclude pattern "/cache".`)
|
|
||||||
assert.NotContains(t, stdout, filepath.Join(cacheDir, "a"))
|
|
||||||
assert.Contains(t, stdout, "Files: 1 examined, 1 to back up, 0 unchanged.")
|
|
||||||
assert.Contains(t, stdout, "Excluded: 2 entries.")
|
|
||||||
|
|
||||||
entries, err := os.ReadDir(storeDir)
|
|
||||||
require.NoError(t, err)
|
|
||||||
assert.Empty(t, entries, "a dry run writes nothing to the destination")
|
|
||||||
|
|
||||||
ctx := context.Background()
|
|
||||||
db, err := database.New(ctx,
|
|
||||||
filepath.Join(filepath.Dir(configPath), "index.sqlite"))
|
|
||||||
require.NoError(t, err)
|
|
||||||
|
|
||||||
defer func() { require.NoError(t, db.Close()) }()
|
|
||||||
|
|
||||||
repos := database.NewRepositories(db)
|
|
||||||
|
|
||||||
snapshots, err := repos.Snapshots.ListRecent(ctx, 1)
|
|
||||||
require.NoError(t, err)
|
|
||||||
assert.Empty(t, snapshots, "a dry run records no snapshot")
|
|
||||||
|
|
||||||
binding, err := repos.LocalMeta.Get(ctx, database.LocalMetaKeyStorageURL)
|
|
||||||
require.NoError(t, err)
|
|
||||||
assert.Empty(t, binding, "a dry run does not bind the local index")
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestEntrySnapshotCreateDryRunRefusesPrune checks that --dry-run with
|
|
||||||
// --prune fails before anything runs.
|
|
||||||
//
|
|
||||||
//nolint:paralleltest // replaces os.Args, os.Stdout, os.Stderr and the xdg globals
|
|
||||||
func TestEntrySnapshotCreateDryRunRefusesPrune(t *testing.T) {
|
|
||||||
configPath, _ := writeBackupConfig(t)
|
|
||||||
|
|
||||||
code, _, stderr := runEntry(t, flagConfig, configPath,
|
|
||||||
cmdSnapshot, cmdCreate, "--dry-run", "--prune")
|
|
||||||
|
|
||||||
assert.NotEqual(t, 0, code)
|
|
||||||
assert.Contains(t, stderr, "--dry-run cannot be used with --prune")
|
|
||||||
}
|
|
||||||
@@ -75,7 +75,9 @@ func newRemoteInfoCommand() *cobra.Command {
|
|||||||
- Size of all snapshot metadata (per snapshot and total)
|
- Size of all snapshot metadata (per snapshot and total)
|
||||||
- Count and total size of all blobs
|
- Count and total size of all blobs
|
||||||
- Count and size of referenced blobs (from all manifests)
|
- Count and size of referenced blobs (from all manifests)
|
||||||
- Count and size of orphaned blobs (not referenced by any manifest)`,
|
- Count and size of orphaned blobs (not referenced by any manifest)
|
||||||
|
- Count and size of referenced blobs missing from remote storage, and the
|
||||||
|
snapshots that list them; the command exits non-zero when any are missing`,
|
||||||
Args: cobra.NoArgs,
|
Args: cobra.NoArgs,
|
||||||
RunE: func(cmd *cobra.Command, _ []string) error {
|
RunE: func(cmd *cobra.Command, _ []string) error {
|
||||||
// Use unified config resolution
|
// Use unified config resolution
|
||||||
|
|||||||
+19
-35
@@ -99,13 +99,6 @@ on Linux), then /etc/vaultik/config.yml.`,
|
|||||||
|
|
||||||
// Use the backup functionality from cli package
|
// Use the backup functionality from cli package
|
||||||
rootFlags := GetRootFlags()
|
rootFlags := GetRootFlags()
|
||||||
opts.ListExcluded = rootFlags.Verbose
|
|
||||||
|
|
||||||
// A dry run writes nothing, so it does not take the lock.
|
|
||||||
mode := mutating
|
|
||||||
if opts.DryRun {
|
|
||||||
mode = readOnly
|
|
||||||
}
|
|
||||||
|
|
||||||
// --cron suppression is wired through v.UI by setupGlobals.
|
// --cron suppression is wired through v.UI by setupGlobals.
|
||||||
return RunOperation(cmd.Context(), AppOptions{
|
return RunOperation(cmd.Context(), AppOptions{
|
||||||
@@ -116,11 +109,28 @@ on Linux), then /etc/vaultik/config.yml.`,
|
|||||||
Cron: opts.Cron,
|
Cron: opts.Cron,
|
||||||
Quiet: rootFlags.Quiet,
|
Quiet: rootFlags.Quiet,
|
||||||
},
|
},
|
||||||
Mode: mode,
|
Mode: mutating,
|
||||||
}, func(v *vaultik.Vaultik) error {
|
}, func(v *vaultik.Vaultik) error {
|
||||||
return v.CreateSnapshot(opts)
|
return v.CreateSnapshot(opts)
|
||||||
}, func(err error) {
|
}, func(err error) {
|
||||||
reportSnapshotCreateFailure(opts.DryRun, err)
|
if errors.Is(err, vaultik.ErrPostBackupPruneFailed) {
|
||||||
|
log.Info("Post-backup prune failed", "error", err)
|
||||||
|
ReportErrorf("Backup completed, but %v", err)
|
||||||
|
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if errors.Is(err, vaultik.ErrFilesUnreadable) ||
|
||||||
|
errors.Is(err, vaultik.ErrSourcePathEmpty) ||
|
||||||
|
errors.Is(err, vaultik.ErrVolumeNotMounted) {
|
||||||
|
log.Info("Backup completed with an error", "error", err)
|
||||||
|
ReportErrorf("Backup completed, but %v", err)
|
||||||
|
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
log.Info("Snapshot creation failed", "error", err)
|
||||||
|
ReportErrorf("Snapshot creation failed: %v", err)
|
||||||
})
|
})
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
@@ -139,36 +149,10 @@ on Linux), then /etc/vaultik/config.yml.`,
|
|||||||
"With --prune: keep snapshots newer than this duration "+
|
"With --prune: keep snapshots newer than this duration "+
|
||||||
"(e.g. 30d, 4w, 6mo, 1y; m is minutes, mo is months) "+
|
"(e.g. 30d, 4w, 6mo, 1y; m is minutes, mo is months) "+
|
||||||
"instead of only the latest")
|
"instead of only the latest")
|
||||||
cmd.Flags().BoolVar(&opts.DryRun, "dry-run", false,
|
|
||||||
"Scan the snapshot source paths and print what a backup would store, "+
|
|
||||||
"writing nothing to the local index or the backup destination; "+
|
|
||||||
"with --verbose, also print each excluded entry and the exclude "+
|
|
||||||
"pattern that matched it")
|
|
||||||
|
|
||||||
return cmd
|
return cmd
|
||||||
}
|
}
|
||||||
|
|
||||||
// reportSnapshotCreateFailure shows the user the error `snapshot create`
|
|
||||||
// failed with. dryRun says whether it was given --dry-run.
|
|
||||||
func reportSnapshotCreateFailure(dryRun bool, err error) {
|
|
||||||
switch {
|
|
||||||
case dryRun:
|
|
||||||
log.Info("Dry run failed", "error", err)
|
|
||||||
ReportErrorf("Dry run failed: %v", err)
|
|
||||||
case errors.Is(err, vaultik.ErrPostBackupPruneFailed):
|
|
||||||
log.Info("Post-backup prune failed", "error", err)
|
|
||||||
ReportErrorf("Backup completed, but %v", err)
|
|
||||||
case errors.Is(err, vaultik.ErrFilesUnreadable) ||
|
|
||||||
errors.Is(err, vaultik.ErrSourcePathEmpty) ||
|
|
||||||
errors.Is(err, vaultik.ErrVolumeNotMounted):
|
|
||||||
log.Info("Backup completed with an error", "error", err)
|
|
||||||
ReportErrorf("Backup completed, but %v", err)
|
|
||||||
default:
|
|
||||||
log.Info("Snapshot creation failed", "error", err)
|
|
||||||
ReportErrorf("Snapshot creation failed: %v", err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// newSnapshotListCommand creates the 'snapshot list' subcommand
|
// newSnapshotListCommand creates the 'snapshot list' subcommand
|
||||||
func newSnapshotListCommand() *cobra.Command {
|
func newSnapshotListCommand() *cobra.Command {
|
||||||
var jsonOutput bool
|
var jsonOutput bool
|
||||||
|
|||||||
+13
-103
@@ -71,10 +71,7 @@ type Scanner struct {
|
|||||||
// indexAndLockFiles holds the paths of vaultik's own working files,
|
// indexAndLockFiles holds the paths of vaultik's own working files,
|
||||||
// which the scan treats as excluded (ScannerConfig.IndexAndLockFiles).
|
// which the scan treats as excluded (ScannerConfig.IndexAndLockFiles).
|
||||||
indexAndLockFiles map[string]struct{}
|
indexAndLockFiles map[string]struct{}
|
||||||
// listExcluded prints each excluded entry and why it is excluded
|
progress *ProgressReporter
|
||||||
// (DryRun).
|
|
||||||
listExcluded bool
|
|
||||||
progress *ProgressReporter
|
|
||||||
// skipErrors skips files that cannot be opened or read (logged loudly);
|
// skipErrors skips files that cannot be opened or read (logged loudly);
|
||||||
// packer, database, encryption, and upload errors still abort the run.
|
// packer, database, encryption, and upload errors still abort the run.
|
||||||
skipErrors bool
|
skipErrors bool
|
||||||
@@ -193,11 +190,6 @@ type ScanResult struct {
|
|||||||
// itself when it is a directory. It is zero for an empty directory,
|
// itself when it is a directory. It is zero for an empty directory,
|
||||||
// such as the mount point of a volume that is not mounted.
|
// such as the mount point of a volume that is not mounted.
|
||||||
EntriesFound int
|
EntriesFound int
|
||||||
|
|
||||||
// EntriesExcluded counts the entries the walk found that an exclude
|
|
||||||
// pattern matches or that are vaultik's own files. An excluded
|
|
||||||
// directory counts once: the walk does not enter it.
|
|
||||||
EntriesExcluded int
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// NewScanner creates a new scanner instance
|
// NewScanner creates a new scanner instance
|
||||||
@@ -368,42 +360,6 @@ func (s *Scanner) Scan(
|
|||||||
return result, nil
|
return result, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// DryRun walks path as Scan does and counts what a backup would store,
|
|
||||||
// without storing it. It reads the local index to tell unchanged files
|
|
||||||
// from new and changed ones, and writes nothing to the local index or
|
|
||||||
// the backup destination store. With listExcluded it prints each
|
|
||||||
// excluded entry and the exclude pattern that matched it.
|
|
||||||
func (s *Scanner) DryRun(
|
|
||||||
ctx context.Context, path string, listExcluded bool,
|
|
||||||
) (*ScanResult, error) {
|
|
||||||
s.currentSourcePath = path
|
|
||||||
s.listExcluded = listExcluded
|
|
||||||
result := &ScanResult{
|
|
||||||
StartTime: time.Now().UTC(),
|
|
||||||
}
|
|
||||||
|
|
||||||
knownFiles, err := s.loadDatabaseState(ctx, path)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
existingFiles := make(map[string]struct{})
|
|
||||||
|
|
||||||
_, err = s.scanPhase(ctx, path, result, existingFiles, knownFiles)
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("scan phase failed: %w", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
err = s.detectDeletedFiles(ctx, path, existingFiles, result)
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("detecting deleted files: %w", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
result.EndTime = time.Now().UTC()
|
|
||||||
|
|
||||||
return result, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// GetProgress returns the progress reporter for this scanner, or nil when
|
// GetProgress returns the progress reporter for this scanner, or nil when
|
||||||
// progress is off. Scan neither starts nor stops it: the caller does,
|
// progress is off. Scan neither starts nor stops it: the caller does,
|
||||||
// once for all the paths it scans, because a second Stop panics.
|
// once for all the paths it scans, because a second Stop panics.
|
||||||
@@ -988,8 +944,12 @@ func (s *Scanner) scanPhase(
|
|||||||
// or cannot be looked up is neither counted nor reported. For
|
// or cannot be looked up is neither counted nor reported. For
|
||||||
// directories, skip the entire subtree. info is nil when the
|
// directories, skip the entire subtree. info is nil when the
|
||||||
// walk could not look the entry up.
|
// walk could not look the entry up.
|
||||||
if excluded, walkErr := s.skipExcluded(filePath, path, info, result); excluded {
|
if s.shouldExclude(filePath, path) {
|
||||||
return walkErr
|
if info != nil && info.IsDir() {
|
||||||
|
return filepath.SkipDir
|
||||||
|
}
|
||||||
|
|
||||||
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// The source path is in no directory listing, so its absence is
|
// The source path is in no directory listing, so its absence is
|
||||||
@@ -1056,32 +1016,6 @@ func (s *Scanner) scanPhase(
|
|||||||
}, nil
|
}, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
// skipExcluded reports whether the walk skips filePath, under rootPath,
|
|
||||||
// because it is excluded, and counts it if so. The error is what the walk
|
|
||||||
// function returns for it: filepath.SkipDir for a directory, so the walk
|
|
||||||
// does not enter it, and nil otherwise. info is nil when the walk could
|
|
||||||
// not look the entry up.
|
|
||||||
func (s *Scanner) skipExcluded(
|
|
||||||
filePath, rootPath string, info os.FileInfo, result *ScanResult,
|
|
||||||
) (bool, error) {
|
|
||||||
pattern, excluded := s.excludingPattern(filePath, rootPath)
|
|
||||||
if !excluded {
|
|
||||||
return false, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
result.EntriesExcluded++
|
|
||||||
|
|
||||||
if s.listExcluded {
|
|
||||||
s.printExcluded(filePath, pattern)
|
|
||||||
}
|
|
||||||
|
|
||||||
if info != nil && info.IsDir() {
|
|
||||||
return true, filepath.SkipDir
|
|
||||||
}
|
|
||||||
|
|
||||||
return true, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// countNonDirectories returns how many of files are not directories.
|
// countNonDirectories returns how many of files are not directories.
|
||||||
func countNonDirectories(files map[string]*database.File) int64 {
|
func countNonDirectories(files map[string]*database.File) int64 {
|
||||||
var count int64
|
var count int64
|
||||||
@@ -2417,32 +2351,23 @@ func compileExcludePatterns(patterns []string) ([]compiledPattern, error) {
|
|||||||
// filePath is the full path to the file
|
// filePath is the full path to the file
|
||||||
// rootPath is the root of the backup source directory
|
// rootPath is the root of the backup source directory
|
||||||
func (s *Scanner) shouldExclude(filePath, rootPath string) bool {
|
func (s *Scanner) shouldExclude(filePath, rootPath string) bool {
|
||||||
_, excluded := s.excludingPattern(filePath, rootPath)
|
|
||||||
|
|
||||||
return excluded
|
|
||||||
}
|
|
||||||
|
|
||||||
// excludingPattern reports whether shouldExclude excludes filePath and
|
|
||||||
// returns the exclude pattern, as configured, that matches it. The
|
|
||||||
// pattern is "" for one of vaultik's own working files.
|
|
||||||
func (s *Scanner) excludingPattern(filePath, rootPath string) (string, bool) {
|
|
||||||
if _, ok := s.indexAndLockFiles[filePath]; ok {
|
if _, ok := s.indexAndLockFiles[filePath]; ok {
|
||||||
return "", true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
if len(s.compiledExclude) == 0 {
|
if len(s.compiledExclude) == 0 {
|
||||||
return "", false
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
// Get the relative path from root
|
// Get the relative path from root
|
||||||
relPath, err := filepath.Rel(rootPath, filePath)
|
relPath, err := filepath.Rel(rootPath, filePath)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return "", false
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
// Never exclude the root directory itself
|
// Never exclude the root directory itself
|
||||||
if relPath == "." {
|
if relPath == "." {
|
||||||
return "", false
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
// Normalize path separators
|
// Normalize path separators
|
||||||
@@ -2451,26 +2376,11 @@ func (s *Scanner) excludingPattern(filePath, rootPath string) (string, bool) {
|
|||||||
// Check each pattern
|
// Check each pattern
|
||||||
for _, cp := range s.compiledExclude {
|
for _, cp := range s.compiledExclude {
|
||||||
if cp.matches(relPath) {
|
if cp.matches(relPath) {
|
||||||
return cp.original, true
|
return true
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return "", false
|
return false
|
||||||
}
|
|
||||||
|
|
||||||
// printExcluded prints that the walk excluded filePath and why: pattern
|
|
||||||
// is the exclude pattern that matched it, "" for one of vaultik's own
|
|
||||||
// working files.
|
|
||||||
func (s *Scanner) printExcluded(filePath, pattern string) {
|
|
||||||
if pattern == "" {
|
|
||||||
s.ui.Infof("Excluded %s: vaultik's own index or lock file.",
|
|
||||||
s.ui.Path(filePath))
|
|
||||||
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
s.ui.Infof("Excluded %s: matches exclude pattern %q.",
|
|
||||||
s.ui.Path(filePath), pattern)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// matches reports whether the compiled pattern matches the given
|
// matches reports whether the compiled pattern matches the given
|
||||||
|
|||||||
@@ -9,6 +9,7 @@ import (
|
|||||||
|
|
||||||
"github.com/dustin/go-humanize"
|
"github.com/dustin/go-humanize"
|
||||||
"sneak.berlin/go/vaultik/internal/log"
|
"sneak.berlin/go/vaultik/internal/log"
|
||||||
|
"sneak.berlin/go/vaultik/internal/storage"
|
||||||
)
|
)
|
||||||
|
|
||||||
// ShowInfo displays system and configuration information
|
// ShowInfo displays system and configuration information
|
||||||
@@ -187,6 +188,9 @@ type SnapshotMetadataInfo struct {
|
|||||||
// backup interrupted before its manifest upload leaves a directory
|
// backup interrupted before its manifest upload leaves a directory
|
||||||
// without one, which prune does not treat as a snapshot.
|
// without one, which prune does not treat as a snapshot.
|
||||||
hasManifest bool
|
hasManifest bool
|
||||||
|
|
||||||
|
// Hashes of the blobs the snapshot's manifest lists.
|
||||||
|
blobHashes []string
|
||||||
}
|
}
|
||||||
|
|
||||||
// RemoteInfoResult contains all remote storage information
|
// RemoteInfoResult contains all remote storage information
|
||||||
@@ -216,6 +220,13 @@ type RemoteInfoResult struct {
|
|||||||
OrphanedBlobCount *int `json:"orphaned_blob_count"`
|
OrphanedBlobCount *int `json:"orphaned_blob_count"`
|
||||||
OrphanedBlobSize *int64 `json:"orphaned_blob_size"`
|
OrphanedBlobSize *int64 `json:"orphaned_blob_size"`
|
||||||
|
|
||||||
|
// Blobs that a manifest lists but the destination does not hold,
|
||||||
|
// and the remote key of each snapshot whose manifest lists one.
|
||||||
|
// Those snapshots cannot be restored.
|
||||||
|
MissingBlobCount int `json:"missing_blob_count"`
|
||||||
|
MissingBlobSize int64 `json:"missing_blob_size"`
|
||||||
|
SnapshotsMissingBlobs []string `json:"snapshots_missing_blobs,omitempty"`
|
||||||
|
|
||||||
// Remote key of each snapshot whose manifest could not be read
|
// Remote key of each snapshot whose manifest could not be read
|
||||||
UnreadableManifests []string `json:"unreadable_manifests,omitempty"`
|
UnreadableManifests []string `json:"unreadable_manifests,omitempty"`
|
||||||
|
|
||||||
@@ -283,19 +294,30 @@ func (v *Vaultik) RemoteInfo(jsonOutput bool) error {
|
|||||||
"snapshots", result.TotalMetadataCount,
|
"snapshots", result.TotalMetadataCount,
|
||||||
"total_blobs", result.TotalBlobCount,
|
"total_blobs", result.TotalBlobCount,
|
||||||
"referenced_blobs", result.ReferencedBlobCount,
|
"referenced_blobs", result.ReferencedBlobCount,
|
||||||
|
"missing_blobs", result.MissingBlobCount,
|
||||||
"unreadable_manifests", len(result.UnreadableManifests))
|
"unreadable_manifests", len(result.UnreadableManifests))
|
||||||
|
|
||||||
if jsonOutput {
|
if jsonOutput {
|
||||||
enc := json.NewEncoder(v.Stdout)
|
enc := json.NewEncoder(v.Stdout)
|
||||||
enc.SetIndent("", " ")
|
enc.SetIndent("", " ")
|
||||||
|
|
||||||
return enc.Encode(result)
|
err = enc.Encode(result)
|
||||||
|
if err != nil {
|
||||||
|
return fmt.Errorf("encoding JSON: %w", err)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if showText {
|
if showText {
|
||||||
v.printRemoteInfoTable(result)
|
v.printRemoteInfoTable(result)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The report is written first, so the exit status adds to it.
|
||||||
|
if result.MissingBlobCount > 0 {
|
||||||
|
return fmt.Errorf("%w: %d blob(s) that snapshots list are missing; "+
|
||||||
|
"%d snapshot(s) cannot be restored", errProblemsInStorage,
|
||||||
|
result.MissingBlobCount, len(result.SnapshotsMissingBlobs))
|
||||||
|
}
|
||||||
|
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -405,6 +427,7 @@ func (v *Vaultik) collectReferencedBlobsFromManifests(
|
|||||||
for _, blob := range manifest.Blobs {
|
for _, blob := range manifest.Blobs {
|
||||||
referencedBlobs[blob.Hash] = blob.CompressedSize
|
referencedBlobs[blob.Hash] = blob.CompressedSize
|
||||||
blobsSize += blob.CompressedSize
|
blobsSize += blob.CompressedSize
|
||||||
|
info.blobHashes = append(info.blobHashes, blob.Hash)
|
||||||
}
|
}
|
||||||
|
|
||||||
info.BlobCount = &blobCount
|
info.BlobCount = &blobCount
|
||||||
@@ -462,6 +485,8 @@ func (v *Vaultik) scanRemoteBlobStorage(
|
|||||||
result.TotalBlobSize += blob.Size
|
result.TotalBlobSize += blob.Size
|
||||||
}
|
}
|
||||||
|
|
||||||
|
countMissingBlobs(result, referencedBlobs, allBlobs)
|
||||||
|
|
||||||
// A blob named only by a manifest that could not be read, or by one
|
// A blob named only by a manifest that could not be read, or by one
|
||||||
// under a skipped name, would be counted as orphaned, so the orphan
|
// under a skipped name, would be counted as orphaned, so the orphan
|
||||||
// figures stay unknown.
|
// figures stay unknown.
|
||||||
@@ -487,6 +512,33 @@ func (v *Vaultik) scanRemoteBlobStorage(
|
|||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// countMissingBlobs records in result the referenced blobs that
|
||||||
|
// allBlobs, the listing of the destination, does not hold, and the
|
||||||
|
// snapshots whose manifests list one of them. It reads the snapshots
|
||||||
|
// from result.Snapshots, so populateRemoteInfoResult must run first.
|
||||||
|
func countMissingBlobs(
|
||||||
|
result *RemoteInfoResult, referencedBlobs map[string]int64,
|
||||||
|
allBlobs map[string]storage.ObjectInfo,
|
||||||
|
) {
|
||||||
|
for hash, size := range referencedBlobs {
|
||||||
|
if _, present := allBlobs[hash]; !present {
|
||||||
|
result.MissingBlobCount++
|
||||||
|
result.MissingBlobSize += size
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, info := range result.Snapshots {
|
||||||
|
for _, hash := range info.blobHashes {
|
||||||
|
if _, present := allBlobs[hash]; !present {
|
||||||
|
result.SnapshotsMissingBlobs = append(
|
||||||
|
result.SnapshotsMissingBlobs, info.SnapshotID)
|
||||||
|
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// printRemoteInfoTable renders the human-readable remote info output
|
// printRemoteInfoTable renders the human-readable remote info output
|
||||||
func (v *Vaultik) printRemoteInfoTable(result *RemoteInfoResult) {
|
func (v *Vaultik) printRemoteInfoTable(result *RemoteInfoResult) {
|
||||||
const (
|
const (
|
||||||
@@ -539,6 +591,12 @@ func (v *Vaultik) printRemoteInfoTable(result *RemoteInfoResult) {
|
|||||||
"", "", ubytes(result.TotalMetadataSize))
|
"", "", ubytes(result.TotalMetadataSize))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
v.printBlobStorageSummary(result)
|
||||||
|
}
|
||||||
|
|
||||||
|
// printBlobStorageSummary renders the blob storage section that ends
|
||||||
|
// the human-readable remote info output.
|
||||||
|
func (v *Vaultik) printBlobStorageSummary(result *RemoteInfoResult) {
|
||||||
v.stdoutf("\n=== Blob Storage ===\n")
|
v.stdoutf("\n=== Blob Storage ===\n")
|
||||||
v.stdoutf("Total blobs on remote: %s (%s)\n",
|
v.stdoutf("Total blobs on remote: %s (%s)\n",
|
||||||
humanize.Comma(int64(result.TotalBlobCount)),
|
humanize.Comma(int64(result.TotalBlobCount)),
|
||||||
@@ -546,22 +604,31 @@ func (v *Vaultik) printRemoteInfoTable(result *RemoteInfoResult) {
|
|||||||
v.stdoutf("Referenced by snapshots: %s (%s)\n",
|
v.stdoutf("Referenced by snapshots: %s (%s)\n",
|
||||||
humanize.Comma(int64(result.ReferencedBlobCount)),
|
humanize.Comma(int64(result.ReferencedBlobCount)),
|
||||||
ubytes(result.ReferencedBlobSize))
|
ubytes(result.ReferencedBlobSize))
|
||||||
|
v.stdoutf("Missing from remote: %s (%s)\n",
|
||||||
|
humanize.Comma(int64(result.MissingBlobCount)),
|
||||||
|
ubytes(result.MissingBlobSize))
|
||||||
|
|
||||||
if result.OrphanedBlobCount == nil {
|
if result.OrphanedBlobCount == nil {
|
||||||
v.stdoutf("Orphaned (unreferenced): unknown "+
|
v.stdoutf("Orphaned (unreferenced): unknown "+
|
||||||
"(%d manifest(s) could not be read, "+
|
"(%d manifest(s) could not be read, "+
|
||||||
"%d manifest(s) under a non-conforming name skipped)\n",
|
"%d manifest(s) under a non-conforming name skipped)\n",
|
||||||
len(result.UnreadableManifests), result.SkippedManifestCount)
|
len(result.UnreadableManifests), result.SkippedManifestCount)
|
||||||
|
} else {
|
||||||
|
v.stdoutf("Orphaned (unreferenced): %s (%s)\n",
|
||||||
|
humanize.Comma(int64(*result.OrphanedBlobCount)),
|
||||||
|
ubytes(*result.OrphanedBlobSize))
|
||||||
|
|
||||||
return
|
if *result.OrphanedBlobCount > 0 {
|
||||||
|
v.stdoutf("\nRun 'vaultik prune' to remove orphaned blobs.\n")
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
v.stdoutf("Orphaned (unreferenced): %s (%s)\n",
|
if len(result.SnapshotsMissingBlobs) > 0 {
|
||||||
humanize.Comma(int64(*result.OrphanedBlobCount)),
|
v.stdoutf("\nSnapshots that cannot be restored (blobs missing):\n")
|
||||||
ubytes(*result.OrphanedBlobSize))
|
|
||||||
|
|
||||||
if *result.OrphanedBlobCount > 0 {
|
for _, id := range result.SnapshotsMissingBlobs {
|
||||||
v.stdoutf("\nRun 'vaultik prune' to remove orphaned blobs.\n")
|
v.stdoutf(" %s\n", id)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -83,6 +83,7 @@ func TestRemoteInfo_UnreadableManifestLeavesSnapshotBlobsUnknown(t *testing.T) {
|
|||||||
env := newListEnv(t)
|
env := newListEnv(t)
|
||||||
readableKey := env.addRemote(t, listRemoteID,
|
readableKey := env.addRemote(t, listRemoteID,
|
||||||
time.Date(2026, 3, 2, 0, 0, 0, 0, time.UTC))
|
time.Date(2026, 3, 2, 0, 0, 0, 0, time.UTC))
|
||||||
|
addBlob(t, env.store.testStorer, testBlobHashA)
|
||||||
|
|
||||||
unreadableKey := snapshot.RemoteSnapshotKey(listLocalID)
|
unreadableKey := snapshot.RemoteSnapshotKey(listLocalID)
|
||||||
require.NoError(t, env.store.Put(context.Background(),
|
require.NoError(t, env.store.Put(context.Background(),
|
||||||
@@ -270,6 +271,7 @@ func TestRemoteInfo_StatusLineUsesUIMarker(t *testing.T) {
|
|||||||
|
|
||||||
env := newListEnv(t)
|
env := newListEnv(t)
|
||||||
env.addRemote(t, listRemoteID, time.Date(2026, 3, 2, 0, 0, 0, 0, time.UTC))
|
env.addRemote(t, listRemoteID, time.Date(2026, 3, 2, 0, 0, 0, 0, time.UTC))
|
||||||
|
addBlob(t, env.store.testStorer, testBlobHashA)
|
||||||
|
|
||||||
const statusLine = ui.Marker + " Scanning snapshot metadata...\n"
|
const statusLine = ui.Marker + " Scanning snapshot metadata...\n"
|
||||||
|
|
||||||
@@ -281,3 +283,61 @@ func TestRemoteInfo_StatusLineUsesUIMarker(t *testing.T) {
|
|||||||
require.NoError(t, env.v.RemoteInfo(false))
|
require.NoError(t, env.v.RemoteInfo(false))
|
||||||
assert.NotContains(t, env.stdout.String(), "Scanning snapshot metadata")
|
assert.NotContains(t, env.stdout.String(), "Scanning snapshot metadata")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TestRemoteInfo_ReportsBlobsMissingFromDestination checks that a blob a
|
||||||
|
// manifest lists but the destination does not hold is counted as
|
||||||
|
// missing, that the snapshot listing it is named, and that remote info
|
||||||
|
// then fails after writing its report.
|
||||||
|
func TestRemoteInfo_ReportsBlobsMissingFromDestination(t *testing.T) {
|
||||||
|
log.Initialize(log.Config{})
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := newListEnv(t)
|
||||||
|
|
||||||
|
// The first snapshot lists blob A, which is not stored. The second
|
||||||
|
// lists blob B, which is.
|
||||||
|
brokenKey := env.addRemote(t, listRemoteID,
|
||||||
|
time.Date(2026, 3, 2, 0, 0, 0, 0, time.UTC))
|
||||||
|
addManifest(t, env.store.testStorer, listLocalID, []string{testBlobHashB})
|
||||||
|
addBlob(t, env.store.testStorer, testBlobHashB)
|
||||||
|
|
||||||
|
const wantError = "1 blob(s) that snapshots list are missing; " +
|
||||||
|
"1 snapshot(s) cannot be restored"
|
||||||
|
|
||||||
|
err := env.v.RemoteInfo(false)
|
||||||
|
require.ErrorContains(t, err, wantError)
|
||||||
|
|
||||||
|
text := env.stdout.String()
|
||||||
|
assert.Contains(t, text, "Missing from remote: 1 (5.0 MB)")
|
||||||
|
assert.Contains(t, text, "Snapshots that cannot be restored (blobs missing):\n"+
|
||||||
|
" "+brokenKey+"\n")
|
||||||
|
assert.NotContains(t, text, snapshot.RemoteSnapshotKey(listLocalID)+"\n")
|
||||||
|
|
||||||
|
env.stdout.Reset()
|
||||||
|
require.ErrorContains(t, env.v.RemoteInfo(true), wantError)
|
||||||
|
|
||||||
|
var doc map[string]any
|
||||||
|
|
||||||
|
require.NoError(t, json.Unmarshal(env.stdout.Bytes(), &doc))
|
||||||
|
assert.InDelta(t, 1, doc["missing_blob_count"], 0)
|
||||||
|
assert.InDelta(t, fiveMegabytes, doc["missing_blob_size"], 0)
|
||||||
|
assert.Equal(t, []any{brokenKey}, doc["snapshots_missing_blobs"])
|
||||||
|
|
||||||
|
// --quiet drops the report, not the failure.
|
||||||
|
env.stdout.Reset()
|
||||||
|
env.v.UI.SetQuiet(true)
|
||||||
|
require.ErrorContains(t, env.v.RemoteInfo(false), wantError)
|
||||||
|
assert.Empty(t, env.stdout.String())
|
||||||
|
env.v.UI.SetQuiet(false)
|
||||||
|
|
||||||
|
// With blob A stored again nothing is missing.
|
||||||
|
addBlob(t, env.store.testStorer, testBlobHashA)
|
||||||
|
env.stdout.Reset()
|
||||||
|
require.NoError(t, env.v.RemoteInfo(true))
|
||||||
|
|
||||||
|
doc = nil
|
||||||
|
require.NoError(t, json.Unmarshal(env.stdout.Bytes(), &doc))
|
||||||
|
assert.InDelta(t, 0, doc["missing_blob_count"], 0)
|
||||||
|
assert.InDelta(t, 0, doc["missing_blob_size"], 0)
|
||||||
|
assert.NotContains(t, doc, "snapshots_missing_blobs")
|
||||||
|
}
|
||||||
@@ -33,7 +33,6 @@ var (
|
|||||||
"creating a snapshot needs at least one public key in " +
|
"creating a snapshot needs at least one public key in " +
|
||||||
"age_recipients (generate a keypair with: age-keygen)")
|
"age_recipients (generate a keypair with: age-keygen)")
|
||||||
errKeepNewerThanNeedsPrune = errors.New("--keep-newer-than requires --prune")
|
errKeepNewerThanNeedsPrune = errors.New("--keep-newer-than requires --prune")
|
||||||
errDryRunWithPrune = errors.New("--dry-run cannot be used with --prune")
|
|
||||||
)
|
)
|
||||||
|
|
||||||
// ErrPostBackupPruneFailed wraps a failure of the post-backup prune,
|
// ErrPostBackupPruneFailed wraps a failure of the post-backup prune,
|
||||||
@@ -78,24 +77,12 @@ type SnapshotCreateOptions struct {
|
|||||||
KeepNewerThan string
|
KeepNewerThan string
|
||||||
SkipErrors bool // Skip file read errors (log them loudly but continue)
|
SkipErrors bool // Skip file read errors (log them loudly but continue)
|
||||||
Snapshots []string // Optional list of snapshot names to process (empty = all)
|
Snapshots []string // Optional list of snapshot names to process (empty = all)
|
||||||
// DryRun scans the snapshot source paths and prints what a backup
|
|
||||||
// would store, writing nothing to the local index or the backup
|
|
||||||
// destination store.
|
|
||||||
DryRun bool
|
|
||||||
// ListExcluded makes a dry run print each excluded entry and the
|
|
||||||
// exclude pattern that matched it. A backup ignores it.
|
|
||||||
ListExcluded bool
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Validate fails when DryRun is set with Prune, or when KeepNewerThan is
|
// Validate fails when KeepNewerThan is set without Prune or is not a
|
||||||
// set without Prune or is not a valid duration. Only the post-backup
|
// valid duration. Only the post-backup prune reads KeepNewerThan, after
|
||||||
// prune reads KeepNewerThan, after the backup, so the caller checks it
|
// the backup, so the caller checks it before starting one.
|
||||||
// before starting one.
|
|
||||||
func (opts *SnapshotCreateOptions) Validate() error {
|
func (opts *SnapshotCreateOptions) Validate() error {
|
||||||
if opts.DryRun && opts.Prune {
|
|
||||||
return errDryRunWithPrune
|
|
||||||
}
|
|
||||||
|
|
||||||
if opts.KeepNewerThan == "" {
|
if opts.KeepNewerThan == "" {
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
@@ -120,10 +107,6 @@ func (v *Vaultik) CreateSnapshot(opts *SnapshotCreateOptions) error {
|
|||||||
return errNoAgeRecipients
|
return errNoAgeRecipients
|
||||||
}
|
}
|
||||||
|
|
||||||
if opts.DryRun {
|
|
||||||
return v.dryRunSnapshots(opts)
|
|
||||||
}
|
|
||||||
|
|
||||||
overallStartTime := time.Now()
|
overallStartTime := time.Now()
|
||||||
|
|
||||||
log.Info("Starting snapshot creation",
|
log.Info("Starting snapshot creation",
|
||||||
@@ -375,9 +358,6 @@ type snapshotStats struct {
|
|||||||
// could not be read or listed.
|
// could not be read or listed.
|
||||||
totalFilesUnreadable int
|
totalFilesUnreadable int
|
||||||
|
|
||||||
// The entries the scan excluded; an excluded directory counts once.
|
|
||||||
totalEntriesExcluded int
|
|
||||||
|
|
||||||
// The configured paths in which the scan found nothing.
|
// The configured paths in which the scan found nothing.
|
||||||
emptyPaths []string
|
emptyPaths []string
|
||||||
|
|
||||||
@@ -391,29 +371,6 @@ type snapshotStats struct {
|
|||||||
blobUncompressedSize int64
|
blobUncompressedSize int64
|
||||||
}
|
}
|
||||||
|
|
||||||
// add adds the result of scanning the configured path dir to the totals.
|
|
||||||
func (stats *snapshotStats) add(dir string, result *snapshot.ScanResult) {
|
|
||||||
stats.totalFiles += result.FilesScanned
|
|
||||||
stats.totalBytes += result.BytesScanned
|
|
||||||
stats.totalChunks += result.ChunksCreated
|
|
||||||
stats.newChunkSize += result.NewChunkSize
|
|
||||||
stats.totalBlobs += result.BlobsCreated
|
|
||||||
stats.totalFilesSkipped += result.FilesSkipped
|
|
||||||
stats.totalFilesFailed += result.FilesFailed
|
|
||||||
stats.totalFilesUnreadable += result.FilesUnreadable
|
|
||||||
stats.totalBytesSkipped += result.BytesSkipped
|
|
||||||
stats.totalFilesDeleted += result.FilesDeleted
|
|
||||||
stats.totalBytesDeleted += result.BytesDeleted
|
|
||||||
stats.totalBlobsUploaded += result.BlobsUploaded
|
|
||||||
stats.totalBytesUploaded += result.BytesUploaded
|
|
||||||
stats.uploadDuration += result.UploadDuration
|
|
||||||
stats.totalEntriesExcluded += result.EntriesExcluded
|
|
||||||
|
|
||||||
if result.EntriesFound == 0 {
|
|
||||||
stats.emptyPaths = append(stats.emptyPaths, dir)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// createNamedSnapshot creates a single named snapshot and returns the
|
// createNamedSnapshot creates a single named snapshot and returns the
|
||||||
// statistics of its scan.
|
// statistics of its scan.
|
||||||
func (v *Vaultik) createNamedSnapshot(
|
func (v *Vaultik) createNamedSnapshot(
|
||||||
@@ -607,7 +564,24 @@ func (v *Vaultik) scanAllDirectories(
|
|||||||
return nil, fmt.Errorf("failed to scan %s: %w", dir, err)
|
return nil, fmt.Errorf("failed to scan %s: %w", dir, err)
|
||||||
}
|
}
|
||||||
|
|
||||||
stats.add(dir, result)
|
stats.totalFiles += result.FilesScanned
|
||||||
|
stats.totalBytes += result.BytesScanned
|
||||||
|
stats.totalChunks += result.ChunksCreated
|
||||||
|
stats.newChunkSize += result.NewChunkSize
|
||||||
|
stats.totalBlobs += result.BlobsCreated
|
||||||
|
stats.totalFilesSkipped += result.FilesSkipped
|
||||||
|
stats.totalFilesFailed += result.FilesFailed
|
||||||
|
stats.totalFilesUnreadable += result.FilesUnreadable
|
||||||
|
stats.totalBytesSkipped += result.BytesSkipped
|
||||||
|
stats.totalFilesDeleted += result.FilesDeleted
|
||||||
|
stats.totalBytesDeleted += result.BytesDeleted
|
||||||
|
stats.totalBlobsUploaded += result.BlobsUploaded
|
||||||
|
stats.totalBytesUploaded += result.BytesUploaded
|
||||||
|
stats.uploadDuration += result.UploadDuration
|
||||||
|
|
||||||
|
if result.EntriesFound == 0 {
|
||||||
|
stats.emptyPaths = append(stats.emptyPaths, dir)
|
||||||
|
}
|
||||||
|
|
||||||
log.Info("Directory scan complete",
|
log.Info("Directory scan complete",
|
||||||
"path", dir,
|
"path", dir,
|
||||||
|
|||||||
@@ -1,133 +0,0 @@
|
|||||||
package vaultik
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
|
|
||||||
"sneak.berlin/go/vaultik/internal/snapshot"
|
|
||||||
)
|
|
||||||
|
|
||||||
// dryRunSnapshots scans the source paths of each snapshot named in
|
|
||||||
// opts, or of every configured one, and prints what a backup would
|
|
||||||
// store. It writes nothing to the local index or the backup destination
|
|
||||||
// store. It first makes the read-only checks a backup makes, so it fails
|
|
||||||
// where a backup would: a local index bound to a different destination,
|
|
||||||
// or a destination that answers it has no marker while the local index
|
|
||||||
// holds snapshots stored there.
|
|
||||||
func (v *Vaultik) dryRunSnapshots(opts *SnapshotCreateOptions) error {
|
|
||||||
err := v.checkStorageBinding()
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
err = v.checkDestinationMarker()
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// A backup first drops incomplete snapshots and the file records only
|
|
||||||
// they list (PruneDatabase), so it backs up those files again; the
|
|
||||||
// dry run counts them as unchanged.
|
|
||||||
incomplete, err := v.Repositories.Snapshots.GetIncompleteSnapshots(v.ctx)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("getting incomplete snapshots: %w", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(incomplete) > 0 {
|
|
||||||
v.UI.Noticef("The local index holds %s incomplete snapshot(s) from "+
|
|
||||||
"an interrupted backup. The next backup drops them first and may "+
|
|
||||||
"back up more files than this dry run counts.",
|
|
||||||
v.UI.Count(len(incomplete)))
|
|
||||||
}
|
|
||||||
|
|
||||||
snapshotNames, err := v.snapshotNamesToCreate(opts.Snapshots)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, snapName := range snapshotNames {
|
|
||||||
err = v.dryRunSnapshot(opts, snapName)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// dryRunSnapshot scans the source paths of the snapshot named snapName
|
|
||||||
// and prints what a backup of it would store.
|
|
||||||
func (v *Vaultik) dryRunSnapshot(
|
|
||||||
opts *SnapshotCreateOptions, snapName string,
|
|
||||||
) error {
|
|
||||||
resolvedDirs, err := v.resolveSnapshotPaths(snapName)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
previousSnapshotID, err := v.previousSnapshotID(snapName)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
scanner := v.ScannerFactory(snapshot.ScannerParams{
|
|
||||||
UI: v.UI,
|
|
||||||
Fs: v.Fs,
|
|
||||||
Exclude: v.Config.GetExcludes(snapName),
|
|
||||||
SkipErrors: opts.SkipErrors,
|
|
||||||
PreviousSnapshotID: previousSnapshotID,
|
|
||||||
})
|
|
||||||
|
|
||||||
v.UI.Beginf("Dry run of snapshot %s.", snapName)
|
|
||||||
|
|
||||||
stats := &snapshotStats{}
|
|
||||||
|
|
||||||
for i, dir := range resolvedDirs {
|
|
||||||
v.UI.Beginf("Enumerating snapshot source files in %s (%d of %d).",
|
|
||||||
v.UI.Path(dir), i+1, len(resolvedDirs))
|
|
||||||
|
|
||||||
result, err := scanner.DryRun(v.ctx, dir, opts.ListExcluded)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("failed to scan %s: %w", dir, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
stats.add(dir, result)
|
|
||||||
}
|
|
||||||
|
|
||||||
v.printDryRunSummary(snapName, stats)
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// printDryRunSummary prints what a backup of the snapshot named snapName
|
|
||||||
// would store, in the terms of printSnapshotSummary.
|
|
||||||
func (v *Vaultik) printDryRunSummary(snapName string, stats *snapshotStats) {
|
|
||||||
filesToBackUp := stats.totalFiles - stats.totalFilesSkipped -
|
|
||||||
stats.totalFilesFailed
|
|
||||||
|
|
||||||
v.UI.Completef("Dry run of snapshot %s complete; nothing was stored.",
|
|
||||||
snapName)
|
|
||||||
|
|
||||||
filesMsg := fmt.Sprintf("Files: %s examined, %s to back up, %s unchanged",
|
|
||||||
v.UI.Count(stats.totalFiles),
|
|
||||||
v.UI.Count(filesToBackUp),
|
|
||||||
v.UI.Count(stats.totalFilesSkipped))
|
|
||||||
if stats.totalFilesFailed > 0 {
|
|
||||||
filesMsg += fmt.Sprintf(", %s failed", v.UI.Count(stats.totalFilesFailed))
|
|
||||||
}
|
|
||||||
|
|
||||||
if stats.totalFilesDeleted > 0 {
|
|
||||||
filesMsg += fmt.Sprintf(", %s deleted", v.UI.Count(stats.totalFilesDeleted))
|
|
||||||
}
|
|
||||||
|
|
||||||
v.UI.Detailf("%s.", filesMsg)
|
|
||||||
|
|
||||||
dataMsg := fmt.Sprintf("Data: %s total (%s to back up)",
|
|
||||||
v.UI.Size(stats.totalBytes+stats.totalBytesSkipped),
|
|
||||||
v.UI.Size(stats.totalBytes))
|
|
||||||
if stats.totalBytesDeleted > 0 {
|
|
||||||
dataMsg += fmt.Sprintf(", %s deleted", v.UI.Size(stats.totalBytesDeleted))
|
|
||||||
}
|
|
||||||
|
|
||||||
v.UI.Detailf("%s.", dataMsg)
|
|
||||||
v.UI.Detailf("Excluded: %s entries.", v.UI.Count(stats.totalEntriesExcluded))
|
|
||||||
}
|
|
||||||
@@ -1,69 +0,0 @@
|
|||||||
package vaultik_test
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"os"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"github.com/stretchr/testify/assert"
|
|
||||||
"github.com/stretchr/testify/require"
|
|
||||||
"sneak.berlin/go/vaultik/internal/vaultik"
|
|
||||||
)
|
|
||||||
|
|
||||||
// dryRunSnapshotName is the newSummaryEnv snapshot the dry run test
|
|
||||||
// backs up and then dry-runs.
|
|
||||||
const dryRunSnapshotName = "first"
|
|
||||||
|
|
||||||
// TestDryRunCountsWhatABackupWouldStore runs a dry run after a backup:
|
|
||||||
// the unchanged files count as unchanged, a rewritten one as to back up,
|
|
||||||
// and the dry run records no snapshot. See
|
|
||||||
// https://git.eeqj.de/sneak/vaultik/issues/436.
|
|
||||||
func TestDryRunCountsWhatABackupWouldStore(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newSummaryEnv(t)
|
|
||||||
env.backUp(t, dryRunSnapshotName, false)
|
|
||||||
|
|
||||||
dryRun := func() string {
|
|
||||||
env.out.Reset()
|
|
||||||
require.NoError(t, env.v.CreateSnapshot(&vaultik.SnapshotCreateOptions{
|
|
||||||
DryRun: true,
|
|
||||||
Snapshots: []string{dryRunSnapshotName},
|
|
||||||
}))
|
|
||||||
|
|
||||||
return env.out.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
assert.Contains(t, dryRun(),
|
|
||||||
"Files: 3 examined, 0 to back up, 3 unchanged.")
|
|
||||||
|
|
||||||
require.NoError(t, os.WriteFile(env.aPath, []byte("rewritten"), 0o600))
|
|
||||||
|
|
||||||
assert.Contains(t, dryRun(),
|
|
||||||
"Files: 3 examined, 1 to back up, 2 unchanged.")
|
|
||||||
|
|
||||||
// localSnapshotID fails unless exactly one snapshot has the name.
|
|
||||||
localSnapshotID(context.Background(), t, env.repos, dryRunSnapshotName)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestDryRunNamesIncompleteSnapshots checks that a dry run says so when
|
|
||||||
// the local index holds an incomplete snapshot, which the next backup
|
|
||||||
// drops before it scans.
|
|
||||||
func TestDryRunNamesIncompleteSnapshots(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newSummaryEnv(t)
|
|
||||||
env.backUp(t, dryRunSnapshotName, false)
|
|
||||||
|
|
||||||
_, err := env.v.SnapshotManager.CreateSnapshotWithName(
|
|
||||||
context.Background(), testHostname, "split", "v", "g")
|
|
||||||
require.NoError(t, err)
|
|
||||||
|
|
||||||
env.out.Reset()
|
|
||||||
require.NoError(t, env.v.CreateSnapshot(&vaultik.SnapshotCreateOptions{
|
|
||||||
DryRun: true,
|
|
||||||
Snapshots: []string{dryRunSnapshotName},
|
|
||||||
}))
|
|
||||||
assert.Contains(t, env.out.String(),
|
|
||||||
"The local index holds 1 incomplete snapshot(s)")
|
|
||||||
}
|
|
||||||
@@ -349,6 +349,7 @@ func TestSnapshotListAndPurgePrintSizesLikeRemoteInfo(t *testing.T) {
|
|||||||
env.addRemote(t, listLocalID, start)
|
env.addRemote(t, listLocalID, start)
|
||||||
require.NoError(t, env.v.Repositories.Snapshots.UpdateCounts(
|
require.NoError(t, env.v.Repositories.Snapshots.UpdateCounts(
|
||||||
context.Background(), nil, listLocalID, 0, 0, 0, 0, fiveMegabytes))
|
context.Background(), nil, listLocalID, 0, 0, 0, 0, fiveMegabytes))
|
||||||
|
addBlob(t, env.store.testStorer, testBlobHashA)
|
||||||
|
|
||||||
require.NoError(t, env.v.RemoteInfo(false))
|
require.NoError(t, env.v.RemoteInfo(false))
|
||||||
assert.Contains(t, findTableRow(t, env.stdout.String(), remoteKey[:16]),
|
assert.Contains(t, findTableRow(t, env.stdout.String(), remoteKey[:16]),
|
||||||
|
|||||||
Reference in new issue
Block a user