forked from TrueCloudLab/restic
doc: Polish changelog
This commit is contained in:
Leo R. Lundgren
Michael Eischer
parent
e998314088
commit
51e4e5ef82
22 changed files with 77 additions and 73 deletions
|
|
@ -1,7 +1,7 @@
|
|||
Enhancement: Snapshots are sorted by timestamp in the output of `restic find`
|
||||
Enhancement: Sort snapshots by timestamp in `restic find`
|
||||
|
||||
The `find` command printed snapshots in an arbitrary order. Now restic prints
|
||||
the snapshots sorted by timestamp.
|
||||
The `find` command used to print snapshots in an arbitrary order. Restic now
|
||||
prints snapshots sorted by timestamp.
|
||||
|
||||
https://github.com/restic/restic/issues/1495
|
||||
https://github.com/restic/restic/pull/4409
|
||||
|
|
|
|||
|
|
@ -4,12 +4,13 @@ The `rebuild-index` command has been renamed to `repair index`. The old name
|
|||
will still work, but is deprecated.
|
||||
|
||||
When a snapshot was damaged, the only option up to now was to completely forget
|
||||
the snapshot, even if only some unimportant file was damaged.
|
||||
the snapshot, even if only some unimportant files in it were damaged and other
|
||||
files were still fine.
|
||||
|
||||
We've added a `repair snapshots` command, which can repair snapshots by removing
|
||||
damaged directories and missing files contents. Note that using this command
|
||||
can lead to (limited) data loss! Please see the "Troubleshooting" section in the
|
||||
documentation for more details.
|
||||
Restic now has a `repair snapshots` command, which can salvage any non-damaged
|
||||
files and parts of files in the snapshots by removing damaged directories and
|
||||
missing file contents. Please note that the damaged data may still be lost
|
||||
and see the "Troubleshooting" section in the documentation for more details.
|
||||
|
||||
https://github.com/restic/restic/issues/1759
|
||||
https://github.com/restic/restic/issues/1714
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
Enhancement: Certificates can be passed through environment variables
|
||||
Enhancement: Allow certificate paths to be passed through environment variables
|
||||
|
||||
Restic will now read the paths to the certificates from the environment
|
||||
variables `RESTIC_CACERT` or `RESTIC_TLS_CLIENT_CERT` if `--cacert` or
|
||||
`--tls-client-cert` are not specified.
|
||||
Restic will now read paths to certificates from the environment variables
|
||||
`RESTIC_CACERT` or `RESTIC_TLS_CLIENT_CERT` if `--cacert` or `--tls-client-cert`
|
||||
are not specified.
|
||||
|
||||
https://github.com/restic/restic/issues/1926
|
||||
https://github.com/restic/restic/pull/4384
|
||||
|
|
|
|||
|
|
@ -1,9 +1,9 @@
|
|||
Enhancement: Provide multi-platform Docker containers
|
||||
Enhancement: Provide multi-platform Docker images
|
||||
|
||||
The official Docker containers are now built for the architectures linux/386,
|
||||
The official Docker images are now built for the architectures linux/386,
|
||||
linux/amd64, linux/arm and linux/arm64.
|
||||
|
||||
As an alternative to the Docker Hub, the Docker containers are also
|
||||
As an alternative to the Docker Hub, the Docker images are also
|
||||
available on ghcr.io, the GitHub Container Registry.
|
||||
|
||||
https://github.com/restic/restic/issues/2359
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
Enhancement: Add support for non-global Azure clouds
|
||||
|
||||
Restic backups on Azure only supported storages using the global domain
|
||||
The `azure` backend previously only supported storages using the global domain
|
||||
`core.windows.net`. This meant that backups to other domains such as Azure
|
||||
China (`core.chinacloudapi.cn`) or Azure Germany (`core.cloudapi.de`) were
|
||||
not supported. Restic now allows overriding the global domain using the
|
||||
|
|
|
|||
|
|
@ -1,12 +1,12 @@
|
|||
Bugfix: Support non-UTF8 paths as symlink target
|
||||
|
||||
Restic versions before 0.16.0 did not correctly `backup` and `restore` symlinks
|
||||
that contain a non-UTF8 target. Note that this only affects system that still
|
||||
use a non-Unicode encoding for filesystem paths.
|
||||
Earlier restic versions did not correctly `backup` and `restore` symlinks that
|
||||
contain a non-UTF8 target. Note that this only affected systems that still use
|
||||
a non-Unicode encoding for filesystem paths.
|
||||
|
||||
We have extended the repository format to add support for such symlinks. Please
|
||||
note that at least restic version 0.16.0 must be used for both `backup` and
|
||||
`restore` to correctly handle non-UTF8 symlink targets.
|
||||
The repository format is now extended to add support for such symlinks. Please
|
||||
note that snapshots must have been created with at least restic version 0.16.0
|
||||
for `restore` to correctly handle non-UTF8 symlink targets when restoring them.
|
||||
|
||||
https://github.com/restic/restic/issues/3311
|
||||
https://github.com/restic/restic/pull/3802
|
||||
|
|
|
|||
|
|
@ -1,5 +1,7 @@
|
|||
Enhancement: Reduce memory usage by up to 25%
|
||||
|
||||
The in-memory index has been optimized to be more GC friendly.
|
||||
|
||||
https://github.com/restic/restic/issues/3328
|
||||
https://github.com/restic/restic/pull/4352
|
||||
https://github.com/restic/restic/pull/4353
|
||||
|
|
|
|||
|
|
@ -1,11 +1,11 @@
|
|||
Enhancement: Improve the ETA displayed during backup
|
||||
Enhancement: Improve accuracy of ETA displayed during backup
|
||||
|
||||
Restic's `backup` command displayed an ETA that did not adapt when the rate
|
||||
of progress made during the backup changed during the course of the
|
||||
backup. Restic now uses recent progress when computing the ETA. It is
|
||||
important to realize that the estimate may still be wrong, because restic
|
||||
cannot predict the future, but the hope is that the ETA will be more
|
||||
accurate in most cases.
|
||||
Restic's `backup` command displayed an ETA that did not adapt when the rate of
|
||||
progress made during the backup changed during the course of the backup.
|
||||
|
||||
Restic now uses recent progress when computing the ETA. It is important to
|
||||
realize that the estimate may still be wrong, because restic cannot predict
|
||||
the future, but the hope is that the ETA will be more accurate in most cases.
|
||||
|
||||
https://github.com/restic/restic/issues/3397
|
||||
https://github.com/restic/restic/pull/3563
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
Enhancement: Keep oldest snapshot when there are not enough snapshots
|
||||
|
||||
The `forget` command now additionally preserves the oldest snapshot if fewer
|
||||
snapshots are kept than allowed by the `--keep-*` parameters. This maximizes
|
||||
amount of history kept while the specified limits are not yet reached.
|
||||
snapshots than allowed by the `--keep-*` parameters would otherwise be kept.
|
||||
This maximizes the amount of history kept within the specified limits.
|
||||
|
||||
https://github.com/restic/restic/issues/3624
|
||||
https://github.com/restic/restic/pull/4366
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
Enhancement: Add support for Managed / Workload Identity to azure backend
|
||||
Enhancement: Add support for Managed / Workload Identity to `azure` backend
|
||||
|
||||
Restic now additionally supports authenticating to Azure using Workload
|
||||
Identity or Managed Identity credentials, which are automatically injected in
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ The commands `diff`, `dump`, `ls` and `restore` now support the
|
|||
`<snapshot>:<subfolder>` syntax, where `snapshot` is the ID of a snapshot (or
|
||||
the string `latest`) and `subfolder` is a path within the snapshot. The
|
||||
commands will then only work with the specified path of the snapshot. The
|
||||
`subfolder` must be a path to a folder as returned by `ls`.
|
||||
`subfolder` must be a path to a folder as returned by `ls`. Two examples:
|
||||
|
||||
`restic restore -t target latest:/some/path`
|
||||
`restic diff 12345678:/some/path 90abcef:/some/path`
|
||||
|
|
|
|||
|
|
@ -1,15 +1,16 @@
|
|||
Enhancement: Support `--group-by` for backup parent selection
|
||||
|
||||
The `backup` command by default selected the parent snapshot based on the hostname
|
||||
and the backup targets. When the backup path list changed, the `backup` command
|
||||
was unable to determine a suitable parent snapshot and had to read all
|
||||
files again.
|
||||
Previously, the `backup` command by default selected the parent snapshot based
|
||||
on the hostname and the backup targets. When the backup path list changed, the
|
||||
`backup` command was unable to determine a suitable parent snapshot and had to
|
||||
read all files again.
|
||||
|
||||
The new `--group-by` option for the `backup` command allows filtering snapshots
|
||||
for the parent selection by `host`, `paths` and `tags`. It defaults to
|
||||
`host,paths` which selects the latest snapshot with hostname and paths matching
|
||||
those of the backup run. This matches the behavior of prior restic versions.
|
||||
The `--group-by` option should be set to the same value as passed to
|
||||
|
||||
The new `--group-by` option should be set to the same value as passed to
|
||||
`forget --group-by`.
|
||||
|
||||
https://github.com/restic/restic/issues/3941
|
||||
|
|
|
|||
|
|
@ -1,8 +1,9 @@
|
|||
Enhancement: Cancel current command if cache becomes unusable
|
||||
|
||||
If the cache directory was removed or ran out of space while restic was
|
||||
running, this caused further caching attempts to fail and drastically slow down
|
||||
the command execution. Now, the currently running command is canceled instead.
|
||||
running, this would previously cause further caching attempts to fail and
|
||||
thereby drastically slow down the command execution. Now, the currently running
|
||||
command is instead canceled.
|
||||
|
||||
https://github.com/restic/restic/issues/4130
|
||||
https://github.com/restic/restic/pull/4166
|
||||
|
|
|
|||
|
|
@ -1,13 +1,12 @@
|
|||
Enhancement: Add `--human-readable` option to `ls` and `find` commands
|
||||
|
||||
Previously, when using the `-l` option with the `ls` and `find` commands,
|
||||
the displayed size was always in bytes, without an option for a more
|
||||
human readable format such as MiB or GiB.
|
||||
Previously, when using the `-l` option with the `ls` and `find` commands, the
|
||||
displayed size was always in bytes, without an option for a more human readable
|
||||
format such as MiB or GiB.
|
||||
|
||||
The new `--human-readable` option will convert longer size values into
|
||||
more human friendly values with an appropriate suffix depending on the
|
||||
output size. For example, a size of `14680064` will be shown as
|
||||
`14.000 MiB`.
|
||||
The new `--human-readable` option will convert longer size values into more
|
||||
human friendly values with an appropriate suffix depending on the output size.
|
||||
For example, a size of `14680064` will be shown as `14.000 MiB`.
|
||||
|
||||
https://github.com/restic/restic/issues/4159
|
||||
https://github.com/restic/restic/pull/4351
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
Enhancement: `backup` includes restic version in snapshot metadata
|
||||
Enhancement: Include restic version in snapshot metadata
|
||||
|
||||
The restic version used to backup a snapshot is now included in its metadata.
|
||||
The program version is shown when inspecting a snapshot using `restic cat
|
||||
snapshot <snapshotID>` or `restic snapshots --json`.
|
||||
The restic version used to backup a snapshot is now included in its metadata
|
||||
and shown when inspecting a snapshot using `restic cat snapshot <snapshotID>`
|
||||
or `restic snapshots --json`.
|
||||
|
||||
https://github.com/restic/restic/issues/4188
|
||||
https://github.com/restic/restic/pull/4378
|
||||
|
|
|
|||
|
|
@ -1,8 +1,9 @@
|
|||
Bugfix: Avoid lock refresh issues with slow network connections
|
||||
Bugfix: Avoid lock refresh issues on slow network connections
|
||||
|
||||
On network connections with a low upload speed, restic could often fail
|
||||
backups and other operations with `Fatal: failed to refresh lock in time`.
|
||||
We've reworked the lock refresh to avoid this error.
|
||||
On network connections with a low upload speed, backups and other operations
|
||||
could fail with the error message `Fatal: failed to refresh lock in time`.
|
||||
|
||||
This has now been fixed by reworking the lock refresh handling.
|
||||
|
||||
https://github.com/restic/restic/issues/4199
|
||||
https://github.com/restic/restic/pull/4304
|
||||
|
|
|
|||
|
|
@ -1,10 +1,11 @@
|
|||
Bugfix: Improve lock refresh handling when using standby
|
||||
Bugfix: Improve lock refresh handling after standby
|
||||
|
||||
If the restic process was stopped or the host running restic entered standby
|
||||
during a long running operation such as a backup, this resulted in the
|
||||
operation failing with `Fatal: failed to refresh lock in time`. We've reworked
|
||||
the lock refresh such that restic first checks whether it is safe to continue
|
||||
the current operation and only throws an error if not.
|
||||
during a long running operation such as a backup, this previously resulted in
|
||||
the operation failing with `Fatal: failed to refresh lock in time`.
|
||||
|
||||
This has now been fixed such that restic first checks whether it is safe to
|
||||
continue the current operation and only throws an error if not.
|
||||
|
||||
https://github.com/restic/restic/issues/4274
|
||||
https://github.com/restic/restic/pull/4374
|
||||
|
|
|
|||
|
|
@ -2,8 +2,6 @@ Change: Require Go 1.20 for Solaris builds
|
|||
|
||||
Building restic on Solaris now requires Go 1.20, as the library used to access
|
||||
Azure uses the mmap syscall, which is only available on Solaris starting from
|
||||
Go 1.20.
|
||||
|
||||
All other platforms continue to build with Go 1.18.
|
||||
Go 1.20. All other platforms however continue to build with Go 1.18.
|
||||
|
||||
https://github.com/restic/restic/pull/4201
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
Enhancement: Add `jq` binary to container image
|
||||
Enhancement: Add `jq` binary to Docker image
|
||||
|
||||
The Docker container image now contains `jq`, which can be useful to process
|
||||
JSON data output by restic.
|
||||
The Docker image now contains `jq`, which can be useful to process JSON data
|
||||
output by restic.
|
||||
|
||||
https://github.com/restic/restic/pull/4220
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
Enhancement: Allow specifying the region of new buckets in the gs backend
|
||||
Enhancement: Allow specifying region of new buckets in the `gs` backend
|
||||
|
||||
Buckets used by the Google Cloud Storage backend would always get created in
|
||||
the "us" region. It is now possible to specify the region where a bucket
|
||||
should be created by using the `-o gs.region=us` option.
|
||||
Previously, buckets used by the Google Cloud Storage backend would always get
|
||||
created in the "us" region. It is now possible to specify the region where a
|
||||
bucket should be created by using the `-o gs.region=us` option.
|
||||
|
||||
https://github.com/restic/restic/pull/4226
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@ Bugfix: Correctly clean up status bar output of the `backup` command
|
|||
|
||||
Due to a regression in restic 0.15.2, the status bar of the `backup` command
|
||||
could leave some output behind. This happened if filenames were printed that
|
||||
are wider than the current terminal width. This has been fixed.
|
||||
are wider than the current terminal width. This has now been fixed.
|
||||
|
||||
https://github.com/restic/restic/issues/4319
|
||||
https://github.com/restic/restic/pull/4318
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
Bugfix: Ignore missing folders in REST backend
|
||||
Bugfix: Ignore missing folders in `rest` backend
|
||||
|
||||
If a repository accessed via the REST backend was missing folders, then restic
|
||||
would fail with an error while trying to list the data in the repository. This
|
||||
has been fixed.
|
||||
has been now fixed.
|
||||
|
||||
https://github.com/restic/restic/pull/4400
|
||||
https://github.com/restic/rest-server/issues/235
|
||||
|
|
|
|||
Loading…
Reference in a new issue