From 3a6881dddbacaaa5bbeaf4692b1595204fcfe873 Mon Sep 17 00:00:00 2001 From: Apurva Bhide Date: Mon, 19 May 2025 23:50:09 +0530 Subject: [PATCH 1/3] OADP-1791: Added suggestions for the backup types --- .../backing_up_and_restoring/backing-up-applications.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc index 54b4437ce5f9..fb087e38af9b 100644 --- a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc +++ b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc @@ -12,6 +12,7 @@ Because all taken backup remains until expired, also check the time to live (TTL You can back up applications by creating a `Backup` custom resource (CR). For more information, see xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc#oadp-creating-backup-cr-doc[Creating a Backup CR]. +The following are the different backup types for a `Backup` CR: ifdef::openshift-rosa,openshift-rosa-hcp[] The `Backup` CR creates backup files for Kubernetes resources and internal images on S3 object storage. @@ -19,6 +20,9 @@ endif::openshift-rosa,openshift-rosa-hcp[] ifndef::openshift-rosa,openshift-rosa-hcp[] * The `Backup` CR creates backup files for Kubernetes resources and internal images on S3 object storage. +* For an on-cluster backup, applications and persistent data are fully backed up. This type of backup is fast and can be executed quite often. But the data is vulnerable to cluster or storage outages. You can use CSI volume snapshots. +* For an off-cluster backup, the Openshift object data and persistent data are backed up and moved from a cluster to ensure that a cluster outage does not impact the backup. This type of backup is slower as compared to a on-cluster backup, and should be executed less often than on-cluster. You can use CSI Data Mover backup and Kopia FSB. +* Executing a single backup that performs both on-cluster and off-cluster backup is not possible. * If your cloud provider has a native snapshot API or supports CSI snapshots, the `Backup` CR backs up persistent volumes (PVs) by creating snapshots. For more information about working with CSI snapshots, see xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-backing-up-pvs-csi-doc.adoc#oadp-backing-up-pvs-csi-doc[Backing up persistent volumes with CSI snapshots]. For more information about CSI volume snapshots, see xref:../../../storage/container_storage_interface/persistent-storage-csi-snapshots.adoc#persistent-storage-csi-snapshots[CSI volume snapshots]. From d80def982cb22ef339bb8b02ff4ef8bce6305cab Mon Sep 17 00:00:00 2001 From: Apurva Bhide Date: Tue, 27 May 2025 10:02:11 +0530 Subject: [PATCH 2/3] Peer review and SME review --- .../backing-up-applications.adoc | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc index fb087e38af9b..0ffb77357c1a 100644 --- a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc +++ b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc @@ -20,9 +20,13 @@ endif::openshift-rosa,openshift-rosa-hcp[] ifndef::openshift-rosa,openshift-rosa-hcp[] * The `Backup` CR creates backup files for Kubernetes resources and internal images on S3 object storage. -* For an on-cluster backup, applications and persistent data are fully backed up. This type of backup is fast and can be executed quite often. But the data is vulnerable to cluster or storage outages. You can use CSI volume snapshots. -* For an off-cluster backup, the Openshift object data and persistent data are backed up and moved from a cluster to ensure that a cluster outage does not impact the backup. This type of backup is slower as compared to a on-cluster backup, and should be executed less often than on-cluster. You can use CSI Data Mover backup and Kopia FSB. -* Executing a single backup that performs both on-cluster and off-cluster backup is not possible. + +* In an on-cluster backup, you back up the persistent volume data within the cluster. This type of backup is fast, and you can execute it frequently; however, the data is vulnerable to cluster or storage outages. You can use Container Storage Interface (CSI) volume snapshots for an on-cluster backup. + +* In an off-cluster backup, you back up the Openshift object data and persistent data and move them from a cluster to ensure that a cluster outage does not impact the backup. This type of backup is slower than an on-cluster backup; and therefore you should execute it less frequently than an on-cluster backup. You can use CSI Data Mover backup and Kopia File System Backup (FSB) for an off-cluster backup. + +* You can only execute a single backup that performs either an on-cluster or off-cluster backup. + * If your cloud provider has a native snapshot API or supports CSI snapshots, the `Backup` CR backs up persistent volumes (PVs) by creating snapshots. For more information about working with CSI snapshots, see xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-backing-up-pvs-csi-doc.adoc#oadp-backing-up-pvs-csi-doc[Backing up persistent volumes with CSI snapshots]. For more information about CSI volume snapshots, see xref:../../../storage/container_storage_interface/persistent-storage-csi-snapshots.adoc#persistent-storage-csi-snapshots[CSI volume snapshots]. From a63dbaa289dd83d632f868f47739bb983f7ebcf5 Mon Sep 17 00:00:00 2001 From: Apurva Bhide Date: Sat, 7 Jun 2025 00:47:32 +0530 Subject: [PATCH 3/3] Apply QE suggestions --- .../backing_up_and_restoring/backing-up-applications.adoc | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc index 0ffb77357c1a..85857e665f7f 100644 --- a/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc +++ b/backup_and_restore/application_backup_and_restore/backing_up_and_restoring/backing-up-applications.adoc @@ -21,11 +21,9 @@ endif::openshift-rosa,openshift-rosa-hcp[] ifndef::openshift-rosa,openshift-rosa-hcp[] * The `Backup` CR creates backup files for Kubernetes resources and internal images on S3 object storage. -* In an on-cluster backup, you back up the persistent volume data within the cluster. This type of backup is fast, and you can execute it frequently; however, the data is vulnerable to cluster or storage outages. You can use Container Storage Interface (CSI) volume snapshots for an on-cluster backup. - -* In an off-cluster backup, you back up the Openshift object data and persistent data and move them from a cluster to ensure that a cluster outage does not impact the backup. This type of backup is slower than an on-cluster backup; and therefore you should execute it less frequently than an on-cluster backup. You can use CSI Data Mover backup and Kopia File System Backup (FSB) for an off-cluster backup. - -* You can only execute a single backup that performs either an on-cluster or off-cluster backup. +* If you use Velero's snapshot feature to back up a persistent volume data, only snapshot related information is stored in the s3 bucket along with the Openshift object data. ++ +If the underlying storage or the backup bucket are part of the same cluster, then the data might be lost in case of disaster. * If your cloud provider has a native snapshot API or supports CSI snapshots, the `Backup` CR backs up persistent volumes (PVs) by creating snapshots. For more information about working with CSI snapshots, see xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-backing-up-pvs-csi-doc.adoc#oadp-backing-up-pvs-csi-doc[Backing up persistent volumes with CSI snapshots].