From 49d57aaf1531e51b103ccf81bac5f8120f1f233d Mon Sep 17 00:00:00 2001 From: Karl Cardenas <29551334+karl-cardenas-coding@users.noreply.github.com> Date: Wed, 11 Sep 2024 12:48:10 -0700 Subject: [PATCH] docs: PAC-1967 Volume Snapshot Support (#3839) * docs: PAC-1967 * docs: vale feedback * docs: updated content per feedback * docs: more feedback changes * docs: Apply suggestions from code review Co-authored-by: caroldelwing --------- Co-authored-by: caroldelwing (cherry picked from commit 361f49d4844d824edaba45d76ff2dbfddb8a1117) --- .../backup-restore/backup-restore.md | 29 +++++++++++++++++++ .../backup-restore/create-cluster-backup.md | 4 +++ .../backup-restore/restore-cluster-backup.md | 4 +++ 3 files changed, 37 insertions(+) diff --git a/docs/docs-content/clusters/cluster-management/backup-restore/backup-restore.md b/docs/docs-content/clusters/cluster-management/backup-restore/backup-restore.md index 7a85f677d4..2ebbe12cdc 100644 --- a/docs/docs-content/clusters/cluster-management/backup-restore/backup-restore.md +++ b/docs/docs-content/clusters/cluster-management/backup-restore/backup-restore.md @@ -94,6 +94,35 @@ or [Add a Backup Location using Dynamic Credentials](/clusters/cluster-management/backup-restore/add-backup-location-dynamic) guide. +## Volume Snapshots + + +You can include [volume snapshots](https://kubernetes.io/docs/concepts/storage/volume-snapshots/) in your cluster backups if the Container Storage Interface (CSI) driver you are using supports them. For more information about volume snapshot support, check the CSI pack README for your CSI driver. You can find a list of all Packs in the +page. + + +If the CSI driver you are using includes the [csi-snapshotter](https://github.com/kubernetes-csi/external-snapshotter) component, then it supports volume snapshotting. If the CSI driver contains the snapshot controller and VolumeSnapshotClass, then all necessary components are already included in the CSI pack and nothing else is needed. If not, you must add the , version 8 or greater, to your cluster profile to install the snapshot controller and VolumeSnapshotClass. These components are necessary to support taking snapshots and including them in your cluster backups. You can learn how to add a pack to a cluster profile by checking out the [Add a Pack](../../../profiles/cluster-profiles/create-cluster-profiles/create-addon-profile/create-pack-addon.md) guide. + +You can use the table below to determine if your CSI driver supports volume snapshots and if you need to include the +Volume Snapshot Controller pack in your cluster profile. + +:::tip + +Always refer to the CSI driver's Pack README for guidance on volume snapshot support. + +::: + +| Scenario | Requires Volume Snapshot Controller Pack | Guidance | +| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------ | +| CSI driver supports volume snapshots but does not contain all the required components, such as the Snapshot Controller, and the VolumeSnapshotClass | Yes | Include the Volume Snapshot Controller pack in the cluster profile | +| CSI driver supports volume snapshots, contains the all required components, such as the Snapshot Controller, and has the VolumeSnapshotClass included | No | Refer to the CSI Pack README for guidance | +| CSI driver does not support volume snapshots | No | Refer to the CSI Pack README for guidance | + +### Volume Snapshots and VMO + + +Clusters deployed with the pack do not need the as the pack already includes the required components for volume snapshots. However, you must ensure the CSI driver supports volume snapshots. Review the CSI driver's Pack README for guidance on volume snapshot support. + ## etcd Backups etcd backups are enabled by default. You can edit the YAML file for a cluster's Kubernetes layer to configure its diff --git a/docs/docs-content/clusters/cluster-management/backup-restore/create-cluster-backup.md b/docs/docs-content/clusters/cluster-management/backup-restore/create-cluster-backup.md index f856e6e8b4..89005539ba 100644 --- a/docs/docs-content/clusters/cluster-management/backup-restore/create-cluster-backup.md +++ b/docs/docs-content/clusters/cluster-management/backup-restore/create-cluster-backup.md @@ -50,6 +50,10 @@ Use the following instructions to schedule a backup for an existing cluster. - An active cluster in Palette. + +- If you want to include volume snapshots in the backup, ensure that your CSI driver supports volume snapshots. For more + information about volume support, review the CSI pack README for your CSI driver in use. Refer to the [Volume Snapshots](backup-restore.md#volume-snapshots) section for more information. + ### Instructions 1. Log in to [Palette](https://console.spectrocloud.com/). diff --git a/docs/docs-content/clusters/cluster-management/backup-restore/restore-cluster-backup.md b/docs/docs-content/clusters/cluster-management/backup-restore/restore-cluster-backup.md index a4668ecd86..7ed7f873a4 100644 --- a/docs/docs-content/clusters/cluster-management/backup-restore/restore-cluster-backup.md +++ b/docs/docs-content/clusters/cluster-management/backup-restore/restore-cluster-backup.md @@ -102,6 +102,10 @@ backup. To learn more about the restore operation, refer to the Velero enables the destination cluster to assume the necessary IAM role to access the backup files. Refer to the [Add a Backup Location using Dynamic Credentials](add-backup-location-dynamic.md) guide. + +- If your backup contains volume snapshots, ensure that your CSI driver supports volume snapshots. For more + information about volume support, review the CSI pack README for your CSI driver in use. Refer to the [Volume Snapshots](backup-restore.md#volume-snapshots) section for more information. + ### Instructions Use the following instructions in Palette to restore a backup to a destination cluster.