You are looking at the documentation of a prior release. To read the documentation of the latest release, please
visit here.
Auto Backup with Stash
Stash can be configured to automatically backup of any stateful workloads in your cluster. Stash enables cluster administrators to deploy backup blueprints ahead of time so that application owners can easily backup any types of workload with a few annotations. This allows Enterprises to stay prepared for disaster scenarios and recover from offsite secure backups in case of a disaster on public cloud and on-premises datacenters.
What is Auto Backup
Stash uses 1-1 mapping among Repository
, BackupConfiguration
and the target. So, whenever you want to backup a target(workload/PVC/database), you have to create a Repository
and BackupConfiguration
object. This could become tiresome when you are trying to backup similar types of target and the Repository
and BackupConfiguration
have only a slight difference. To mitigate this problem, Stash provides a way to specify a blueprint for these two objects via BackupBlueprint
crd. In Stash parlance, we call this process as Auto Backup.
You have to create only one BackupBlueprint
for all similar types of target. For example, you need only one BackupBlueprint
for Deployment, DaemonSet, StatefulSet etc. Similarly, you have to create only one BackupBlueprint
for all PostgreSQL databases. Then, you just need to add some annotations in the target. Stash will automatically create respective Repository
and BackupConfiguration
objects using the blueprint and perform backups on pre-defined schedule.
How Auto Backup Works?
The following diagram shows how automatic backup works in Stash. Open the image in a new tab to see the enlarged version.
The automatic backup process consists of the following steps:
- A user creates a storage secret with necessary credentials of the backend where the backed up data will be stored.
- Then, he creates a
BackupBlueprint
crd that specifies a blueprint forRepository
andBackupConfiguration
object. - Then, he creates a workload with some specific annotations for automatic backup.
- Stash operator watches for workloads. When it finds a workload with annotations for automatic backup, it finds out the respective
BackupBlueprint
. - Then, Stash operator resolves the blueprint by replacing variable fields of the blueprint with respective information from the workload.
- Then, it creates a
Repository
and aBackupConfiguration
object for the workload according to the resolved blueprint. - Finally, Stash starts rest of the standard backup process as discussed in here.
Note:
BackupBlueprint
is a non-namespaced crd. So, you can use aBackupBlueprint
to backup targets in multiple namespaces. However, Storage Secret is a namespaced object. So, you have to manually create the secret in each namespace where you have a target for backup. Please give us your feedback on how to improve the ux of this aspect of Stash on GitHub.