mirror of
https://github.com/offen/docker-volume-backup.git
synced 2024-11-22 21:30:28 +01:00
Frederik Ring
3d7677f02a
* Print context in log field instead of prepending to message * Log messages on pruning do not need a description anymore * Remove redundant information from logs and errors
61 lines
1.8 KiB
Go
61 lines
1.8 KiB
Go
// Copyright 2022 - Offen Authors <hioffen@posteo.de>
|
|
// SPDX-License-Identifier: MPL-2.0
|
|
|
|
package storage
|
|
|
|
import (
|
|
"time"
|
|
)
|
|
|
|
// Backend is an interface for defining functions which all storage providers support.
|
|
type Backend interface {
|
|
Copy(file string) error
|
|
Prune(deadline time.Time, pruningPrefix string) (*PruneStats, error)
|
|
Name() string
|
|
}
|
|
|
|
// StorageBackend is a generic type of storage. Everything here are common properties of all storage types.
|
|
type StorageBackend struct {
|
|
DestinationPath string
|
|
RetentionDays int
|
|
Log Log
|
|
}
|
|
|
|
type LogLevel int
|
|
|
|
const (
|
|
LogLevelInfo LogLevel = iota
|
|
LogLevelWarning
|
|
LogLevelError
|
|
)
|
|
|
|
type Log func(logType LogLevel, context string, msg string, params ...any)
|
|
|
|
// PruneStats is a wrapper struct for returning stats after pruning
|
|
type PruneStats struct {
|
|
Total uint
|
|
Pruned uint
|
|
}
|
|
|
|
// DoPrune holds general control flow that applies to any kind of storage.
|
|
// Callers can pass in a thunk that performs the actual deletion of files.
|
|
func (b *StorageBackend) DoPrune(context string, lenMatches, lenCandidates int, doRemoveFiles func() error) error {
|
|
if lenMatches != 0 && lenMatches != lenCandidates {
|
|
if err := doRemoveFiles(); err != nil {
|
|
return err
|
|
}
|
|
b.Log(LogLevelInfo, context,
|
|
"Pruned %d out of %d backups as their age exceeded the configured retention period of %d days.",
|
|
lenMatches,
|
|
lenCandidates,
|
|
b.RetentionDays,
|
|
)
|
|
} else if lenMatches != 0 && lenMatches == lenCandidates {
|
|
b.Log(LogLevelWarning, context, "The current configuration would delete all %d existing backups.", lenMatches)
|
|
b.Log(LogLevelWarning, context, "Refusing to do so, please check your configuration.")
|
|
} else {
|
|
b.Log(LogLevelInfo, context, "None of %d existing backups were pruned.", lenCandidates)
|
|
}
|
|
return nil
|
|
}
|