Stay organized with collections
Save and categorize content based on your preferences.
This page contains the steps you must follow to install and configure the
components that are necessary to backup and restore your workloads in Google Distributed Cloud (GDC) air-gapped.
Before you begin
An S3 endpoint and bucket on GDC object storage with an S3 access key ID and secret access key.
A working cluster.
The necessary identity and access role:
For Platform Administrator (PA) users:
User Cluster Backup Admin: manages backups. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (user-cluster-backup-admin) role.
For Application Operator (AO) users:
Backup Creator: creates backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (backup-creator) role.
Verify backup and restore installation
Verify that the gpcbackup control plane and
agent are both running for the cluster you want to back up:
kubectlgetpods-ngpc-backup-system
After running the command, the output looks like the following example. There
should be two pods running, a control plane pod and an agent pod:
NAME READY STATUS RESTARTS AGE
gpcbackup-agent-0 1/1 Running 2 64m
gpcbackup-controlplane-controller-6fc9485ff-jdk95 1/1 Running 0 64m
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis page details the installation and configuration steps for backing up and restoring workloads in Google Distributed Cloud (GDC) air-gapped environments.\u003c/p\u003e\n"],["\u003cp\u003eYou will need an endpoint and bucket on GDC object storage with corresponding access keys, and a functioning cluster to proceed.\u003c/p\u003e\n"],["\u003cp\u003ePlatform Administrator (PA) users require the \u003ccode\u003euser-cluster-backup-admin\u003c/code\u003e role, while Application Operator (AO) users need the \u003ccode\u003ebackup-creator\u003c/code\u003e role.\u003c/p\u003e\n"],["\u003cp\u003eTo verify the installation, confirm that both the \u003ccode\u003egpcbackup\u003c/code\u003e control plane and agent pods are running in the \u003ccode\u003egpc-backup-system\u003c/code\u003e namespace using \u003ccode\u003ekubectl get pods\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Install backup and restore components\n\nThis page contains the steps you must follow to install and configure the\ncomponents that are necessary to backup and restore your workloads in Google Distributed Cloud (GDC) air-gapped.\n\nBefore you begin\n----------------\n\n- An S3 endpoint and bucket on GDC object storage with an S3 access key ID and secret access key.\n- A working cluster.\n- The necessary identity and access role:\n\n - For Platform Administrator (PA) users:\n - User Cluster Backup Admin: manages backups. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (`user-cluster-backup-admin`) role.\n - For Application Operator (AO) users:\n - Backup Creator: creates backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (`backup-creator`) role.\n\nVerify backup and restore installation\n--------------------------------------\n\nVerify that the `gpcbackup` control plane and\nagent are both running for the cluster you want to back up: \n\n kubectl get pods -n gpc-backup-system\n\nAfter running the command, the output looks like the following example. There\nshould be two pods running, a control plane pod and an agent pod: \n\n NAME READY STATUS RESTARTS AGE\n gpcbackup-agent-0 1/1 Running 2 64m\n gpcbackup-controlplane-controller-6fc9485ff-jdk95 1/1 Running 0 64m\n\nWhat's next\n-----------\n\n- [Add a backup repository](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster-backup/add-backup-repository)"]]
