Cluster scoped

Regardless of from where the Restore operation is initiated, the workflow for the operation is the same, ensuring consistency and simplicity.

For the restore workflow, there are four tabs presented to the user Basic Tab Resource Selector Cluster scoped Namespace Configuration

Basic Tab

This tab cover general restore properties for the backups and snapshots such as name, secrets (if encrypted) and Restore flags. Instead of Namespace selection, there is separate "Namespace configuration section"

Name - Enter the meaningful name of Restore in this field.

Encryption Secret - Select the same secret which is selected in Backup plan from which Backup or Snapshot is created. You can create a new Secret from dropdown option "+ New Encryption Secret".

Restore Flags - As part of every restore, users can select different restore flags to define how the restore should happen. For detailed information about each flag, see the Restore Flags Guide.

The following flags are provided:

Restore Flags

1. SkipIfAlreadyExists - Specifies whether to skip restoring resources if they are already found in the namespace in which the backup is being restored. This is only applicable for metadata resources and not data resources (PV/PVC). For more details with examples, refer SkipIfAlreadyExists.

2. PatchIfAlreadyExists - Specifies whether to patch the spec section of an already existing resource found in the namespace at the time of restore. For more details with examples, refer PatchIfAlreadyExists.

3. RetainHelmReleaseName - Specifies if a user wants to retain the helm release name after restore. For more details with examples, refer RetainHelmReleaseName.

4. RestoreStorageClass - This flag specifies whether the storage class should be restored on site instance or not. For more details with examples, refer RestoreStorageClass.

5. RestoreVMMACAddress - Specifies whether to retain the original MAC address of the VM during restore instead of assigning a new one. For more details with examples, refer RestoreVMMACAddress.

6. ImageRestore - Restores the container images from the backup. For more details with examples, refer ImageRestore.

   • Registry - Registry to which the backup container images should be restored.

   • Repository - Repository in which the restored images should be placed.

   • RegistryAuthSecret - Authentication secret of type kubernetes.io/dockerconfigjson used to push the images to the restore registry.

Action Flags

1. CleanupOnFailure - Specifies whether to perform cleanup of resources created along with reverting updated resources in case the restore operation fails. For more details with examples, refer CleanupOnFailure.

2. ProtectRestoredApp - Specifies whether to create a backupplan at the destination namespace/cluster to protect the application after it has been restored. With this flag, users can ensure that their application is protected no matter which cluster it runs on. For more details with examples, refer ProtectRestoredApp.

3. RestoreNamespaceLabelsAnnotations Specifies the strategy for restoring labels and annotations of the backed-up namespace to the restored namespace.

   • Override Updates values of keys present in both the namespace and backup; adds missing keys from backup; does not remove keys that are not in the backup.

   • Append Keeps existing labels/annotations and only adds those not present from the backup.

   • Replace Removes all existing labels/annotations and replaces them entirely with those from the backup.

   For detailed information about restoration strategies, configuration examples, and use cases, see Restore Namespace Labels and Annotations.

Advanced Flags

1. PatchCRD - Specifies whether to patch spec of an already existing CRD. For more details with examples, refer PatchCRD.

2. OnlyMetadata - Restores only the metadata components from a backup. For more details with examples, refer OnlyMetadata.

3. OnlyData - Restores only the data volume components from a backup. For more details with examples, refer OnlyData.

4. OmitMetadata - Specifies whether to omit metadata labels, annotations of resources while restoring them. For more details with examples, refer OmitMetadata.

5. SkipOperatorResources - Specifies whether to omit operator resources at the time of restore (for the use case when an Operator is already present, but the application of that operator needs to be restored). For more details with examples, refer SkipOperatorResources.

6. DisableIgnoreResources - Specifies the behaviour of the default list of resources being ignored at the time of restore. If set to true, those resources will not be ignored. For more details with examples, refer DisableIgnoreResources.

7. UseOCPNamespaceUIDRange - Openshift specific flag to restore the data with the ocp namespace UID range. For more details with examples, refer UseOCPNamespaceUIDRange.

8. ResourcesReadyWaitSeconds - This holds the wait time in seconds for which, TVK application will wait for user application's resources to come up in the restore process. For more details with examples, refer ResourcesReadyWaitSeconds.

To view list of ignored resources: Click here

Next button - Click on Next if user wants to setup advance configuration in Restore.

Create button - Click on this button to directly create Restore without any advance configuration like Resource selector, transformation and hooks.

Resource Selector

This is to configure the include/ exclude resources at global level.

When redirects from Basic tab and if Target browsing of Backup or Snapshot namespace is disable, user see a toggle to enable the target browsing. click on that toggle to enable the target browsing to set up a resource selector.

Include resources - Restore will done with only selected resources in this field. This wont Restore all other resources available in Backup or Snapshot. 1. Labels set - This tab is used to select the Labels to include In the Restore. 2. Resources - This tab is used to select the Resources to include In the Restore. \

Exclude resources - Restore will done without selected resources in this field. This Restore all other resources available in Backup or Snapshot. This also have Label set selector and Resources selector same as Include Resources.

Transform Components

This is to configure the Transform component at global level.

From a resource transform perspective, Trilio provides the ability to transform Helm Charts and transform custom resources. Helm charts can be transformed based on Key:Value pairs whereas custom resources can be transformed by specifying GVKO and Operation (Replace, Move etc.) type.

For both Helm and Custom Transforms - Trilio fetches the metadata and populates it via dropdown menus and tables - to make it easy for the user to manage the granular details of the transforms. User can add custom transformation if Backup or Snapshots are of type operatorTransforms, custom, virtual machine like below.

If the transformation path doesn’t appear in the list, you can manually create it by typing the path and selecting Create “” from the dropdown. For example, if a user has the following section in any resource:

tolerations:
  - effect: "NoSchedule"
    key: "dedicated"
    operator: "Equal"
    value: "storage-nodes"
  - effect: "NoExecute"
    key: "critical"
    operator: "Exists"

and the user wants to remove the second array item (effect: NoExecute), they can type the path and select the Create option. This will remove the entire second array item.

User can add helm transformation if Backup or Snapshots are of type helm type and if Backup or Snapshot is a Namespace scope, then retainHelmApp flag should enable in the Backup plan.

Summary Screen based on TransformsNamespace

Namespace Configuration

This is to configure the Namespace in which user wants to take Restore of a Backup or a Snapshot. In this tab user can configure the restored namespace, include/ exclude resources from that namespace, transformation and hook configuration.

Click on Add Configuration to configure more for the namespace.

1. Basic Tab -

   1. Namespace - Select the Namespace in which user wants to take Restore of a child Backup or a Snapshot from selected namespace. You can create a new Namespace from dropdown option "+ New Namespace"

   2. Encryption Secret - Select the same secret which is selected in Backup plan from which Backup or Snapshot is created. You can create a new Secret from dropdown option "+ New Encryption Secret".

   3. Namespace name - this shows the name of Namespace for which configuration is In-progress.

   4. Restore Flags - As part of every restore, users can select different restore flags to define how the restore should happen. Refer Basic Tab or see the Restore Flags Guide for detailed information about each flag.

   5. Back - This is to redirect back to Namespace selection page from configuration section.

   6. Next - This is to redirect to next page of configuration.

   7. Add - Click on this if user wants to add the namespace configuration.

2. Resource selector - This is to configure the include/ exclude resources in the selected Namespace at namespace level. refer Resource Selector

3. Transform Components - This is to configure the transformation in selected namespace at namespace level. refer Transform Components

4. Hook confirmation - This is to configure the hooks in selected namespace. refer #hooks-configuration