Before you begin
To perform the restore for an org admin cluster, you must have the following components in place:
- A backup site identified that contains the backup to be restored.
- Access to both the backup and restore sites with help from the Infrastructure Operator (IO).
- The capability to perform remote backup across the two sites with help from the IO involved in your disaster recovery planning.
- Have the necessary identity and access roles:
- DR Backup Admin: performs disaster recovery backups. Ask your Organization IAM Admin to grant you the DR Backup Admin (
dr-backup-admin
) cluster role. - DR System Admin: manage objects in
dr-system
namespace for setting up control plane backups. Ask your Organization IAM Admin to grant you the DR System Admin (dr-system-admin
) role.
- DR Backup Admin: performs disaster recovery backups. Ask your Organization IAM Admin to grant you the DR Backup Admin (
- A working org admin cluster with default resources on the restore site.
- The gdcloud CLI must be installed and added to your user path. To install gdcloud CLI, see Install the gdcloud CLI.
Run the commands on this page on an org admin cluster from the specified site.
Create backup repository on the target site
Get the bucket details on the backup site, and save the bucket information in a local file in JSON format:
gdcloud dr buckets describe --cluster=CLUSTER_NAME --source-site=SOURCE_SITE --output-path=BUCKET_CONFIG_FILE
Replace the following variables:
SOURCE_SITE
: the identifier of the source site as chosen by the customer. For example,us-west
.CLUSTER_NAME
: the cluster name for root admin cluster. For example,root-admin
.BUCKET_CONFIG_FILE
: The path of saved bucket configuration file.
Transfer the bucket config file to the restore site, and create a backup repository on the restore site:
gdcloud dr backup-repositories create --cluster=CLUSTER_NAME --bucket-config-file=BUCKET_CONFIG_FILE --force=true
Verify that the backups are loaded on the restore site:
kubectl get backups -n dr-system
The disaster recovery backups have the following prefix:
dr-backup-plan
A successful backup has a
Succeeded
state.
Perform restoration
After the earlier steps are complete, provide the backup repository and the backup plan name to the IO and instruct them to perform the restoration.