witten
released this
2022-08-25 18:58:06 +00:00
| 1952 commits to main since this release
#542: Make the "source_directories" option optional. This is useful for "check"-only setups or
using "patterns" exclusively.
#574: Fix for potential data loss (data not getting backed up) when the "patterns" option was
used with "source_directories" (or the "~/.borgmatic" path existed, which got injected into
"source_directories" implicitly). The fix is for borgmatic to convert "source_directories" into
patterns whenever "patterns" is used, working around a potential Borg bug: https://github.com/borgbackup/borg/issues/6994
witten
released this
2022-08-22 04:54:13 +00:00
| 1957 commits to main since this release
#463: Add "before_actions" and "after_actions" command hooks that run before/after all the
actions for each repository. These new hooks are a good place to run per-repository steps like
mounting/unmounting a remote filesystem.
#557: Support for Borg 2 while still working with Borg 1. This includes new borgmatic actions
like "rcreate" (replaces "init"), "rlist" (list archives in repository), "rinfo" (show repository
info), and "transfer" (for upgrading Borg repositories). For the most part, borgmatic tries to
smooth over differences between Borg 1 and 2 to make your upgrade process easier. However, there
are still a few cases where Borg made breaking changes. See the Borg 2.0 changelog for more
information: https://www.borgbackup.org/releases/borg-2.0.html
#557: If you install Borg 2, you'll need to manually upgrade your existing Borg 1 repositories
before use. Note that Borg 2 stable is not yet released as of this borgmatic release, so don't
use Borg 2 for production until it is! See the documentation for more information: https://torsion.org/borgmatic/docs/how-to/upgrade/#upgrading-borg
#557: Rename several configuration options to match Borg 2: "remote_rate_limit" is now
"upload_rate_limit", "numeric_owner" is "numeric_ids", and "bsd_flags" is "flags". borgmatic
still works with the old options.
#557: Remote repository paths without the "ssh://" syntax are deprecated but still supported for
now. Remote repository paths containing "~" are deprecated in borgmatic and no longer work in
Borg 2.
#557: Omitting the "--archive" flag on the "list" action is deprecated when using Borg 2. Use
the new "rlist" action instead.
#557: The "--dry-run" flag can now be used with the "rcreate"/"init" action.
#565: Fix handling of "repository" and "data" consistency checks to prevent invalid Borg flags.
#566: Modify "mount" and "extract" actions to require the "--repository" flag when multiple
repositories are configured.
#571: BREAKING: Remove old-style command-line action flags like "--create, "--list", etc. If
you're already using actions like "create" and "list" instead, this change should not affect you.
#571: BREAKING: Rename "--files" flag on "prune" action to "--list", as it lists archives, not
files.
#571: Add "--list" as alias for "--files" flag on "create" and "export-tar" actions.
Add support for disabling TLS verification in Healthchecks monitoring hook with "verify_tls"
option.
witten
released this
2022-07-01 05:14:41 +00:00
| 2010 commits to main since this release
#553: Fix logging to include the full traceback when Borg experiences an internal error, not just
the first few lines.
#554: Fix all monitoring hooks to warn if the server returns an HTTP 4xx error. This can happen
with Healthchecks, for instance, when using an invalid ping URL.
#555: Fix environment variable plumbing so options like "encryption_passphrase" and
"encryption_passcommand" in one configuration file aren't used for other configuration files.
#536: Fix generate-borgmatic-config to support more complex schema changes like the new
Healthchecks configuration options when the "--source" flag is used.
#538: Add support for "borgmatic borg debug" command.
#539: Add "generate-borgmatic-config --overwrite" flag to replace an existing destination file.
witten
released this
2022-05-24 23:22:37 +00:00
| 2069 commits to main since this release
#294: Add Healthchecks monitoring hook "ping_body_limit" option to configure how many bytes of
logs to send to the Healthchecks server.
#402: Remove the error when "archive_name_format" is specified but a retention prefix isn't.
#420: Warn when an unsupported variable is used in a hook command.
#439: Change connection failures for monitoring hooks (Healthchecks, Cronitor, PagerDuty, and
Cronhub) to be warnings instead of errors. This way, the monitoring system failing does not block
backups.
#460: Add Healthchecks monitoring hook "send_logs" option to enable/disable sending borgmatic
logs to the Healthchecks server.
#525: Add Healthchecks monitoring hook "states" option to only enable pinging for particular
monitoring states (start, finish, fail).
#528: Improve the error message when a configuration override contains an invalid value.
#531: BREAKING: When deep merging common configuration, merge colliding list values by appending
them. Previously, one list replaced the other.
#532: When a configuration include is a relative path, load it from either the current working
directory or from the directory containing the file doing the including. Previously, only the
working directory was used.
Add a randomized delay to the sample systemd timer to spread out the load on a server.
Change the configuration format for borgmatic monitoring hooks (Healthchecks, Cronitor,
PagerDuty, and Cronhub) to specify the ping URL / integration key as a named option. The intent
is to support additional options (some in this release). This change is backwards-compatible.
Add emojis to documentation table of contents to make it easier to find particular how-to and
reference guides at a glance.
#473: BREAKING: Instead of executing "before" command hooks before all borgmatic actions run (and
"after" hooks after), execute these hooks right before/after the corresponding action. E.g.,
"before_check" now runs immediately before the "check" action. This better supports running
timing-sensitive tasks like pausing containers. Side effect: before/after command hooks now run
once for each configured repository instead of once per configuration file. Additionally, the
"repositories" interpolated variable has been changed to "repository", containing the path to the
current repository for the hook. See the documentation for more information: https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
#513: Add mention of sudo's "secure_path" option to borgmatic installation documentation.
#515: Fix "borgmatic borg key ..." to pass parameters to Borg in the correct order.
#516: Fix handling of TERM signal to exit borgmatic, not just forward the signal to Borg.
#517: Fix borgmatic exit code (so it's zero) when initial Borg calls fail but later retries
succeed.
Change Healthchecks logs truncation size from 10k bytes to 100k bytes, corresponding to that
same change on Healthchecks.io.
witten
released this
2022-03-14 20:43:24 +00:00
| 2111 commits to main since this release
#431: Add "working_directory" option to support source directories with relative paths.
#444: When loading a configuration file that is unreadable due to file permissions, warn instead
of erroring. This supports running borgmatic as a non-root user with configuration in ~/.config
even if there is an unreadable global configuration file in /etc.
#486: Fix handling of "patterns_from" and "exclude_from" options to error instead of warning when
referencing unreadable files and "create" action is run.
#507: Fix Borg usage error in the "compact" action when running "borgmatic --dry-run". Now, skip
"compact" entirely during a dry run.
witten released this