Restoring a Kubernetes Namespace or Cluster-Level Entities Out of Place

You can restore an application out of place to any Kubernetes cluster that is added to Commvault Cloud, for application migration or disaster recovery. You can migrate Kubernetes applications between different Kubernetes distributions, clusters, and StorageClasses. Commvault Cloud requires the source and destination cluster to use the same major release of Kubernetes. For example, you can restore Kubernetes 1.23 to Kubernetes 1.23.

Go to the Restore Wizard

1. From the navigation pane, go to Protect > Kubernetes.

   The Overview page appears.

2. On the Application groups tab, in the row for the application group that contains the content that you want to restore, click the action button , and then click Restore.

   The Select restore type page appears.

3. Click Namespace and cluster level.

   The Restore page appears.

4. Select the content to restore:

   • To restore the entire cluster, select all namespaces, and then click Restore.

   • To restore specific namespaces, select the namespaces, and then click Restore.

   The Destination page of the configuration wizard appears.

Destination

1. For Type, select Out of place.

2. For Destination cluster, select the cluster to restore the content to.

   You can select any Kubernetes cluster that is added to Commvault Cloud.

3. From the Access node list, select the access node to perform the restore.

   For optimal performance, select an access node that has low latency to the Kubernetes cluster and the backup copy.

4. Click Next.

   The Namespaces page of the configuration wizard appears.

Namespaces

1. To modify the namespace, in the Change namespace to column, specify the name of the namespace.

2. To specify the source and destination storage classes, select the check box next to the name space, and then click Configure restore options.

3. In the configure restore options window, under Storage Class, click Add.

4. In the Storage class window, select the source and destination storage classes, and then click Save.

5. Click Save.

6. To configure restore exclusions, click Exclude resources.

   The Restore exclusions window appears.

7. From Filter list, select an existing restore filter from either the source or destination cluster or click + to add a new filter.

   If you add a new resource filter during restore operation, then it is added to the cv-config namespace.

   Note

   Commvault Cloud needs the cv-config namespace and a custom CRD cvresourcefilters.k8s.cv.io to be present on the cluster. If the namespace and CRD are not present, when you create your resource filter, the software automatically creates a new namespace called cv-config and deploys a new CustomResourceDefinition (CRD) to your cluster.

8. In the Exclusions area, from the Exclude list, select Exclude by rule.

   The Add rule dialog box appears.

9. From the list, select Kind, Group, Version, Namespace, Name, or Label, and then specify the rule.

10. Click Save.

11. To exclude the application-related API resources, move the Exclude sub-resources toggle key to the right.

    The Exclude sub-resources area appears.

12. From the Exclude list, select Exclude by Rule

    The Add rule dialog box appears.

13. From the list, select Kind, Group, Version, Namespace, Name, or Label, and then specify the rule.

14. Click Save.

15. Click Next.

    The Restore Options page of the configuration wizard appears.

Restore Options

1. To delete and overwrite existing data, move the Unconditionally overwrite if it already exists toggle key to the right, and then click Yes in the confirmation dialog box.

   If any data matching the restore data exists in the destination, Commvault Cloud deletes the existing data before starting the restore process.

2. To use resource modifiers to add, delete, and modify fields in the Kubernetes resource YAMLs that you restore, under Additional options, do the following:

   • To use an existing resource modifier from either the source or destination cluster, select the resource modifier.

   • To specify a new resource modifier or to change an existing modifier, click Edit Modifiers.

   For more information about resource modifiers, see Modifying Fields in Restored Kubernetes Resource YAMLs.

3. Click Next.

   The Summary page of the configuration wizard appears.

Summary

1. Review the selected namespaces and restore options.

2. Click Submit.