Configure a storage location where all backups are saved by default. You will have the option to override this with each backup, but will be limited to using an S3-compatible object store.

Only one storage location can be configured at the operator level.

Storage Location Configuration

No Default Storage Location

You can choose to not have any operator-level storage location configured. If you select this option, you must configure an S3-compatible object store as the storage location for each individual backup.

S3-compatible Object Store

ParameterDescription
Credential SecretChoose the credentials for S3 from your secrets in Rancher. Example.
Bucket NameEnter the name of the S3 bucket where the backups will be stored. Default: rancherbackups.
RegionThe AWS region where the S3 bucket is located.
FolderThe folder in the S3 bucket where the backups will be stored.
EndpointThe S3 endpoint For example, s3.us-west-2.amazonaws.com.
Endpoint CAThe CA cert used to for the S3 endpoint. Default: base64 encoded CA cert
insecureTLSSkipVerifySet to true if you are not using TLS.

Existing StorageClass

Installing the rancher-backup chart by selecting the StorageClass option will create a Persistent Volume Claim (PVC), and Kubernetes will in turn dynamically provision a Persistent Volume (PV) where all the backups will be saved by default.

For information about creating storage classes refer to this section.

Important It is highly recommended to use a StorageClass with a reclaim policy of “Retain”. Otherwise if the PVC created by the rancher-backup chart gets deleted (either during app upgrade, or accidentally), the PV will get deleted too, which means all backups saved in it will get deleted.
If no such StorageClass is available, after the PV is provisioned, make sure to edit its reclaim policy and set it to “Retain” before storing backups in it.

Existing Persistent Volume

Select an existing Persistent Volume (PV) that will be used to store your backups. For information about creating PersistentVolumes in Rancher, refer to this section.

Important It is highly recommended to use a Persistent Volume with a reclaim policy of “Retain”. Otherwise if the PVC created by the rancher-backup chart gets deleted (either during app upgrade, or accidentally), the PV will get deleted too, which means all backups saved in it will get deleted.

Example values.yaml for the rancher-backup Helm Chart

This values.yaml file can be used to configure rancher-backup operator when the Helm CLI is used to install it.

For more information about values.yaml files and configuring Helm charts during installation, refer to the Helm documentation.

  1. image:
  2. repository: rancher/rancher-backup
  3. tag: v0.0.1-rc10
  4. ## Default s3 bucket for storing all backup files created by the rancher-backup operator
  5. s3:
  6. enabled: false
  7. ## credentialSecretName if set, should be the name of the Secret containing AWS credentials.
  8. ## To use IAM Role, don't set this field
  9. credentialSecretName: creds
  10. credentialSecretNamespace: ""
  11. region: us-west-2
  12. bucketName: rancherbackups
  13. folder: base folder
  14. endpoint: s3.us-west-2.amazonaws.com
  15. endpointCA: base64 encoded CA cert
  16. # insecureTLSSkipVerify: optional
  17. ## ref: http://kubernetes.io/docs/user-guide/persistent-volumes/
  18. ## If persistence is enabled, operator will create a PVC with mountPath /var/lib/backups
  19. persistence:
  20. enabled: false
  21. ## If defined, storageClassName: <storageClass>
  22. ## If set to "-", storageClassName: "", which disables dynamic provisioning
  23. ## If undefined (the default) or set to null, no storageClassName spec is
  24. ## set, choosing the default provisioner. (gp2 on AWS, standard on
  25. ## GKE, AWS & OpenStack).
  26. ## Refer to https://kubernetes.io/docs/concepts/storage/persistent-volumes/#class-1
  27. ##
  28. storageClass: "-"
  29. ## If you want to disable dynamic provisioning by setting storageClass to "-" above,
  30. ## and want to target a particular PV, provide name of the target volume
  31. volumeName: ""
  32. ## Only certain StorageClasses allow resizing PVs; Refer to https://kubernetes.io/blog/2018/07/12/resizing-persistent-volumes-using-kubernetes/
  33. size: 2Gi
  34. global:
  35. cattle:
  36. systemDefaultRegistry: ""
  37. nodeSelector: {}
  38. tolerations: []
  39. affinity: {}