README
¶
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 public cloud platform 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
The documentation provides a getting started guide and information about building from source, architecture, extending 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, file an issue, or talk to us on the #velero channel 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 documentation for guidance on how to setup Velero for development.
Changelog
See the list of releases to find out about feature changes.
Velero compatibility matrix
The following is a list of the supported Kubernetes versions for each Velero version.
| Velero version | Expected Kubernetes version compatibility | Tested on Kubernetes version |
|---|---|---|
| 1.13 | 1.18-latest | 1.26.5, 1.27.3, 1.27.8, and 1.28.3 |
| 1.12 | 1.18-latest | 1.25.7, 1.26.5, 1.26.7, and 1.27.3 |
| 1.11 | 1.18-latest | 1.23.10, 1.24.9, 1.25.5, and 1.26.1 |
| 1.10 | 1.18-latest | 1.22.5, 1.23.8, 1.24.6 and 1.25.1 |
| 1.9 | 1.18-latest | 1.20.5, 1.21.2, 1.22.5, 1.23, and 1.24 |
| 1.8 | 1.18-latest |
Velero supports IPv4, IPv6, and dual stack environments. Support for this was tested against Velero v1.8.
The Velero maintainers are continuously working to expand testing coverage, but are not able to test every combination of Velero and supported Kubernetes versions for each Velero release. The table above is meant to track the current testing coverage and the expected supported Kubernetes versions for each Velero version. If you have a question about test coverage before v1.9, please reach out in the #velero-users Slack channel.
If you are interested in using a different version of Kubernetes with a given Velero version, we'd recommend that you perform testing before installing or upgrading your environment. For full information around capabilities within a release, also see the Velero release notes or Kubernetes release notes. See the Velero support page for information about supported versions of Velero.
For each release, Velero maintainers run the test to ensure the upgrade path from n-2 minor release. For example, before the release of v1.10.x, the test will verify that the backup created by v1.9.x and v1.8.x can be restored using the build to be tagged as v1.10.x.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
config
|
|
|
crd/v1/crds
Package crds embeds the controller-tools generated CRD manifests
|
Package crds embeds the controller-tools generated CRD manifests |
|
crd/v2alpha1/crds
Package crds embeds the controller-tools generated CRD manifests
|
Package crds embeds the controller-tools generated CRD manifests |
|
hack
|
|
|
internal
|
|
|
pkg
|
|
|
apis/velero/v1
Package v1 is the v1 version of the API.
|
Package v1 is the v1 version of the API. |
|
apis/velero/v2alpha1
Package v2alpha1 is the v2alpha1 version of the API.
|
Package v2alpha1 is the v2alpha1 version of the API. |
|
buildinfo
Package buildinfo holds build-time information like the velero version.
|
Package buildinfo holds build-time information like the velero version. |
|
generated/clientset/versioned
This package has the automatically generated clientset.
|
This package has the automatically generated clientset. |
|
generated/clientset/versioned/fake
This package has the automatically generated fake clientset.
|
This package has the automatically generated fake clientset. |
|
generated/clientset/versioned/scheme
This package contains the scheme of the automatically generated clientset.
|
This package contains the scheme of the automatically generated clientset. |
|
generated/clientset/versioned/typed/velero/v1
This package has the automatically generated typed clients.
|
This package has the automatically generated typed clients. |
|
generated/clientset/versioned/typed/velero/v1/fake
Package fake has the automatically generated clients.
|
Package fake has the automatically generated clients. |
|
generated/clientset/versioned/typed/velero/v2alpha1
This package has the automatically generated typed clients.
|
This package has the automatically generated typed clients. |
|
generated/clientset/versioned/typed/velero/v2alpha1/fake
Package fake has the automatically generated clients.
|
Package fake has the automatically generated clients. |
|
install
Package install provides public functions for easily creating and installing resources necessary for Velero to operate.
|
Package install provides public functions for easily creating and installing resources necessary for Velero to operate. |
|
persistence/mocks
Code generated by mockery v1.0.0.
|
Code generated by mockery v1.0.0. |
|
plugin/clientmgmt/process
Package clientmgmt contains the plugin client for Velero.
|
Package clientmgmt contains the plugin client for Velero. |
|
plugin/framework
Package framework is the common package that any plugin client will need to import, for example, both plugin authors and Velero core.
|
Package framework is the common package that any plugin client will need to import, for example, both plugin authors and Velero core. |
|
plugin/velero
Package velero contains the interfaces necessary to implement all of the Velero plugins.
|
Package velero contains the interfaces necessary to implement all of the Velero plugins. |
|
third_party
|
|