mirror/kopia
1
0
Fork 0
mirror of https://github.com/kopia/kopia.git synced 2026-02-05 12:13:29 -05:00
Code Issues Packages Projects Releases Wiki Activity

docs(site): Cleaning up Release Notes (#2128)

Browse Source 
* docs(site): Cleaning up Release Notes

I think it will be more efficient if we just direct people to the GitHub releases page for anyone that wants to read release notes. I don't see the need to maintain the same information in two different places, plus this section of the site has not been updated for a while.

* Update _index.md

* Delete v0.4.md

* Delete v0.5.md

* Delete v0.6.md

* Delete v0.7.md

* Delete v0.8.md

* Delete v0.9.md
This commit is contained in:
basldfalksjdf
2022-07-03 22:38:18 -04:00
committed by GitHub
parent 0f6ab64dff
commit 6723efb7b5
7 changed files with 2 additions and 377 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
site/content/docs/Release Notes/_index.md
View File

@@ -1,13 +1,7 @@
---
title: "Release Notes"
linkTitle: "Release Notes"
weight: 1
weight: 6
---
* [0.9](v0.9/) - latest stable release
* [0.8](v0.8/)
* [0.7](v0.7/)
* [0.6](v0.6/)
* [0.5](v0.5/)
* [0.4](v0.4/)
* [0.3](v0.3/)
All release notes are available at [Kopia's Releases page on GitHub](https://github.com/kopia/kopia/releases).

16
site/content/docs/Release Notes/v0.4.md
View File

@@ -1,16 +0,0 @@
---
title: "Kopia v0.4"
linkTitle: "v0.4"
weight: -40
---
### Key Changes
* Add optional flags to override hostname and username when taking snapshot
* Added experimental HTML-based UI (kopia server --ui)
* Added --server-username and --server-password to optionally require basic auth for kopia server
* Added support for uploading compressed objects based on policies
* Added /api/v1/objects/:id that retrieves contents of object given its ID
* Added optional --region parameter to S3 provider
See full change log on [GitHub](https://github.com/kopia/kopia/releases/tag/v0.4.0).

25
site/content/docs/Release Notes/v0.5.md
View File

@@ -1,25 +0,0 @@
---
title: "Kopia v0.5"
linkTitle: "v0.5"
weight: -50
---
### Key Changes
* Creation of both a [governance structure](https://github.com/kopia/kopia/blob/master/GOVERNANCE.md) for Kopia as well as the adoption of a [Code of Conduct](https://github.com/kopia/kopia/blob/master/CODE_OF_CONDUCT.md)
* Addition of better encryption schemes (AES256-GCM-HMAC-SHA256 and CHACHA20-POLY1305-HMAC-SHA256) and deprecation of some weak ciphers.
* Object Storage: Support for Azure Blob and AWS Session Tokens
* [KopiaUI](https://www.youtube.com/watch?v=sHJjSpasWIo) - desktop client that runs kopia in the background allows quick access to UI from system tray
* Robustness testing framework
* Revamped logging of repository layer and made it pluggable
* Refactored hashing, encryption and splitters into separate packages
* Added ability to embed credentials in kopia connection configuration.
* Cleaned up console output to be less noisy
* Build system now supports macOS, Linux and Windows - all CLI binaries and KopiaUI can be built on all the environments.
* Automatic update notification about new Kopia versions available on GitHub
* Improvements to repository maintenance tooling (compaction, garbage collection, verification)
* New policy options to ignore errors when reading files and directories
* Repository now remembers hostname at connection time to prevent spontaneous changes when changing networks
* Lots of improvements to server HTTP API - now supports running over TLS, dynamic ports and using random password
See full change log on [GitHub](https://github.com/kopia/kopia/releases/tag/0.5.2).

75
site/content/docs/Release Notes/v0.6.md
View File

@@ -1,75 +0,0 @@
---
title: "Kopia v0.6"
linkTitle: "v0.6"
weight: -60
---
We are very excited to announce the 0.6 release of Kopia! This is a big milestone on the way to an upcoming 1.0 release and there have not only been a large number of changes across the stack but also growth of the community.
This version brings manny performance, usability and stability improvements listed below, adds supports for new providers and CLI options and introduces major new features described below:
* [Maintenance Tasks](/docs/advanced/maintenance/)
* [Repository Server](/docs/repository-server/)
* [Repository Synchronization](/docs/advanced/synchronization/)
### Upgrade notes
* Upgrading from 0.5.x is supported and should be automatic
* Upgrading from 0.4.0 or earlier is not officially supported, it may work but use at your own risk. It's strongly recommended to create new repository using v0.6.0 and migrate existing snapshots as outlined in the documentation. After v0.6.0 the deprecated encryption and hashing schemes from v0.4.0 will be removed.
### Key Changes
#### Core
* big performance improvements when snapshotting large directories [#331](https://github.com/kopia/kopia/pull/331)
* improvements for dealing with eventually-consistent stores (S3) [#437](https://github.com/kopia/kopia/pull/437)
* GC safety improvements to resolve race condition when content is re-referenced when about to be deleted [#420](https://github.com/kopia/kopia/pull/420)
* added OpenCensus [#339](https://github.com/kopia/kopia/pull/339)
* introduced explicit maintenance operations that perform periodic repository cleanup/compaction [#411](https://github.com/kopia/kopia/pull/411)
* disabled automatic compaction on repository opening - moved to maintenance tasks
* added AsyncWrites to ObjectWriter, which improves performance… [#369](https://github.com/kopia/kopia/pull/369)
* object: ensure that all I objects have a content prefix which improves locality by putting them in q packs
* deduplicate multiple policies for the same source in policy manager, fixes #391
* fixed race condition during Open() where we may read incomplete file
* deprecated NONE algorithm, will not be available for new repositories [#395](https://github.com/kopia/kopia/pull/395)
* server: automatically flush the repository after setting or deleting a policy [#489](https://github.com/kopia/kopia/pull/489)
* snapshot checkpointing [#410](https://github.com/kopia/kopia/pull/410)
* moved creating cache directory from connect to first use [#450](https://github.com/kopia/kopia/pull/450)
* persist relative path to cache if possible, this allows config directory to be partially portable
* server: implemented 'flush' and 'refresh' API
* experimental support for remote repository [#427](https://github.com/kopia/kopia/pull/427)
* repo: refactored public API [#318](https://github.com/kopia/kopia/pull/318)
#### KopiaUI
* support for multiple repositories + portability [#398](https://github.com/kopia/kopia/pull/398)
* highlight snapshot errors [#376](https://github.com/kopia/kopia/pull/376)
#### Providers
* support for gather writes [#373](https://github.com/kopia/kopia/pull/373)
* b2: added provider for backblaze b2
* sftp: add missing options for configuring sftp known_hosts
* s3: add CLI option for disabling tls verification while connecting to s3
* filesystem: added retry which addresses the macOS race condition
#### CLI Improvements
* added flags to control progress output
* 'kopia server' made --ui default [#452](https://github.com/kopia/kopia/pull/452)
* allow override of snapshot start time and end time
* improved 'snapshot delete' usage [#436](https://github.com/kopia/kopia/pull/436)
* Remove legacy flags from snapshot create command [#441](https://github.com/kopia/kopia/pull/441)
* support for zip, tar and tar.gz restore outputs [#482](https://github.com/kopia/kopia/pull/482)
* support for synchronizing repositories [#522](https://github.com/kopia/kopia/pull/522)
* auto-ignore kopia cache directories when creating snapshots [#524](https://github.com/kopia/kopia/pull/524)
#### Infrastructure
* macOS and Windows KopiaUI builds are now signed
* robustness testing framework
* testing: added blob.Storage wrapper that simulates eventual consistency [#434](https://github.com/kopia/kopia/pull/434)
* switched back to using v-prefixed tag names.
* tests: added smoke test that exercises all combinations of encryption and hashing
See full change log on [GitHub](https://github.com/kopia/kopia/releases/tag/v0.6.1).

87
site/content/docs/Release Notes/v0.7.md
View File

@@ -1,87 +0,0 @@
---
title: "Kopia v0.7"
linkTitle: "v0.7"
weight: -70
---
## Functional changes in v0.7.3
* Improved restore performance (added parallelism)
* Fixes for restoring symlinks
* Added --force-color and --disable-color flags
* Cleaned up console log output (removed timestamp by default, module) and refactored most output to use logger, so it can be controlled with flags. With this it's now possible to have zero-output snapshot command suitable for crontab: `kopia snapshot create --all --log-level=warning --no-progress`
## Functional changes in v0.7.2
* Fixed retention tag application to incomplete snapshots, automatically apply at checkpoints. (#660)
* repo: refresh indexes in the background every 15 minutes (#650)
* Upgrade webdav client dependency to include bugfix for the race condition (#651)
* b2: fixed handling of 'no_such_file' to indicate NOT_FOUND (#646)
* cli: When listing directory that had errors, print error summary at the end. (#643)
* Fixed empty object IDs in checkpoints (#649)
* restore: improved user experience (#644)
* Fixed few minor data races (#659)
* Eliminated busy loop after snapshot failure (#658)
## Changes in v0.7.1
## CLI Changes
* Restore support for symlinks (experimental) (#621)
* Ensure advanced commands are not accidentally used (#611)
* Fixed snapshot delete to support deleting file (not directory) snapshots by object ID (#613)
* Remove maintenance lock file on disconnect (#616)
* Fixed checkpointing to not restart the entire upload process (#594)
* Plumbed through missing --server-cert-fingerprint option (#580)
* Tools to help investigate repository structures safely (read-only mode and index inspect) (#553)
* cli: ignore trailing / in repository server URL (#569)
* Improvements to UX for mounting directories (#573)
* Changed default file log level to debug
* implemented Cache Directory Tagging Specification (#565)
* added support for setting and changing repository client options (description, read-only, hostname, username) (#589)
* don't ask for password if repository is not connected (#627)
* fuse: changed file read implementation to avoid OOM (#620)
## Kopia UI Changes
* Kopia UI improvements for creating repositories and connecting to repositories (#592)
* Added ability to connect to kopia server and few other minor tweaks (#546)
* Improvements to UX for mounting directories (#573)
* Added license ID and description
* Fix for zero-sized snapshot bug (#641)
## Repository Improvements
* Re-enables deletion of unused data blobs which was disabled in v0.6.3
* content: allow objects marked for deletion to be read (addresses unavoidable race condition) (#601)
* object: implemented fast concatenation of objects by merging their index entries (#607)
* splitter throughput improvements (#606)
* bugfix: fixed splitter reset on reuse (#596)
* bugfix: fixed index compaction that would resurrect content entry during full maintenance (#563)
* bugfix: upload: fixed ForceHashPercentage behavior to be non-deterministic (#579)
* upload: scan the directory to be uploaded in parallel to estimate the amount of data to be uploaded (#622)
* Set BuildVersion during repo initialization. (#572)
* Added support for Blake3 hashing (#640)
## Server Improvements:
* pre-read request body to fix HTTP/2 deadlock (#539)
## Infrastructure Improvements
* added RPM and APT repositories (#600)
* build: publishing of scoop Windows packages via goreleaser
* added endurance test which tests kopia over long time scale (#558)
* upraded to Go 1.15 (#598)
* logging: revamped logs from content manager to be machine parseable (#617)
* testing: added performance benchmark (#618)
## Providers
* Experimental rclone backend (#545)
* SFTP connectivity and docs improvements (#623)
## Compatibility Information
* v0.7 release is compatible with repositories created with v0.6 and v0.5.
* Due to splitter bug in previous releases (#595) repositories created using previous releases may not provide perfect deduplication for large files across multiple machines. Migrating the repository to v0.7 is recommended and will help reclaim the disk space.

73
site/content/docs/Release Notes/v0.8.md
View File

@@ -1,73 +0,0 @@
---
title: "Kopia v0.8"
linkTitle: "v0.8"
weight: -80
---
https://github.com/kopia/kopia/releases/v0.8.4.
This version brings many performance, usability and stability improvements and several new and exciting features.
There were over 150 changes by 19 contributors which represents a big growth in community engagement.
### New Features:
* [Full Maintenance](https://kopia.io/docs/advanced/maintenance/) is now enabled by default with an interval of 24 hours.
* Added support for configurable [Maintenance Safety](http://kopia.io/docs/advanced/maintenance/#maintenance-safety) to speed up cleanups in certain cases.
* Added support for `--json` flag to certain CLI commands which will produce machine-readable snasphot, policy, manifest, blob and content responses.
* Added support for scanning only one filesystem via files policy
* Major improvements to ignore logic to better follow [.gitignore rules](https://git-scm.com/docs/gitignore).
* Added support for [Actions](https://kopia.io/docs/advanced/actions/) which allow running custom scripts before and after a directory is snapshotted with lots of useful applications.
* Added support for [ACLs](https://kopia.io/docs/repository-server/#server-access-control-acl) which allow defining custom access control rules for repository server clients.
* [Docker Images](https://kopia.io/docs/installation/#docker-images) are now available
* Support for write sessions, which ensure garbage collection does not prematurely delete blobs that are in the middle of being uploaded by intermittently-connected clients (e.g. laptops that go to sleep often and can't checkpoint frequently enough)
* Added support for stdin snapshots.
* Added support for user authentication using user profiles stored in the repository (#809)
* Brand new streaming GRPC protocol for talking to kopia repository server to improve performance and ensure session stickyness, which allows sharding and load-balancing.
* Reworked error handling when taking snapshots to not fail fast (except when explicitly requested).
* Switched to new FUSE implementation which supports MacFUSE 4.x
* Added WebDAV-based mounting alternative for platforms that don't have working FUSE mechanism.
* Streamlined flags for caching and improved cache sweep.
* Major performance improvements when performing lots of index lookups in heavily-fragmented indexes (speeds up snapshot verification by orders of magnitude)
* Passthrough options to allow other-users access and mounting in empty directory.
* Don't run maintenance as part of read-only actions.
* Implemented caching for contents downloaded from Kopia Repository Server
* Reduced latency for kopia repository server uploads by performing existence checks
* Improvements to `snapshot verify` to make output easier to understand.
* compress: upgrade klauspost/compress to v1.11.12 (#888)
* Terminal password prompt - switched to golang.org/x/term (#898)
### New KopiaUI features:
* Added new tab called `Tasks` which shows the status, progress, logs, and statistics of current and past long-running tasks (restore, estimate, snapshot, maintenance).
* Streamlined snapshot creation flow to include estimation and initial policy definition.
### Provider improvements:
* S3 client - upgraded minio to v7
* rclone - testing improvements
* S3, GCS, Azure, B2 - rewrote retry logic to retry on all but known fatal errors.
* S3 - support for buckets configured with object locking
### Infrastructure:
* Build for Apple Silicon (M1) is now available. The CLI is now dual-architecture
and runs natively on both `amd64` and `arm64`.
* Switched CI/CD infrastructure to GitHub actions with two self-hosted runners for ARMHF and ARM64
* Makefile: various tricks to make PR builds faster
* S3: run tests against private minio deployment in docker (#894)
* SFTP: fixed retry logic
* RClone: improved error handling logic
## Compatibility Information
* v0.8 release is compatible with repositories created with v0.7, v0.6 and v0.5.
* While older clients can read repositories created with v0.8 it's recommended to use the latest version at earliest convenience.
### Breaking Changes
* When starting `kopia server` with `--htpasswd-file`, the UI access is now only granted to a user named `kopia` (if it exists in the password file). If such user does not exist in the password file, `--server-username` flag may be specified to indicate which of the users listed in the password file gets UI access (there can be only one). See https://github.com/kopia/kopia/issues/880 for more information.
* Added explicit `--insecure` flag to `kopia server start` to prevent accidentally starting non-secured
servers for development. Starting the server without TLS or without authentication now requires this flag.
* Several low-level maintenance tools have been changed to support individual parameters with `--safety=full|none` flag instead of specific parameters which were unsafe.

93
site/content/docs/Release Notes/v0.9.md
View File

@@ -1,93 +0,0 @@
---
title: "Kopia v0.9"
linkTitle: "v0.9"
weight: -90
---
**NOTE: Kopia v0.9 is out. You can download it from:**
https://github.com/kopia/kopia/releases/latest.
This release focuses on improvements to the repository format, stability and performance.
The new repository index format enables efficient append-only operation where delete permission is not required, removes the need for quick maintenance and enables internal content-level compression.
Kopia now also supports repository password change (new repositories only).
Big thanks to @pawitp for contributing major performance improvement to splitters [#1251](https://github.com/kopia/kopia/pull/1251), which improves large file upload performance by
up to 30%.
### Upgrading Repository
Repositories created using previous versions can be upgraded to latest format. See the [Upgrade Notes](/docs/upgrade/).
### Providers
* azure: added support for using SAS Tokens instead of storage keys [#1093](https://github.com/kopia/kopia/pull/1093)
* rclone: wait for rclone transfers to finish when closing [#1201](https://github.com/kopia/kopia/pull/1201)
* sftp: added automatic reconnect and connection pooling [#1195](https://github.com/kopia/kopia/pull/1195)
* sftp: ensure key file and known hosts are absolute paths [#1092](https://github.com/kopia/kopia/pull/1092)
* s3: point-in-time support for s3 versioned stores [#1259](https://github.com/kopia/kopia/pull/1259)
* webdav & and rclone support for atomic writes [#1206](https://github.com/kopia/kopia/pull/1206)
* webdav: disable server-side compression [#1100](https://github.com/kopia/kopia/pull/1100)
### Repository features
* new index format supporting internal compression and does not require quick maintenance for performance reasons
* splitter: major performance improvements [#1251](https://github.com/kopia/kopia/pull/1251)
* implemented epoch-based index manager [#1174](https://github.com/kopia/kopia/pull/1174)
* internal logging - low-level logs are now stored in the repository.
* support for content-level compression [#1076](https://github.com/kopia/kopia/pull/1076)
* added 'lz4' and 'deflate' methods [#1077](https://github.com/kopia/kopia/pull/1077)
* added sharding of indexes on write [#1176](https://github.com/kopia/kopia/pull/1176)
* repository password change support [#1197](https://github.com/kopia/kopia/pull/1197)
* limit the duration of kopia.repository caching to 15 minutes [#1196](https://github.com/kopia/kopia/pull/1196)
* encryption: removed old, non-authenticated encryption methods [#979](https://github.com/kopia/kopia/pull/979)
* big performance improvement for WriteContent with repo server [#1182](https://github.com/kopia/kopia/pull/1182)
* disabled quick maintenance for new repositories
### CLI
* 'kopia content verify' performance improvements [#1120](https://github.com/kopia/kopia/pull/1120)
* add a flag to not shallowrestore small files [#1126](https://github.com/kopia/kopia/pull/1126)
* added 'kopia repo set-parameters' to override mutable parameters [#1148](https://github.com/kopia/kopia/pull/1148)
* added 'kopia repository validate-provider` [#1205](https://github.com/kopia/kopia/pull/1205)
* additional 'index inspect' flags [#1231](https://github.com/kopia/kopia/pull/1231)
* changed 'kopia snapshot verify --verify-files-percent' to float [#1210](https://github.com/kopia/kopia/pull/1210)
* fixed ETA estimation of 'snapshot verify' [#1213](https://github.com/kopia/kopia/pull/1213)
* force-hash: Allow fractional percentages [#1209](https://github.com/kopia/kopia/pull/1209)
* include parameters in maintenance info JSON output [#981](https://github.com/kopia/kopia/pull/981)
* optimized 'kopia index recover' by leveraging partial read and parallelism [#1094](https://github.com/kopia/kopia/pull/1094)
* support for shallow restore [#725](https://github.com/kopia/kopia/pull/725)
* tagging of kopia snapshots and listing of snapshots by tag [#1030](https://github.com/kopia/kopia/pull/1030)
* logging: switched file log timestamps to be UTC by default, otherwise it's hard to correlate logs [#1240](https://github.com/kopia/kopia/pull/1240)
### Policy Changes
* Fix weekly retention labels not being assigned correctly [#1211](https://github.com/kopia/kopia/pull/1211)
* policy: path validation [#1006](https://github.com/kopia/kopia/pull/1006)
### UI Changes
* do not attempt running maintenance if the current user is not the maintenance owner, to avoid producing error in the Tasks tab [#1010](https://github.com/kopia/kopia/pull/1010)
* fixed Estimate not honoring the defined policies [#1002](https://github.com/kopia/kopia/pull/1002)
* for read-only repositories start a read-only source manager [#1009](https://github.com/kopia/kopia/pull/1009)
* open .gitignore help in a new window [#1016](https://github.com/kopia/kopia/pull/1016)
* show a spinner when saving/deleting policy [#1018](https://github.com/kopia/kopia/pull/1018)
* improved auto-update experience - [#1390](https://github.com/kopia/kopia/pull/1390)
### Security
* security: switched to github.com/golang-jwt/jwt/v4 to fix upstream security issue [#1235](https://github.com/kopia/kopia/pull/1235)
### Notable internal Changes
* automatically refresh indexes on read instead of relying on RefreshPeriodically() loop [#1243](https://github.com/kopia/kopia/pull/1243)
* ensure that we always consistently pick content.Info amongst entries with identical time and deleted flag [#1239](https://github.com/kopia/kopia/pull/1239)
* refactored content.Info to be an interface and switched index parsing to be lazy [#1008](https://github.com/kopia/kopia/pull/1008)
* refactored own writes cache and list cache into blob.Storage wrappers [#1133](https://github.com/kopia/kopia/pull/1133)
* few subtle threading bugs uncovered by stress test and rewrote the test to be model-based [#1157](https://github.com/kopia/kopia/pull/1157)
* reworked memory management to avoid allocating large chunks of memory for most buffers
* ci: Allow to compile Kopia cli on OpenBSD [#983](https://github.com/kopia/kopia/pull/983)
* upgrade golang to 1.17
* testing: Refactored most of the CLI tests to run in-process as opposed to using sub-processes [#1059](https://github.com/kopia/kopia/pull/1059)
* switched logging to zap [#1376](https://github.com/kopia/kopia/pull/1376)