forked from vmware-tanzu/velero
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add changelog and docs for v1.6.0-rc.1
Signed-off-by: Bridget McErlean <[email protected]> Signed-off-by: Pradeep Jigalur <[email protected]>
- Loading branch information
Showing
78 changed files
with
6,504 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,72 @@ | ||
| ## v1.6.0-rc.1 | ||
| ### 2021-03-29 | ||
|
|
||
| ### Download | ||
| https://github.com/vmware-tanzu/velero/releases/tag/v1.6.0-rc.1 | ||
|
|
||
| ### Container Image | ||
| `velero/velero:v1.6.0-rc.1` | ||
|
|
||
| ### Documentation | ||
| https://velero.io/docs/v1.6.0-rc.1/ | ||
|
|
||
| ### Upgrading | ||
| https://velero.io/docs/v1.6.0-rc.1/upgrade-to-1.6/ | ||
|
|
||
| ### Highlights | ||
|
|
||
| * Support for per-BSL credentials | ||
| * Progress reporting for restores | ||
| * Restore API Groups by priority level | ||
| * Restic v0.12.0 upgrade | ||
| * End-to-end testing | ||
| * CLI usability improvements | ||
|
|
||
| ### All Changes | ||
|
|
||
| * Add support for restic to use per-BSL credentials. Velero will now serialize the secret referenced by the `Credential` field in the BSL and use this path when setting provider specific environment variables for restic commands. (#3489, @zubron) | ||
| * Upgrade restic from v0.9.6 to v0.12.0. (#3528, @ashish-amarnath) | ||
| * Progress reporting added for Velero Restores (#3125, @pranavgaikwad) | ||
| * Add uninstall option for velero cli (#3399, @vadasambar) | ||
| * Add support for per-BSL credentials. Velero will now serialize the secret referenced by the `Credential` field in the BSL and pass this path through to Object Storage plugins via the `config` map using the `credentialsFile` key. (#3442, @zubron) | ||
| * Fixed a bug where restic volumes would not be restored when using a namespace mapping. (#3475, @zubron) | ||
| * Restore API group version by priority. Increase timeout to 3 minutes in DeploymentIsReady(...) function in the install package (#3133, @codegold79) | ||
| * Add field and cli flag to associate a credential with a BSL on BSL create|set. (#3190, @carlisia) | ||
| * Add colored output to `describe schedule/backup/restore` commands (#3275, @mike1808) | ||
| * Add CAPI Cluster and ClusterResourceSets to default restore priorities so that the capi-controller-manager does not panic on restores. (#3446, @nrb) | ||
| * Use label to select Velero deployment in plugin cmd (#3447, @codegold79) | ||
| * feat: support setting BackupStorageLocation CA certificate via `velero backup-location set --cacert` (#3167, @jenting) | ||
| * Add restic initContainer length check in pod volume restore to prevent restic plugin container disappear in runtime (#3198, @shellwedance) | ||
| * Bump versions of external snapshotter and others in order to make `go get` to succeed (#3202, @georgettica) | ||
| * Support fish shell completion (#3231, @jenting) | ||
| * Change the logging level of PV deletion timeout from Debug to Warn (#3316, @MadhavJivrajani) | ||
| * Set the BSL created at install time as the "default" (#3172, @carlisia) | ||
| * Capitalize all help messages (#3209, @jenting) | ||
| * Increased default Velero pod memory limit to 512Mi (#3234, @dsmithuchida) | ||
| * Fixed an issue where the deletion of a backup would fail if the backup tarball couldn't be downloaded from object storage. Now the tarball is only downloaded if there are associated DeleteItemAction plugins and if downloading the tarball fails, the plugins are skipped. (#2993, @zubron) | ||
| * feat: add delete sub-command for BSL (#3073, @jenting) | ||
| * 🐛 BSLs with validation disabled should be validated at least once (#3084, @ashish-amarnath) | ||
| * feat: support configures BackupStorageLocation custom resources to indicate which one is the default (#3092, @jenting) | ||
| * Added "--preserve-nodeports" flag to preserve original nodePorts when restoring. (#3095, @yusufgungor) | ||
| * Owner reference in backup when created from schedule (#3127, @matheusjuvelino) | ||
| * issue: add flag to the schedule cmd to configure the `useOwnerReferencesInBackup` option #3176 (#3182, @matheusjuvelino) | ||
| * cli: allow creating multiple instances of Velero across two different namespaces (#2886, @alaypatel07) | ||
| * Feature: It is possible to change the timezone of the container by specifying in the manifest.. env: [TZ: Zone/Country], or in the Helm Chart.. configuration: {extraEnvVars: [TZ: 'Zone/Country']} (#2944, @mickkael) | ||
| * Fix issue where bare `velero` command returned an error code. (#2947, @nrb) | ||
| * Restore CRD Resource name to fix CRD wait functionality. (#2949, @sseago) | ||
| * Fixed 'velero.io/change-pvc-node-selector' plugin to fetch configmap using label key "velero.io/change-pvc-node-selector" (#2970, @mynktl) | ||
| * Compile with Go 1.15 (#2974, @gliptak) | ||
| * Fix BSL controller to avoid invoking init() on all BSLs regardless of ValidationFrequency (#2992, @betta1) | ||
| * Ensure that bound PVCs and PVs remain bound on restore. (#3007, @nrb) | ||
| * Allows the restic-wait container to exist in any order in the pod being restored. Prints a warning message in the case where the restic-wait container isn't the first container in the list of initialization containers. (#3011, @doughepi) | ||
| * Add warning to velero version cmd if the client and server versions mismatch. (#3024, @cvhariharan) | ||
| * 🐛 Use namespace and name to match PVB to Pod restore (#3051, @ashish-amarnath) | ||
| * Fixed various typos across codebase (#3057, @invidian) | ||
| * 🐛 ItemAction plugins for unresolvable types should not be run for all types (#3059, @ashish-amarnath) | ||
| * Basic end-to-end tests, generate data/backup/remove/restore/verify. Uses distributed data generator (#3060, @dsu-igeek) | ||
| * Added GitHub Workflow running Codespell for spell checking (#3064, @invidian) | ||
| * Pass annotations from schedule to backup it creates the same way it is done for labels. Add WithannotationsMap function to builder to be able to pass map instead of key/val list (#3067, @funkycode) | ||
| * Add instructions to clone repository for examples in docs (#3074, @MadhavJivrajani) | ||
| * 🏃♂️ update setup-kind github actions CI (#3085, @ashish-amarnath) | ||
| * Modify wrong function name to correct one. (#3106, @shellwedance) | ||
| * Add additional printer columns for Velero CRDs to allow more information to be exposed when using `kubectl get`. (#2881, @zubron) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -15,6 +15,7 @@ params: | |
| latest: v1.5 | ||
| versions: | ||
| - main | ||
| - v1.6.0-rc.1 | ||
| - v1.5 | ||
| - v1.4 | ||
| - v1.3.2 | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,58 @@ | ||
| --- | ||
| toc: "false" | ||
| cascade: | ||
| version: main | ||
| toc: "true" | ||
| --- | ||
| ![100] | ||
|
|
||
| [![Build Status][1]][2] | ||
|
|
||
| ## Overview | ||
|
|
||
| Velero (formerly Heptio Ark) gives you tools to back up and restore your Kubernetes cluster resources and persistent volumes. You can run Velero with a cloud provider or on-premises. Velero lets you: | ||
|
|
||
| * Take backups of your cluster and restore in case of loss. | ||
| * Migrate cluster resources to other clusters. | ||
| * Replicate your production cluster to development and testing clusters. | ||
|
|
||
| Velero consists of: | ||
|
|
||
| * A server that runs on your cluster | ||
| * A command-line client that runs locally | ||
|
|
||
| ## Documentation | ||
|
|
||
| This site is our documentation home with installation instructions, plus information about customizing Velero for your needs, architecture, extending Velero, contributing to Velero and more. | ||
|
|
||
| Please use the version selector at the top of the site to ensure you are using the appropriate documentation for your version of Velero. | ||
|
|
||
| ## Troubleshooting | ||
|
|
||
| If you encounter issues, review the [troubleshooting docs][30], [file an issue][4], or talk to us on the [#velero channel][25] on the Kubernetes Slack server. | ||
|
|
||
| ## Contributing | ||
|
|
||
| If you are ready to jump in and test, add code, or help with documentation, follow the instructions on our [Start contributing](https://velero.io/docs/v1.6.0-rc.1/start-contributing/) documentation for guidance on how to setup Velero for development. | ||
|
|
||
| ## Changelog | ||
|
|
||
| See [the list of releases][6] to find out about feature changes. | ||
|
|
||
| [1]: https://github.com/vmware-tanzu/velero/workflows/Main%20CI/badge.svg | ||
| [2]: https://github.com/vmware-tanzu/velero/actions?query=workflow%3A"Main+CI" | ||
|
|
||
| [4]: https://github.com/vmware-tanzu/velero/issues | ||
| [6]: https://github.com/vmware-tanzu/velero/releases | ||
|
|
||
| [9]: https://kubernetes.io/docs/setup/ | ||
| [10]: https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-with-homebrew-on-macos | ||
| [11]: https://kubernetes.io/docs/tasks/tools/install-kubectl/#tabset-1 | ||
| [12]: https://github.com/kubernetes/kubernetes/blob/main/cluster/addons/dns/README.md | ||
| [14]: https://github.com/kubernetes/kubernetes | ||
| [24]: https://groups.google.com/forum/#!forum/projectvelero | ||
| [25]: https://kubernetes.slack.com/messages/velero | ||
|
|
||
| [30]: troubleshooting.md | ||
|
|
||
| [100]: img/velero.png |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| --- | ||
| title: "Table of Contents" | ||
| layout: docs | ||
| --- | ||
|
|
||
| ## API types | ||
|
|
||
| Here we list the API types that have some functionality that you can only configure via json/yaml vs the `velero` cli | ||
| (hooks) | ||
|
|
||
| * [Backup][1] | ||
| * [Restore][2] | ||
| * [Schedule][3] | ||
| * [BackupStorageLocation][4] | ||
| * [VolumeSnapshotLocation][5] | ||
|
|
||
| [1]: backup.md | ||
| [2]: restore.md | ||
| [3]: schedule.md | ||
| [4]: backupstoragelocation.md | ||
| [5]: volumesnapshotlocation.md |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| --- | ||
| layout: docs | ||
| title: API types | ||
| --- | ||
|
|
||
| Here's a list the API types that have some functionality that you can only configure via json/yaml vs the `velero` cli | ||
| (hooks) | ||
|
|
||
| * [Backup][1] | ||
| * [Restore][2] | ||
| * [Schedule][3] | ||
| * [BackupStorageLocation][4] | ||
| * [VolumeSnapshotLocation][5] | ||
|
|
||
| [1]: backup.md | ||
| [2]: restore.md | ||
| [3]: schedule.md | ||
| [4]: backupstoragelocation.md | ||
| [5]: volumesnapshotlocation.md |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,148 @@ | ||
| --- | ||
| title: "Backup API Type" | ||
| layout: docs | ||
| --- | ||
|
|
||
| ## Use | ||
|
|
||
| Use the `Backup` API type to request the Velero server to perform a backup. Once created, the | ||
| Velero Server immediately starts the backup process. | ||
|
|
||
| ## API GroupVersion | ||
|
|
||
| Backup belongs to the API group version `velero.io/v1`. | ||
|
|
||
| ## Definition | ||
|
|
||
| Here is a sample `Backup` object with each of the fields documented: | ||
|
|
||
| ```yaml | ||
| # Standard Kubernetes API Version declaration. Required. | ||
| apiVersion: velero.io/v1 | ||
| # Standard Kubernetes Kind declaration. Required. | ||
| kind: Backup | ||
| # Standard Kubernetes metadata. Required. | ||
| metadata: | ||
| # Backup name. May be any valid Kubernetes object name. Required. | ||
| name: a | ||
| # Backup namespace. Must be the namespace of the Velero server. Required. | ||
| namespace: velero | ||
| # Parameters about the backup. Required. | ||
| spec: | ||
| # Array of namespaces to include in the backup. If unspecified, all namespaces are included. | ||
| # Optional. | ||
| includedNamespaces: | ||
| - '*' | ||
| # Array of namespaces to exclude from the backup. Optional. | ||
| excludedNamespaces: | ||
| - some-namespace | ||
| # Array of resources to include in the backup. Resources may be shortcuts (for example 'po' for 'pods') | ||
| # or fully-qualified. If unspecified, all resources are included. Optional. | ||
| includedResources: | ||
| - '*' | ||
| # Array of resources to exclude from the backup. Resources may be shortcuts (for example 'po' for 'pods') | ||
| # or fully-qualified. Optional. | ||
| excludedResources: | ||
| - storageclasses.storage.k8s.io | ||
| # Whether or not to include cluster-scoped resources. Valid values are true, false, and | ||
| # null/unset. If true, all cluster-scoped resources are included (subject to included/excluded | ||
| # resources and the label selector). If false, no cluster-scoped resources are included. If unset, | ||
| # all cluster-scoped resources are included if and only if all namespaces are included and there are | ||
| # no excluded namespaces. Otherwise, if there is at least one namespace specified in either | ||
| # includedNamespaces or excludedNamespaces, then the only cluster-scoped resources that are backed | ||
| # up are those associated with namespace-scoped resources included in the backup. For example, if a | ||
| # PersistentVolumeClaim is included in the backup, its associated PersistentVolume (which is | ||
| # cluster-scoped) would also be backed up. | ||
| includeClusterResources: null | ||
| # Individual objects must match this label selector to be included in the backup. Optional. | ||
| labelSelector: | ||
| matchLabels: | ||
| app: velero | ||
| component: server | ||
| # Whether or not to snapshot volumes. This only applies to PersistentVolumes for Azure, GCE, and | ||
| # AWS. Valid values are true, false, and null/unset. If unset, Velero performs snapshots as long as | ||
| # a persistent volume provider is configured for Velero. | ||
| snapshotVolumes: null | ||
| # Where to store the tarball and logs. | ||
| storageLocation: aws-primary | ||
| # The list of locations in which to store volume snapshots created for this backup. | ||
| volumeSnapshotLocations: | ||
| - aws-primary | ||
| - gcp-primary | ||
| # The amount of time before this backup is eligible for garbage collection. If not specified, | ||
| # a default value of 30 days will be used. The default can be configured on the velero server | ||
| # by passing the flag --default-backup-ttl. | ||
| ttl: 24h0m0s | ||
| # Whether restic should be used to take a backup of all pod volumes by default. | ||
| defaultVolumesToRestic: true | ||
| # Actions to perform at different times during a backup. The only hook supported is | ||
| # executing a command in a container in a pod using the pod exec API. Optional. | ||
| hooks: | ||
| # Array of hooks that are applicable to specific resources. Optional. | ||
| resources: | ||
| - | ||
| # Name of the hook. Will be displayed in backup log. | ||
| name: my-hook | ||
| # Array of namespaces to which this hook applies. If unspecified, the hook applies to all | ||
| # namespaces. Optional. | ||
| includedNamespaces: | ||
| - '*' | ||
| # Array of namespaces to which this hook does not apply. Optional. | ||
| excludedNamespaces: | ||
| - some-namespace | ||
| # Array of resources to which this hook applies. The only resource supported at this time is | ||
| # pods. | ||
| includedResources: | ||
| - pods | ||
| # Array of resources to which this hook does not apply. Optional. | ||
| excludedResources: [] | ||
| # This hook only applies to objects matching this label selector. Optional. | ||
| labelSelector: | ||
| matchLabels: | ||
| app: velero | ||
| component: server | ||
| # An array of hooks to run before executing custom actions. Only "exec" hooks are supported. | ||
| pre: | ||
| - | ||
| # The type of hook. This must be "exec". | ||
| exec: | ||
| # The name of the container where the command will be executed. If unspecified, the | ||
| # first container in the pod will be used. Optional. | ||
| container: my-container | ||
| # The command to execute, specified as an array. Required. | ||
| command: | ||
| - /bin/uname | ||
| - -a | ||
| # How to handle an error executing the command. Valid values are Fail and Continue. | ||
| # Defaults to Fail. Optional. | ||
| onError: Fail | ||
| # How long to wait for the command to finish executing. Defaults to 30 seconds. Optional. | ||
| timeout: 10s | ||
| # An array of hooks to run after all custom actions and additional items have been | ||
| # processed. Only "exec" hooks are supported. | ||
| post: | ||
| # Same content as pre above. | ||
| # Status about the Backup. Users should not set any data here. | ||
| status: | ||
| # The version of this Backup. The only version supported is 1. | ||
| version: 1 | ||
| # The date and time when the Backup is eligible for garbage collection. | ||
| expiration: null | ||
| # The current phase. Valid values are New, FailedValidation, InProgress, Completed, PartiallyFailed, Failed. | ||
| phase: "" | ||
| # An array of any validation errors encountered. | ||
| validationErrors: null | ||
| # Date/time when the backup started being processed. | ||
| startTimestamp: 2019-04-29T15:58:43Z | ||
| # Date/time when the backup finished being processed. | ||
| completionTimestamp: 2019-04-29T15:58:56Z | ||
| # Number of volume snapshots that Velero tried to create for this backup. | ||
| volumeSnapshotsAttempted: 2 | ||
| # Number of volume snapshots that Velero successfully created for this backup. | ||
| volumeSnapshotsCompleted: 1 | ||
| # Number of warnings that were logged by the backup. | ||
| warnings: 2 | ||
| # Number of errors that were logged by the backup. | ||
| errors: 0 | ||
|
|
||
| ``` |
Oops, something went wrong.