v1.9.6

v1.9.6

2023-02-24

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.9.6

Container Image

velero/velero:v1.9.6

Documentation

https://velero.io/docs/v1.9/

Upgrading

https://velero.io/docs/v1.9/upgrade-to-1.9/

All changes

• Bump up Golang version and fix CVEs. (#5884, @blackpiglet)
• Add labels for velero installed namespace to support PSA. (#5887, @blackpiglet)
• Fix Dockerfile issue. (#5761, @blackpiglet)
• Add PR container build action, which will not push image. Add GOARM parameter. (#5777, @blackpiglet)
• Correct PVB/PVR Failed Phase patching during startup (#5829, @kaovilai)

v1.9.6-rc.1

v1.9.6

2023-02-22

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.9.6

Container Image

velero/velero:v1.9.6

Documentation

https://velero.io/docs/v1.9/

Upgrading

https://velero.io/docs/v1.9/upgrade-to-1.9/

All changes

• Bump up Golang version and fix CVEs. (#5884, @blackpiglet)
• Add labels for velero installed namespace to support PSA. (#5887, @blackpiglet)
• Fix Dockerfile issue. (#5761, @blackpiglet)
• Add PR container build action, which will not push image. Add GOARM parameter. (#5777, @blackpiglet)
• Correct PVB/PVR Failed Phase patching during startup (#5829, @kaovilai)

v1.10.1

v1.10.1

2023-02-06

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.10.1

Container Image

velero/velero:v1.10.1

Documentation

https://velero.io/docs/v1.10/

Upgrading

https://velero.io/docs/v1.10/upgrade-to-1.10/

Highlights

Upgrading from 1.9.4 and above is supported in this release.

All changes

• Fix Restic v0.14.0 HIGH grade CVEs. (#5817, @blackpiglet)
• Bump up golang net to fix CVE-2022-41721 (#5811, @Lyndon-Li)
• Bump up golang to 1.18.10 for Velero (#5780, @Lyndon-Li)
• Add PR container build action, which will not push image. Add GOARM parameter. Remove container-builder-env section. (#5770, @blackpiglet)
• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5765, @blackpiglet)
• Fix issue 5696, check if the repo is still openable before running the prune and forget operation, if not, try to reconnect the repo (#5714, @Lyndon-Li)
• Fix error with Restic backup empty volumes (#5711, @qiuming-best)
• Prevent nil panic on exec restore hooks (#5708, @dymurray)
• Fix CVEs scanned by trivy (#5655, @qiuming-best)

v1.10.1-rc.3

v1.10.1

2023-02-02

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.10.1-rc.3

Container Image

velero/velero:v1.10.1-rc.3

Documentation

https://velero.io/docs/v1.10/

Upgrading

https://velero.io/docs/v1.10/upgrade-to-1.10/

All changes

• Fix Restic v0.14.0 HIGH grade CVEs. (#5817, @blackpiglet)
• Bump up golang net to fix CVE-2022-41721 (#5811, @Lyndon-Li)
• Bump up golang to 1.18.10 for Velero (#5780, @Lyndon-Li)
• Add PR container build action, which will not push image. Add GOARM parameter. Remove container-builder-env section. (#5770, @blackpiglet)
• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5765, @blackpiglet)
• Fix issue 5696, check if the repo is still openable before running the prune and forget operation, if not, try to reconnect the repo (#5714, @Lyndon-Li)
• Fix error with Restic backup empty volumes (#5711, @qiuming-best)
• Prevent nil panic on exec restore hooks (#5708, @dymurray)
• Fix CVEs scanned by trivy (#5655, @qiuming-best)

v1.10.1-rc.2

v1.10.1

2023-02-01

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.10.1-rc.2

Container Image

velero/velero:v1.10.1-rc.2

Documentation

https://velero.io/docs/v1.10/

Upgrading

https://velero.io/docs/v1.10/upgrade-to-1.10/

All changes

• Bump up golang net to fix CVE-2022-41721 (#5811, @Lyndon-Li)
• Bump up golang to 1.18.10 for Velero (#5780, @Lyndon-Li)
• Add PR container build action, which will not push image. Add GOARM parameter. Remove container-builder-env section. (#5770, @blackpiglet)
• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5765, @blackpiglet)
• Fix issue 5696, check if the repo is still openable before running the prune and forget operation, if not, try to reconnect the repo (#5714, @Lyndon-Li)
• Fix error with Restic backup empty volumes (#5711, @qiuming-best)
• Prevent nil panic on exec restore hooks (#5708, @dymurray)
• Fix CVEs scanned by trivy (#5655, @qiuming-best)

v1.10.1-rc.1

v1.10.1

2023-01-19

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.10.1-rc.1

Container Image

velero/velero:v1.10.1-rc.1

Documentation

https://velero.io/docs/v1.10/

Upgrading

https://velero.io/docs/v1.10/upgrade-to-1.10/

All changes

• Bump up golang to 1.18.10 for Velero (#5780, @Lyndon-Li)
• Add PR container build action, which will not push image. Add GOARM parameter. Remove container-builder-env section. (#5770, @blackpiglet)
• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5765, @blackpiglet)
• Fix issue 5696, check if the repo is still openable before running the prune and forget operation, if not, try to reconnect the repo (#5714, @Lyndon-Li)
• Fix error with Restic backup empty volumes (#5711, @qiuming-best)
• Prevent nil panic on exec restore hooks (#5708, @dymurray)
• Fix CVEs scanned by trivy (#5655, @qiuming-best)

v1.9.5

v1.9.5

2022-12-19

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.9.5

Container Image

velero/velero:v1.9.5

Documentation

https://velero.io/docs/v1.9/

Upgrading

https://velero.io/docs/v1.9/upgrade-to-1.9/

All changes

• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5685, @blackpiglet)

v1.9.5-rc.2

v1.9.5

2022-12-19

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.9.5

Container Image

velero/velero:v1.9.5

Documentation

https://velero.io/docs/v1.9/

Upgrading

https://velero.io/docs/v1.9/upgrade-to-1.9/

All changes

• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5685, @blackpiglet)

v1.9.5-rc.1

v1.9.5

2022-12-19

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.9.5

Container Image

velero/velero:v1.9.5

Documentation

https://velero.io/docs/v1.9/

Upgrading

https://velero.io/docs/v1.9/upgrade-to-1.9/

All changes

• Add Restic builder in Dockerfile, and keep the used built Golang image version in accordance with upstream Restic. (#5685, @blackpiglet)

v1.10.0

v1.10.0

2022-11-29

Download

https://github.com/vmware-tanzu/velero/releases/tag/v1.10.0

Container Image

velero/velero:v1.10.0

Documentation

https://velero.io/docs/v1.10/

Upgrading

https://velero.io/docs/v1.10/upgrade-to-1.10/

Highlights

Unified Repository and Kopia integration

In this release, we introduced the Unified Repository architecture to build a data path where data movers and the backup repository are decoupled and a unified backup repository could serve various data movement activities.

In this release, we also deeply integrate Velero with Kopia, specifically, Kopia's uploader modules are isolated as a generic file system uploader; Kopia's repository modules are encapsulated as the unified backup repository.

For more information, refer to the design document.

File system backup refactor

Velero's file system backup (a.k.s. pod volume backup or formerly restic backup) is refactored as the first user of the Unified Repository architecture. Specifically, we added a new path, the Kopia path, besides the existing Restic path. While Restic path is still available and set as default, you can opt in Kopia path by specifying the uploader-type parameter at installation time. Meanwhile, you are free to restore from existing backups under either path, Velero dynamically switches to the correct path to process the restore.

Because of the new path, we renamed some modules and parameters, refer to the Break Changes section for more details.

For more information, visit the file system backup document and v1.10 upgrade guide document.

Meanwhile, we've created a performance guide for both Restic path and Kopia path, which helps you to choose between the two paths and provides you the best practice to configure them under different scenarios. Please note that the results in the guide are based on our testing environments, you may get different results when testing in your own ones. For more information, visit the performance guide document.

Plugin versioning V1 refactor

In this release, Velero moves plugins BackupItemAction, RestoreItemAction and VolumeSnapshotterAction to version v1, this allows future plugin changes that do not support backward compatibility, so is a preparation for various complex tasks, for example, data movement tasks.
For more information, refer to the plugin versioning design document.

Refactor the controllers using Kubebuilder v3

In this release we continued our code modernization work, rewriting some controllers using Kubebuilder v3. This work is ongoing and we will continue to make progress in future releases.

Add credentials to volume snapshot locations

In this release, we enabled dedicate credentials options to volume snapshot locations so that you can specify credentials per volume snapshot location as same as backup storage location.

For more information, please visit the locations document.

CSI snapshot enhancements

In this release we added several changes to enhance the robustness of CSI snapshot procedures, for example, some protection code for error handling, and a mechanism to skip exclusion checks so that CSI snapshot works with various backup resource filters.

Backup schedule pause/unpause

In this release, Velero supports to pause/unpause a backup schedule during or after its creation. Specifically:

At creation time, you can specify –paused flag to velero schedule create command, if so, you will create a paused schedule that will not run until it is unpaused
After creation, you can run velero schedule pause or velero schedule unpause command to pause/unpause a schedule

Runtime and dependencies

In order to fix CVEs, we changed Velero's runtime and dependencies as follows:

Bump go runtime to v1.18.8
Bump some core dependent libraries to newer versions
Compile Restic (v0.13.1) with go 1.18.8 instead of packaging the official binary

Breaking changes

Due to file system backup refactor, below modules and parameters name have been changed in this release:

restic daemonset is renamed to node-agent
use-restic installation parameter is renamed to use-node-agent
resticRepository CR is renamed to backupRepository
velero restic repo command is renamed to velero repo
velero-restic-credentials secret is renamed to velero-repo-credentials
default-volumes-to-restic parameter is renamed to default-volumes-to-fs-backup
restic-timeout parameter is renamed to fs-backup-timeout
default-restic-prune-frequency parameter is renamed to default-repo-maintain-frequency

Upgrade

Due to the major changes of file system backup, the old upgrade steps are not suitable any more. For the new upgrade steps, visit v1.10 upgrade guide document.

Limitations/Known issues

In this release, Kopia backup repository (so the Kopia path of file system backup) doesn't support self signed certificate for S3 compatible storage. To track this problem, refer to this Velero issue or Kopia issue.

Due to the code change in Velero, there will be some code change required in vSphere plugin, without which the functionality may be impacted. Therefore, if you are using vSphere plugin in your workflow, please hold the upgrade until the issue #485 is fixed in vSphere plugin.

Upgrade from Velero v1.9.4 is not supported. Velero v1.9.4 has bumped up Restic to v0.14.0, in which the repository format V2 is used, refer to Restic release notes for details. Whereas, v1.10 is still with Restic v0.13.1, so if you are using File System Backup, you may encounter problems with restoring from backups created by v1.9.4. This issue will be fixed in the coming v1.10 patches.

All changes

• Restore ClusterBootstrap before Cluster otherwise a new default ClusterBootstrap object is create for the cluster (#5616, @ywk253100)
• Add compile restic binary for CVE fix (#5574, @qiuming-best)
• Fix controller problematic log output (#5572, @qiuming-best)
• Enhance the restore priorities list to support specifying the low prioritized resources that need to be restored in the last (#5535, @ywk253100)
• fix restic backup progress error (#5534, @qiuming-best)
• fix restic backup failure with self-signed certification backend storage (#5526, @qiuming-best)
• Add credential store in backup deletion controller to support VSL credential. (#5521, @blackpiglet)
• Fix issue 5505: the pod volume backups/restores except the first one fail under the kopia path if "AZURE_CLOUD_NAME" is specified (#5512, @Lyndon-Li)
• After Pod Volume Backup/Restore refactor, remove all the unreasonable appearance of "restic" word from documents (#5499, @Lyndon-Li)
• Refactor Pod Volume Backup/Restore doc to match the new behavior (#5484, @Lyndon-Li)
• Remove redundancy code block left by #5388. (#5483, @blackpiglet)
• Issue fix 5477: create the common way to support S3 compatible object storages that work for both Restic and Kopia; Keep the resticRepoPrefix parameter for compatibility (#5478, @Lyndon-Li)
• Update the k8s.io dependencies to 0.24.0.
  This also required an update to github.com/bombsimon/logrusr/v3.
  Removed the WithClusterName method
  as it is a "legacy field that was
  always cleared by the system and never used" as per upstream k8s
  https://github.com/kubernetes/apimachinery/blob/release-1.24/pkg/apis/meta/v1/types.go#L257-L259 (#5471, @kcboyle)
• Add v1.10 velero upgrade doc (#5468, @qiuming-best)
• Upgrade velero docker image to use go 1.18 and upgrade golangci-lint to 1.45.0 (#5459, @Lyndon-Li)
• Add VolumeSnapshot client back. (#5449, @blackpiglet)
• Change subcommand velero restic repo to velero repo (#5446, @allenxu404)
• Remove irrational "Restic" names in Velero code after the PVBR refactor (#5444, @Lyndon-Li)
• moved RIA execute input/output structs back to velero package (#5441, @sseago)
• Rename Velero pod volume restore init helper from "velero-restic-restore-helper" to "velero-restore-helper" (#5432, @Lyndon-Li)
• Skip the exclusion check for additional resources returned by BIA (#5429, @reasonerjt)
• Change B/R describe CLI to support Kopia (#5412, @allenxu404)
• Add nil check before execution of csi snapshot delete (#5401, @shubham-pampattiwar)
• update velero using klog to version v2.9.0 (#5396, @blackpiglet)
• Fix Test_prepareBackupRequest_BackupStorageLocation UT failure. (#5394, @blackpiglet)
• Rename Velero daemonset from "restic" to "node-agent" (#5390, @Lyndon-Li)
• Add some corner cases checking for CSI snapshot in backup controller. (#5388, @blackpiglet)
• Fix issue 5386: Velero providers a full URL as the S3Url while the underlying minio client only accept the host part of the URL as the endpoint and the schema should be specified separately. (#5387, @Lyndon-Li)
• Fix restore error with flag namespace-mappings (#5377, @qiuming-best)
• Pod Volume Backup/Restore Refactor: Rename parameters in CRDs and commands to remove "Restic" word (#5370, @Lyndon-Li)
• Added backupController's UT to test the prepareBackupRequest() method BackupStorageLocation processing logic (#5362, @niulechuan)
• Fix a repoEnsurer problem introduced by th...