Documentation for version v1.0.0 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
Velero Backup Storage Locations
Backup Storage Location
Velero can store backups in a number of locations. These are represented in the cluster via the BackupStorageLocation CRD.
Velero must have at least one BackupStorageLocation. By default, this is expected to be named default, however the name can be changed by specifying --default-backup-storage-location on velero server. Backups that do not explicitly specify a storage location will be saved to this BackupStorageLocation.
A sample YAML BackupStorageLocation looks like the following:
apiVersion: velero.io/v1
kind: BackupStorageLocation
metadata:
name: default
namespace: velero
spec:
provider: aws
objectStorage:
bucket: myBucket
config:
region: us-west-2
Parameter Reference
The configurable parameters are as follows:
Main config parameters
| Key | Type | Default | Meaning |
|---|---|---|---|
provider |
String (Velero natively supports aws, gcp, and azure. Other providers may be available via external plugins.) |
Required Field | The name for whichever cloud provider will be used to actually store the backups. |
objectStorage |
ObjectStorageLocation | Specification of the object storage for the given provider. | |
objectStorage/bucket |
String | Required Field | The storage bucket where backups are to be uploaded. |
objectStorage/prefix |
String | Optional Field | The directory inside a storage bucket where backups are to be uploaded. |
config |
map[string]string(See the corresponding AWS, GCP, and Azure-specific configs or your provider’s documentation.) | None (Optional) | Configuration keys/values to be passed to the cloud provider for backup storage. |
AWS
(Or other S3-compatible storage)
config
| Key | Type | Default | Meaning |
|---|---|---|---|
region |
string | Empty | Example: “us-east-1"See AWS documentation for the full list.Queried from the AWS S3 API if not provided. |
s3ForcePathStyle |
bool | false |
Set this to true if you are using a local storage service like Minio. |
s3Url |
string | Required field for non-AWS-hosted storage | Example: http://minio:9000You can specify the AWS S3 URL here for explicitness, but Velero can already generate it from region, and bucket. This field is primarily for local storage services like Minio. |
publicUrl |
string | Empty | Example: https://minio.mycluster.comIf specified, use this instead of s3Url when generating download URLs (e.g., for logs). This field is primarily for local storage services like Minio. |
kmsKeyId |
string | Empty | Example: “502b409c-4da1-419f-a16e-eif453b3i49f” or “alias/<KMS-Key-Alias-Name>"Specify an
AWS KMS key id or alias to enable encryption of the backups stored in S3. Only works with AWS S3 and may require explicitly granting key usage rights. |
signatureVersion |
string | "4" |
Version of the signature algorithm used to create signed URLs that are used by velero cli to download backups or fetch logs. Possible versions are “1” and “4”. Usually the default version 4 is correct, but some S3-compatible providers like Quobyte only support version 1. |
Azure
config
| Key | Type | Default | Meaning |
|---|---|---|---|
resourceGroup |
string | Required Field | Name of the resource group containing the storage account for this backup storage location. |
storageAccount |
string | Required Field | Name of the storage account for this backup storage location. |
GCP
No parameters required.
Getting Started
To help you get started, see the documentation.