Skip to content

Releases: vmware-tanzu/velero

v1.13.2

17 Apr 02:48
4d961fb
Compare
Choose a tag to compare

v1.13.2

2024-04-17

Download

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

Container Image

velero/velero:v1.13.2

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

All changes

  • Bump up the versions of several Kubernetes-related libs (#7577, @ywk253100)
  • Fix issue #7535, add the MustHave resource check during item collection and item filter for restore (#7586, @Lyndon-Li)
  • Bump Golang version, and bump protobuf version (#7606, @blackpiglet)

v1.13.2-rc.1

15 Apr 07:16
4d961fb
Compare
Choose a tag to compare
v1.13.2-rc.1 Pre-release
Pre-release

v1.13.2-rc.1

2024-04-15

Download

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

Container Image

velero/velero:v1.13.2-rc.1

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

All changes

  • Bump up the versions of several Kubernetes-related libs (#7577, @ywk253100)
  • Fix issue #7535, add the MustHave resource check during item collection and item filter for restore (#7586, @Lyndon-Li)
  • Bump Golang version, and bump protobuf version (#7606, @blackpiglet)

v1.13.1

13 Mar 05:08
ea5a89f
Compare
Choose a tag to compare

v1.13.1

2024-03-13

Download

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

Container Image

velero/velero:v1.13.1

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

All changes

  • Fix issue #7308, change the data path requeue time to 5 second for data mover backup/restore, PVB and PVR. (#7459, @Lyndon-Li)
  • BackupRepositories associated with a BSL are invalidated when BSL is (re-)created. (#7399, @kaovilai)
  • Adjust the logic for the backup_last_status metrics to stop incorrectly incrementing over time (#7445, @allenxu404)

v1.13.1-rc.1

11 Mar 03:40
ea5a89f
Compare
Choose a tag to compare
v1.13.1-rc.1 Pre-release
Pre-release

v1.13.1-rc.1

2024-03-11

Download

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

Container Image

velero/velero:v1.13.1-rc.1

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

All changes

  • Fix issue #7308, change the data path requeue time to 5 second for data mover backup/restore, PVB and PVR. (#7459, @Lyndon-Li)
  • BackupRepositories associated with a BSL are invalidated when BSL is (re-)created. (#7399, @kaovilai)
  • Adjust the logic for the backup_last_status metrics to stop incorrectly incrementing over time (#7445, @allenxu404)

v1.12.4

28 Feb 10:28
7d8417b
Compare
Choose a tag to compare

v1.12.4

2024-02-28

Download

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

Container Image

velero/velero:v1.12.4

Documentation

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

Upgrading

https://velero.io/docs/v1.12/upgrade-to-1.12/

All changes

  • BackupRepositories associated with a BSL are invalidated when BSL is (re-)created. (#7397, @kaovilai)
  • Check resource Group Version and Kind is available in cluster before attempting restore to prevent being stuck. (#7337, @kaovilai)
  • Make "disable-informer-cache" option false(enabled) by default to keep it consistent with the help message (#7298, @ywk253100)
  • Add description markers for dataupload and datadownload CRDs (#7042, @shubham-pampattiwar)

v1.12.4-rc.1

26 Feb 09:42
7d8417b
Compare
Choose a tag to compare
v1.12.4-rc.1 Pre-release
Pre-release

v1.12.4-rc.1

2024-02-26

Download

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

Container Image

velero/velero:v1.12.4-rc.1

Documentation

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

Upgrading

https://velero.io/docs/v1.12/upgrade-to-1.12/

All changes

  • BackupRepositories associated with a BSL are invalidated when BSL is (re-)created. (#7397, @kaovilai)
  • Check resource Group Version and Kind is available in cluster before attempting restore to prevent being stuck. (#7337, @kaovilai)
  • Make "disable-informer-cache" option false(enabled) by default to keep it consistent with the help message (#7298, @ywk253100)
  • Add description markers for dataupload and datadownload CRDs (#7042, @shubham-pampattiwar)

v1.13.0

29 Jan 08:31
76670e9
Compare
Choose a tag to compare

v1.13

2024-01-29

Download

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

Container Image

velero/velero:v1.13.0

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

Highlights

Resource Modifier Enhancement

Velero introduced the Resource Modifiers in v1.12.0. This feature allows users to specify a ConfigMap with a set of rules to modify the resources during restoration. However, only the JSON Patch is supported when creating the rules, and JSON Patch has some limitations, which cannot cover all use cases. In v1.13.0, Velero adds new support for JSON Merge Patch and Strategic Merge Patch, which provide more power and flexibility and allow users to use the same ConfigMap to apply patches on the resources. More design details can be found in Support JSON Merge Patch and Strategic Merge Patch in Resource Modifiers design. For instructions on how to use the feature, please refer to the Resource Modifiers doc.

Node-Agent Concurrency

Velero data movement activities from fs-backups and CSI snapshot data movements run in Velero node-agent, so may be hosted by every node in the cluster and consume resources (i.e. CPU, memory, network bandwidth) from there. With v1.13, users are allowed to configure how many data movement activities (a.k.a, loads) run in each node globally or by node, so that users can better leverage the performance of Velero data movement activities and the resource consumption in the cluster. For more information, check the Node-Agent Concurrency document.

Parallel Files Upload Options

Velero now supports configurable options for parallel files upload when using Kopia uploader to do fs-backups or CSI snapshot data movements which makes speed up backup possible.
For more information, please check Here.

Write Sparse Files Options

If using fs-restore or CSI snapshot data movements, it’s supported to write sparse files during restore. For more information, please check Here.

Backup Describe

In v1.13, the Backup Volume section is added to the velero backup describe command output. The backup Volumes section describes information for all the volumes included in the backup of various backup types, i.e. native snapshot, fs-backup, CSI snapshot, and CSI snapshot data movement. Particularly, the velero backup description now supports showing the information of CSI snapshot data movements, which is not supported in v1.12.

Additionally, backup describe command will not check EnableCSI feature gate from client side, so if a backup has volumes with CSI snapshot or CSI snapshot data movement, backup describe command always shows the corresponding information in its output.

Backup's new VolumeInfo metadata

Create a new metadata file in the backup repository's backup name sub-directory to store the backup-including PVC and PV information. The information includes the backing-up method of the PVC and PV data, snapshot information, and status. The VolumeInfo metadata file determines how the PV resource should be restored. The Velero downstream software can also use this metadata file to get a summary of the backup's volume data information.

Enhancement for CSI Snapshot Data Movements when Velero Pod Restart

When performing backup and restore operations, enhancements have been implemented for Velero server pods or node agents to ensure that the current backup or restore process is not stuck or interrupted after restart due to certain exceptional circumstances.

New status fields added to show hook execution details

Hook execution status is now included in the backup/restore CR status and displayed in the backup/restore describe command output. Specifically, it will show the number of hooks which attempted to execute under the HooksAttempted field and the number of hooks which failed to execute under the HooksFailed field.

AWS SDK Bump Up

Bump up AWS SDK for Go to version 2, which offers significant performance improvements in CPU and memory utilization over version 1.

Azure AD/Workload Identity Support

Azure AD/Workload Identity is the recommended approach to do the authentication with Azure services/AKS, Velero has introduced support for Azure AD/Workload Identity on the Velero Azure plugin side in previous releases, and in v1.13.0 Velero adds new support for Kopia operations(file system backup/data mover/etc.) with Azure AD/Workload Identity.

Runtime and dependencies

To fix CVEs and keep pace with Golang, Velero made changes as follows:

  • Bump Golang runtime to v1.21.6.
  • Bump several dependent libraries to new versions.
  • Bump Kopia to v0.15.0.

Breaking changes

  • Backup describe command: due to the backup describe output enhancement, some existing information (i.e. the output for native snapshot, CSI snapshot, and fs-backup) has been moved to the Backup Volumes section with some format changes.
  • API type changes: changes the field DataMoverConfig in DataUploadSpec from *map[string][string]`` to map[string]string`
  • Velero install command: due to the issue #7264, v1.13.0 introduces a break change that make the informer cache enabled by default to keep the actual behavior consistent with the helper message(the informer cache is disabled by default before the change).

Limitations/Known issues

  • The backup's VolumeInfo metadata doesn't have the information updated in the async operations. This function could be supported in v1.14 release.

Note

  • Velero introduces the informer cache which is enabled by default. The informer cache improves the restore performance but may cause higher memory consumption. Increase the memory limit of the Velero pod or disable the informer cache by specifying the --disable-informer-cache option when installing Velero if you get the OOM error.

Deprecation announcement

  • The generated k8s clients, informers, and listers are deprecated in the Velero v1.13 release. They are put in the Velero repository's pkg/generated directory. According to the n+2 supporting policy, the deprecated are kept for two more releases. The pkg/generated directory should be deleted in the v1.15 release.
  • After the backup VolumeInfo metadata file is added to the backup, Velero decides how to restore the PV resource according to the VolumeInfo content. To support the backup generated by the older version of Velero, the old logic is also kept. The support for the backup without the VolumeInfo metadata file will be kept for two releases. The support logic will be deleted in the v1.15 release.

All Changes

  • Check resource Group Version and Kind is available in cluster before attempting restore to prevent being stuck (#7336, @kaovilai)
  • Make "disable-informer-cache" option false(enabled) by default to keep it consistent with the help message (#7294, @ywk253100)
  • Fix issue #6928, remove snapshot deletion timeout for PVB (#7282, @Lyndon-Li)
  • Do not set "targetNamespace" to namespace items (#7274, @reasonerjt)
  • Fix issue #7244. By the end of the upload, check the outstanding incomplete snapshots and delete them by calling ApplyRetentionPolicy (#7245, @Lyndon-Li)
  • Adjust the newline output of resource list in restore describer (#7238, @allenxu404)
  • Remove the redundant newline in backup describe output (#7229, @allenxu404)
  • Fix issue #7189, data mover generic restore - don't assume the first volume as the restore volume (#7201, @Lyndon-Li)
  • Update CSIVolumeSnapshotsCompleted in backup's status and the metric
    during backup finalize stage according to async operations content. (#7184, @blackpiglet)
  • Refactor DownloadRequest Stream function (#7175, @blackpiglet)
  • Add --skip-immediately flag to schedule commands; --schedule-skip-immediately server and install (#7169, @kaovilai)
  • Add node-agent concurrency doc and change the config name from dataPathConcurrency to loadCocurrency (#7161, @Lyndon-Li)
  • Enhance hooks tracker by adding a returned error to record function (#7153, @allenxu404)
  • Track the skipped PV when SnapshotVolumes set as false (#7152, @reasonerjt)
  • Add more linters part 2. (#7151, @blackpiglet)
  • Fix issue #7135, check pod status before checking node-agent pod status (#7150, @Lyndon-Li)
  • Treat namespace as a regular restorable item (#7143, @reasonerjt)
  • Allow sparse option for Kopia & Restic restore (#7141, @qiuming-best)
  • Use VolumeInfo to help restore the PV. (#7138, @blackpiglet)
  • Node agent restart enhancement (#7130, @qiuming-best)
  • Fix issue #6695, add describe for data mover backups (#7125, @Lyndon-Li)
  • Add hooks status to backup/restore CR (#7117, @allenxu404)
  • Include plugin name in the error message by operations (#7115, @reasonerjt)
  • Fix issue #7068, due to a behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API is called. So add a protection finalizer to ensure the order (#7102, @Lyndon-Li)
  • Generate VolumeInfo for backup. (#7100, @blackpiglet)
  • Fix issue #7094, fallback to full backup if previous snapshot is not found (#7096, @Lyndon-Li)
  • Fix issue #7068, due to an behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API is called. ...
Read more

v1.13.0-rc.2

25 Jan 02:02
76670e9
Compare
Choose a tag to compare
v1.13.0-rc.2 Pre-release
Pre-release

v1.13

2024-01-10

Download

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

Container Image

velero/velero:v1.13.0-rc.2

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

Highlights

Resource Modifier Enhancement

Velero introduced the Resource Modifiers in v1.12.0. This feature allows users to specify a ConfigMap with a set of rules to modify the resources during restoration. However, only the JSON Patch is supported when creating the rules, and JSON Patch has some limitations, which cannot cover all use cases. In v1.13.0, Velero adds new support for JSON Merge Patch and Strategic Merge Patch, which provide more power and flexibility and allow users to use the same ConfigMap to apply patches on the resources. More design details can be found in Support JSON Merge Patch and Strategic Merge Patch in Resource Modifiers design. For instructions on how to use the feature, please refer to the Resource Modifiers doc.

Node-Agent Concurrency

Velero data movement activities from fs-backups and CSI snapshot data movements run in Velero node-agent, so may be hosted by every node in the cluster and consume resources (i.e. CPU, memory, network bandwidth) from there. With v1.13, users are allowed to configure how many data movement activities (a.k.a, loads) run in each node globally or by node, so that users can better leverage the performance of Velero data movement activities and the resource consumption in the cluster. For more information, check the Node-Agent Concurrency document.

Parallel Files Upload Options

Velero now supports configurable options for parallel files upload when using Kopia uploader to do fs-backups or CSI snapshot data movements which makes speed up backup possible.
For more information, please check Here.

Write Sparse Files Options

If using fs-restore or CSI snapshot data movements, it’s supported to write sparse files during restore. For more information, please check Here.

Backup Describe

In v1.13, the Backup Volume section is added to the velero backup describe command output. The backup Volumes section describes information for all the volumes included in the backup of various backup types, i.e. native snapshot, fs-backup, CSI snapshot, and CSI snapshot data movement. Particularly, the velero backup description now supports showing the information of CSI snapshot data movements, which is not supported in v1.12.

Additionally, backup describe command will not check EnableCSI feature gate from client side, so if a backup has volumes with CSI snapshot or CSI snapshot data movement, backup describe command always shows the corresponding information in its output.

Backup's new VolumeInfo metadata

Create a new metadata file in the backup repository's backup name sub-directory to store the backup-including PVC and PV information. The information includes the backing-up method of the PVC and PV data, snapshot information, and status. The VolumeInfo metadata file determines how the PV resource should be restored. The Velero downstream software can also use this metadata file to get a summary of the backup's volume data information.

Enhancement for CSI Snapshot Data Movements when Velero Pod Restart

When performing backup and restore operations, enhancements have been implemented for Velero server pods or node agents to ensure that the current backup or restore process is not stuck or interrupted after restart due to certain exceptional circumstances.

New status fields added to show hook execution details

Hook execution status is now included in the backup/restore CR status and displayed in the backup/restore describe command output. Specifically, it will show the number of hooks which attempted to execute under the HooksAttempted field and the number of hooks which failed to execute under the HooksFailed field.

AWS SDK Bump Up

Bump up AWS SDK for Go to version 2, which offers significant performance improvements in CPU and memory utilization over version 1.

Azure AD/Workload Identity Support

Azure AD/Workload Identity is the recommended approach to do the authentication with Azure services/AKS, Velero has introduced support for Azure AD/Workload Identity on the Velero Azure plugin side in previous releases, and in v1.13.0 Velero adds new support for Kopia operations(file system backup/data mover/etc.) with Azure AD/Workload Identity.

Runtime and dependencies

To fix CVEs and keep pace with Golang, Velero made changes as follows:

  • Bump Golang runtime to v1.21.6.
  • Bump several dependent libraries to new versions.
  • Bump Kopia to v0.15.0.

Breaking changes

  • Backup describe command: due to the backup describe output enhancement, some existing information (i.e. the output for native snapshot, CSI snapshot, and fs-backup) has been moved to the Backup Volumes section with some format changes.
  • API type changes: changes the field DataMoverConfig in DataUploadSpec from *map[string][string]`` to map[string]string`
  • Velero install command: due to the issue #7264, v1.13.0 introduces a break change that make the informer cache enabled by default to keep the actual behavior consistent with the helper message(the informer cache is disabled by default before the change).

Limitations/Known issues

  • The backup's VolumeInfo metadata doesn't have the information updated in the async operations. This function could be supported in v1.14 release.

Note

  • Velero introduces the informer cache which is enabled by default. The informer cache improves the restore performance but may cause higher memory consumption. Increase the memory limit of the Velero pod or disable the informer cache by specifying the --disable-informer-cache option when installing Velero if you get the OOM error.

Deprecation announcement

  • The generated k8s clients, informers, and listers are deprecated in the Velero v1.13 release. They are put in the Velero repository's pkg/generated directory. According to the n+2 supporting policy, the deprecated are kept for two more releases. The pkg/generated directory should be deleted in the v1.15 release.
  • After the backup VolumeInfo metadata file is added to the backup, Velero decides how to restore the PV resource according to the VolumeInfo content. To support the backup generated by the older version of Velero, the old logic is also kept. The support for the backup without the VolumeInfo metadata file will be kept for two releases. The support logic will be deleted in the v1.15 release.

All Changes

  • Check resource Group Version and Kind is available in cluster before attempting restore to prevent being stuck (#7336, @kaovilai)
  • Make "disable-informer-cache" option false(enabled) by default to keep it consistent with the help message (#7294, @ywk253100)
  • Fix issue #6928, remove snapshot deletion timeout for PVB (#7282, @Lyndon-Li)
  • Do not set "targetNamespace" to namespace items (#7274, @reasonerjt)
  • Fix issue #7244. By the end of the upload, check the outstanding incomplete snapshots and delete them by calling ApplyRetentionPolicy (#7245, @Lyndon-Li)
  • Adjust the newline output of resource list in restore describer (#7238, @allenxu404)
  • Remove the redundant newline in backup describe output (#7229, @allenxu404)
  • Fix issue #7189, data mover generic restore - don't assume the first volume as the restore volume (#7201, @Lyndon-Li)
  • Update CSIVolumeSnapshotsCompleted in backup's status and the metric
    during backup finalize stage according to async operations content. (#7184, @blackpiglet)
  • Refactor DownloadRequest Stream function (#7175, @blackpiglet)
  • Add --skip-immediately flag to schedule commands; --schedule-skip-immediately server and install (#7169, @kaovilai)
  • Add node-agent concurrency doc and change the config name from dataPathConcurrency to loadCocurrency (#7161, @Lyndon-Li)
  • Enhance hooks tracker by adding a returned error to record function (#7153, @allenxu404)
  • Track the skipped PV when SnapshotVolumes set as false (#7152, @reasonerjt)
  • Add more linters part 2. (#7151, @blackpiglet)
  • Fix issue #7135, check pod status before checking node-agent pod status (#7150, @Lyndon-Li)
  • Treat namespace as a regular restorable item (#7143, @reasonerjt)
  • Allow sparse option for Kopia & Restic restore (#7141, @qiuming-best)
  • Use VolumeInfo to help restore the PV. (#7138, @blackpiglet)
  • Node agent restart enhancement (#7130, @qiuming-best)
  • Fix issue #6695, add describe for data mover backups (#7125, @Lyndon-Li)
  • Add hooks status to backup/restore CR (#7117, @allenxu404)
  • Include plugin name in the error message by operations (#7115, @reasonerjt)
  • Fix issue #7068, due to a behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API is called. So add a protection finalizer to ensure the order (#7102, @Lyndon-Li)
  • Generate VolumeInfo for backup. (#7100, @blackpiglet)
  • Fix issue #7094, fallback to full backup if previous snapshot is not found (#7096, @Lyndon-Li)
  • Fix issue #7068, due to an behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API i...
Read more

v1.13.0-rc.1

17 Jan 13:12
fdb2981
Compare
Choose a tag to compare
v1.13.0-rc.1 Pre-release
Pre-release

v1.13

2024-01-10

Download

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

Container Image

velero/velero:v1.13.0-rc.1

Documentation

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

Upgrading

https://velero.io/docs/v1.13/upgrade-to-1.13/

Highlights

Resource Modifier Enhancement

Velero introduced the Resource Modifiers in v1.12.0. This feature allows users to specify a ConfigMap with a set of rules to modify the resources during restoration. However, only the JSON Patch is supported when creating the rules, and JSON Patch has some limitations, which cannot cover all use cases. In v1.13.0, Velero adds new support for JSON Merge Patch and Strategic Merge Patch, which provide more power and flexibility and allow users to use the same ConfigMap to apply patches on the resources. More design details can be found in Support JSON Merge Patch and Strategic Merge Patch in Resource Modifiers design. For instructions on how to use the feature, please refer to the Resource Modifiers doc.

Node-Agent Concurrency

Velero data movement activities from fs-backups and CSI snapshot data movements run in Velero node-agent, so may be hosted by every node in the cluster and consume resources (i.e. CPU, memory, network bandwidth) from there. With v1.13, users are allowed to configure how many data movement activities (a.k.a, loads) run in each node globally or by node, so that users can better leverage the performance of Velero data movement activities and the resource consumption in the cluster. For more information, check the Node-Agent Concurrency document.

Parallel Files Upload Options

Velero now supports configurable options for parallel files upload when using Kopia uploader to do fs-backups or CSI snapshot data movements which makes speed up backup possible.
For more information, please check Here.

Write Sparse Files Options

If using fs-restore or CSI snapshot data movements, it’s supported to write sparse files during restore. For more information, please check Here.

Backup Describe

In v1.13, the Backup Volume section is added to the velero backup describe command output. The backup Volumes section describes information for all the volumes included in the backup of various backup types, i.e. native snapshot, fs-backup, CSI snapshot, and CSI snapshot data movement. Particularly, the velero backup description now supports showing the information of CSI snapshot data movements, which is not supported in v1.12.

Additionally, backup describe command will not check EnableCSI feature gate from client side, so if a backup has volumes with CSI snapshot or CSI snapshot data movement, backup describe command always shows the corresponding information in its output.

Backup's new VolumeInfo metadata

Create a new metadata file in the backup repository's backup name sub-directory to store the backup-including PVC and PV information. The information includes the backing-up method of the PVC and PV data, snapshot information, and status. The VolumeInfo metadata file determines how the PV resource should be restored. The Velero downstream software can also use this metadata file to get a summary of the backup's volume data information.

Enhancement for CSI Snapshot Data Movements when Velero Pod Restart

When performing backup and restore operations, enhancements have been implemented for Velero server pods or node agents to ensure that the current backup or restore process is not stuck or interrupted after restart due to certain exceptional circumstances.

New status fields added to show hook execution details

Hook execution status is now included in the backup/restore CR status and displayed in the backup/restore describe command output. Specifically, it will show the number of hooks which attempted to execute under the HooksAttempted field and the number of hooks which failed to execute under the HooksFailed field.

AWS SDK Bump Up

Bump up AWS SDK for Go to version 2, which offers significant performance improvements in CPU and memory utilization over version 1.

Azure AD/Workload Identity Support

Azure AD/Workload Identity is the recommended approach to do the authentication with Azure services/AKS, Velero has introduced support for Azure AD/Workload Identity on the Velero Azure plugin side in previous releases, and in v1.13.0 Velero adds new support for Kopia operations(file system backup/data mover/etc.) with Azure AD/Workload Identity.

Runtime and dependencies

To fix CVEs and keep pace with Golang, Velero made changes as follows:

  • Bump Golang runtime to v1.21.6.
  • Bump several dependent libraries to new versions.
  • Bump Kopia to v0.15.0.

Breaking changes

  • Backup describe command: due to the backup describe output enhancement, some existing information (i.e. the output for native snapshot, CSI snapshot, and fs-backup) has been moved to the Backup Volumes section with some format changes.
  • API type changes: changes the field DataMoverConfig in DataUploadSpec from *map[string][string] to map[string]string
  • Velero install command: due to the issue #7264, v1.13.0 introduces a break change that make the informer cache enabled by default to keep the actual behavior consistent with the helper message(the informer cache is disabled by default before the change).

Limitations/Known issues

  • The backup's VolumeInfo metadata doesn't have the information updated in the async operations. This function could be supported in v1.14 release.

Deprecation announcement

  • The generated k8s clients, informers, and listers are deprecated in the Velero v1.13 release. They are put in the Velero repository's pkg/generated directory. According to the n+2 supporting policy, the deprecated are kept for two more releases. The pkg/generated directory should be deleted in the v1.15 release.
  • After the backup VolumeInfo metadata file is added to the backup, Velero decides how to restore the PV resource according to the VolumeInfo content. To support the backup generated by the older version of Velero, the old logic is also kept. The support for the backup without the VolumeInfo metadata file will be kept for two releases. The support logic will be deleted in the v1.15 release.

All Changes

  • Make "disable-informer-cache" option false(enabled) by default to keep it consistent with the help message (#7294, @ywk253100)
  • Fix issue #6928, remove snapshot deletion timeout for PVB (#7282, @Lyndon-Li)
  • Do not set "targetNamespace" to namespace items (#7274, @reasonerjt)
  • Fix issue #7244. By the end of the upload, check the outstanding incomplete snapshots and delete them by calling ApplyRetentionPolicy (#7245, @Lyndon-Li)
  • Adjust the newline output of resource list in restore describer (#7238, @allenxu404)
  • Remove the redundant newline in backup describe output (#7229, @allenxu404)
  • Fix issue #7189, data mover generic restore - don't assume the first volume as the restore volume (#7201, @Lyndon-Li)
  • Update CSIVolumeSnapshotsCompleted in backup's status and the metric
    during backup finalize stage according to async operations content. (#7184, @blackpiglet)
  • Refactor DownloadRequest Stream function (#7175, @blackpiglet)
  • Add --skip-immediately flag to schedule commands; --schedule-skip-immediately server and install (#7169, @kaovilai)
  • Add node-agent concurrency doc and change the config name from dataPathConcurrency to loadCocurrency (#7161, @Lyndon-Li)
  • Enhance hooks tracker by adding a returned error to record function (#7153, @allenxu404)
  • Track the skipped PV when SnapshotVolumes set as false (#7152, @reasonerjt)
  • Add more linters part 2. (#7151, @blackpiglet)
  • Fix issue #7135, check pod status before checking node-agent pod status (#7150, @Lyndon-Li)
  • Treat namespace as a regular restorable item (#7143, @reasonerjt)
  • Allow sparse option for Kopia & Restic restore (#7141, @qiuming-best)
  • Use VolumeInfo to help restore the PV. (#7138, @blackpiglet)
  • Node agent restart enhancement (#7130, @qiuming-best)
  • Fix issue #6695, add describe for data mover backups (#7125, @Lyndon-Li)
  • Add hooks status to backup/restore CR (#7117, @allenxu404)
  • Include plugin name in the error message by operations (#7115, @reasonerjt)
  • Fix issue #7068, due to a behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API is called. So add a protection finalizer to ensure the order (#7102, @Lyndon-Li)
  • Generate VolumeInfo for backup. (#7100, @blackpiglet)
  • Fix issue #7094, fallback to full backup if previous snapshot is not found (#7096, @Lyndon-Li)
  • Fix issue #7068, due to an behavior of CSI external snapshotter, manipulations of VS and VSC may not be handled in the same order inside external snapshotter as the API is called. So add a protection finalizer to ensure the order (#7095, @Lyndon-Li)
  • Skip syncing the backup which doesn't contain backup metadata (#7081, @ywk253100)
  • Fix issue #6693, partially fail restore if CSI snapshot is involved but CSI feature is not ready, i.e., CSI feature gate is not enabled or CSI plugin is not installed. (#7077, @Lyndon-Li)
  • Truncate the credential file to avoid the change of secret content messing it up (#7072, @ywk253100)
  • Add VolumeInfo...
Read more

v1.12.3

12 Jan 05:19
684f713
Compare
Choose a tag to compare

v1.12.3

2024-01-09

Download

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

Container Image

velero/velero:v1.12.3

Documentation

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

Upgrading

https://velero.io/docs/v1.12/upgrade-to-1.12/

All changes

  • Fix issue #7244. By the end of the upload, check the outstanding incomplete snapshots and delete them by calling ApplyRetentionPolicy (#7247, @Lyndon-Li)
  • Fix issue #7189, data mover generic restore - don't assume the first volume as the restore volume (#7203, @Lyndon-Li)
  • Update CSIVolumeSnapshotsCompleted in backup's status and the metric
    during backup finalize stage according to async operations content. (#7202, @blackpiglet)
  • Node agent restart enhancement (#7130, @qiuming-best)
  • Fix issue #6928, remove snapshot deletion timeout for PVB (#7283, @Lyndon-Li)