Create a restore

This page describes how to create a manual restore for a backup in Google Distributed Cloud (GDC) air-gapped.

Manual restores enable recovery to a specific point in time by selecting a specific backup version.

Before you begin

To create a restore for a backup, you must have the following:

  • An existing backup. For more information, see Plan a set of backups.

  • The necessary identity and access role:

    • For PA users:
      • User Cluster Backup Admin: manages backup resources such as backup and restore plans in user clusters. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (user-cluster-backup-admin) role.
    • For AO users:
      • Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (backup-creator) role.
    • For more information, see Role definitions.

Create a restore

Create a restore using the GDC console or the API.

Console

  1. Sign in to the GDC console.
  2. In the navigation menu, click Backup for Clusters.
  3. Select a project.
  4. Click the Backups tab.
  5. In the list of backups, find the backup to restore and click Restore.
  6. Choose a restore plan from the list of plans that apply to this backup.
  7. Enter a name and an optional description for the restore.
  8. Click Restore.

API

Create a ManualClusterRestoreRequest custom resource to perform restores from existing ClusterRestorePlan resources. Specify the following resources:

  • The ClusterBackup resource that you want to restore.
  • The name of the ClusterRestore that you want to create
  • The ClusterRestorePlan that matches the ClusterBackupPlan of the ClusterBackup.

Here's an example of a ManualClusterRestoreRequest resource:

apiVersion: backup.gdc.goog/v1
kind: ManualClusterRestoreRequest
metadata:
  name: RESTORE_NAME
  namespace: PROJECT_NAMESPACE
spec:
  clusterRestoreName: RESTORE_NAME
  clusterRestorePlanName: RESTORE_PLAN
  clusterBackupName: BACKUP_NAME

Replace the following:

  • RESTORE_NAME: the name of the cluster restore that you want to create.
  • PROJECT_NAMESPACE: the name of your GDC project.
  • RESTORE_PLAN: the name of the cluster restore plan this cluster restore is derived from.

  • BACKUP_NAME: the cluster backup to restore. This ClusterBackup resource must be associated with the ClusterBackupPlan resource to which the cluster restore plan refers to. For more information, see Plan a set of restores.

    After initiating a ManualClusterRestoreRequest, a ClusterRestore custom resource is created.

What's next