Cluster Restores

Every time a cluster backup job runs successfully, it creates a recovery point. You can use any existing recovery point to restore your cluster resources and persistent volumes (PVs). The restore can be performed to the same cluster or to a different cluster.

Restriction: With the Free Service Plan, backup retention times are limited to a maximum of 30 days.

Restoring a cluster backup

In the Restore page for clusters, you can create a new restore job and run it to restore cluster resources and persistent volumes (PVs). The data can be restored to either the source cluster or to a different cluster. In the case of latter, you can choose an existing cluster or create a new one in any cloud provider account you have registered with CloudCasa.

In the cluster restore page, click Define Restore + to open the Restore Cluster pane, and take the following steps to define and run a restore job for a cluster:

  1. In the Source Cluster step, select the cluster to restore.

    Tip

    You can choose only one cluster for each restore job.

  2. In the Recovery Point step, select a recovery point from the list. You can use filters and sorting to help you to quickly find the best one.

  3. In the Select Resources step, you will choose which resources to restore.

    Select namespaces to restore

    Select All Protected Namespaces to restore resources in all namespaces. Choose Select Namespaces in order to to specify particular namespaces. Note that only namespaces which were included in the backup will be displayed.

    Select labels (optional)

    Leave this this option off to restore all resources regardless of their labels. Enable it to selectively restore resources based on their labels by entering key-value pairs, for example, “product: life-insurance”.

    Select resource types (optional)

    Leave this option off to restore all resources regardless of type. Enable it to select one or more resource types to restore. You can select common resource types from the drop-down list, or type in the names of custom resources.

    Exclude Persistent Volumes

    Select this option to skip restoring persistent volumes.

    Note that the filters applied by this page are additive. For example, if you select namespace “alpha”, select label “color:red” and select resource type “secret”, only resources from namespace alpha with the type secret and having the label “color:red” will be restored. Also note that resources which already exist in the destination cluster will not be overwritten.

    Click Next to proceed.

  4. In the Destination step, select the destination cluster for the restore:

    Select destination

    By default, your cluster resources will be restored to the same cluster where backup was taken. You can select another cluster or create a new cluster if a cloud account has been registered. If you wish to automatically create a new cluster, see the Creating a new cluster during restore section below.

    Add prefix/Add suffix

    Add a prefix or suffix to the restored namespace(s). For example, if there were namespaces “sales” and “services” in the original cluster and you add a suffix, “-clare”, to the namespaces, the restore job will create the namespaces “sales-clare” and “services-clare” in the destination cluster.

    Preserve node ports

    If selected, automatically assigned node ports for services in the source cluster will be preserved upon restore. Make sure that these ports are available in the target cluster.

    Note that any manually assigned node ports are not affected by this option and are always preserved on restore.

  5. In the App Hooks step, you can add specify application hooks used to invoke application-specific commands after PVs have been restored. For more information about this feature, see App Hooks.

  6. In the Summary step, you can review the summary of the new cluster restoration job. You must also enter a name for the job here, which will be used to identify it in the activity view and on the restores page.

    Click Restore to create the new cluster restore job.

Creating a new cluster during restore

A restore can be performed to an existing cluster or to a new cluster created by CloudCasa. If the “Create new cluster” option is selected when selecting a destination, you will be presented the options to create an EKS, AKS, or GKE cluster during the restore job.

Select the cloud account that will be used to create the cluster.

Tip

The option for each cloud cluster type will only be available if the related cloud account has been registered with CloudCasa.

Click Next to update the configuration for the new cloud cluster. If restoring to the same cloud account as the source cluster, some fields will be automatically filled with the configuration stored in the backup. During the restore job, CloudCasa will first create the cluster using parameters from the backup and the configuration provided and then proceed with restoring the Kubernetes resources and any persistent data. The parameters required to create the cluster may be different for each cloud provider:

Creating an AWS EKS cluster

The following fields are used by CloudCasa to create an EKS cluster on AWS:

  1. Cluster name: the name for the newly created cluster. This must be a name unique to the AWS region.

  2. AWS user: the user that will have access to this cluster once the restore is complete.

  3. Region: the AWS region where this EKS cluster will be created.

  4. EKS Cluster IAM role: the IAM role that will allow the cluster to make calls to other AWS services.

    See also

    For information on how to find or create an EKS cluster IAM role see:

  5. VPC Configuration: Select the VPC and subnet groups which will be used by the EKS cluster. Also select any security groups to associate with the cluster, or leave this field empty to allow Amazon EKS to create a security group for you.

  6. Node Pools Config: the configuration for each EKS node group. Click Add Node Pool to create nodes of different configurations.

    1. Node IAM role: the IAM role that will allow the cluster nodes to make calls to other AWS services.

      See also

      For information on how to find or create an EKS node IAM role see:

    2. VM Size: the instance type to use for each node.

      See also

      For view a list of all the available instance types see:

    3. TMP Disk Size (system): the root device disk size (in GiB) for each node.

    4. Worker node auto-scaling: the minimum, maximum, and desired number of nodes for this configuration.

Creating an Azure AKS cluster

The following fields are used by CloudCasa to create an AKS cluster on Azure:

  1. Cluster name: the name for the newly created cluster.

  2. Resource group: select an Azure resource group that will be associated with the cluster.

  3. Region: the Azure region where this AKS cluster will be created.

  4. Client ID: the client ID credential used when creating the AKS cluster.

  5. Client Secret: the client secret credential used when creating the AKS cluster.

  6. Node Pools Config: the configuration for each AKS node pool. Click Add Node Pool to create nodes of different configurations.

    1. VM Size: the VM size to be used by each node.

      See also

      For view a list of all the available VM sizes see:

    2. Node pool mode: can be set to either “system”, to host critical system pods, or “user” for general applications.

    3. Node count: the number of nodes to be created by this node pool configuration.