Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive in dettaglio come creare backup manuali, visualizzare i backup esistenti ed eliminare i backup esistenti per i carichi di lavoro del cluster in Google Distributed Cloud (GDC) air-gapped.
Prima di iniziare
Per creare, visualizzare ed eliminare i backup, devi disporre di quanto segue:
Il ruolo di identità e accesso necessario:
Per gli utenti con ruolo di amministratore della piattaforma:
Amministratore backup cluster utente: gestisce le risorse di backup come i piani di backup e ripristino nei cluster utente. Chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore backup cluster utente (user-cluster-backup-admin).
Per gli utenti con ruolo Operatore applicazione (AO):
Backup Creator: crea backup manuali ed esegue ripristini. Chiedi all'amministratore IAM del progetto di concederti il ruolo Autore backup (backup-creator).
Gli utenti di AO possono eseguire solo backup manuali da un piano di backup esistente.
Crea una copia di back manuale
Se il piano di backup definisce una pianificazione per il backup, i backup vengono
creati automaticamente in base a questa pianificazione. Puoi anche creare manualmente un backup
al di fuori dell'ambito della pianificazione del piano di backup. Ad esempio, potresti voler eseguire il backup dei tuoi carichi di lavoro prima di eseguire l'upgrade delle applicazioni. Un backup non include le informazioni di configurazione del cluster, come le configurazioni dei nodi, i node pool, le dimensioni iniziali del cluster o le funzionalità abilitate.
In un backup vengono acquisite due forme di dati:
Backup della configurazione: un insieme di descrizioni delle risorse Kubernetes estratte dal server API del cluster sottoposto a backup.
Backup del volume: un backup di PersistentVolumeClaims.
Console
Accedi alla console GDC.
Nel menu di navigazione, fai clic su Backup per i cluster.
Fai clic sulla scheda Piani di backup.
Fai clic sul piano che vuoi utilizzare per il backup.
Fai clic su Avvia un backup.
Inserisci un nome per il backup e una descrizione facoltativa.
Imposta il numero di giorni per conservare il backup. Una volta raggiunto questo numero di giorni, il backup viene eliminato automaticamente.
Imposta il numero di giorni durante i quali i backup non possono essere eliminati.
Fai clic su Avvia.
API
Il backup manuale deve fare riferimento a un piano di backup esistente per la configurazione del backup e deve essere creato emettendo un ManualClusterBackupRequest.
Sostituisci PROJECT_NAME con il nome del tuo progetto GDC.
Questo esempio include i seguenti valori:
Valore
Descrizione
clusterBackupName
Il nome del backup da creare.
clusterBackupPlanRef
Il nome di ClusterBackupPlan da utilizzare per la configurazione del backup. Il piano di backup deve esistere nello stesso spazio dei nomi di ManualClusterBackupRequest.
deleteLockDays
Blocca l'eliminazione del backup per il numero di giorni specificato dopo la creazione del backup. Questa azione sostituisce retentionPolicy in
ClusterBackupPlan.
retainDays
Elimina i backup una volta raggiunto il numero di giorni specificato dopo
la creazione del backup. Questo valore sostituisce retentionPolicy in ClusterBackupPlan.
I criteri di conservazione non sostituiscono quelli della posizione di archiviazione e non possono superare i 90 giorni.
Visualizzare un backup
Gli utenti con il ruolo Amministratore backup cluster utente (user-cluster-backup-admin) possono visualizzare tutti i backup nell'organizzazione.
Gli utenti con il ruolo Autore backup (backup-creator) possono visualizzare tutti i backup di un progetto.
Console
Accedi alla console GDC.
Nel menu di navigazione, fai clic su Backup per i cluster.
Fai clic su Seleziona progetto per selezionare un'organizzazione o un progetto a seconda
del tuo ruolo:
Amministratore backup cluster utente: seleziona un'organizzazione per visualizzare tutti i backup
in un'organizzazione o seleziona un progetto per visualizzare tutti i backup in un
progetto.
Creatore del backup: seleziona un progetto per visualizzare tutti i backup in un progetto.
Fai clic sulla scheda Backup.
Fai clic su un backup nell'elenco per visualizzarne i dettagli.
kubectl
Visualizzare un elenco dei backup:
kubectlgetclusterBackups
Un esempio di output:
NAME STATE
backup-test Succeeded
Eliminare un backup
I backup non possono essere eliminati tramite una normale interazione con il server API Kubernetes. Per eliminare un backup, utilizza la console GDC o esegui un comando DeleteClusterBackupRequest.
Console
Elimina il backup dalla scheda Backup:
Accedi alla console GDC.
Nel menu di navigazione, fai clic su Backup per i cluster.
Fai clic su Seleziona progetto per selezionare un'organizzazione o un progetto a seconda
del tuo ruolo:
Amministratore backup cluster utente: seleziona un'organizzazione per visualizzare tutti i backup
in un'organizzazione o seleziona un progetto per visualizzare tutti i backup in un
progetto.
Creatore del backup: seleziona un progetto per visualizzare tutti i backup in un progetto.
Fai clic sulla scheda Backup.
Fai clic sull'icona del menu con tre puntini per il backup che vuoi eliminare.
Digita il nome del backup nella casella di testo.
Fai clic sul pulsante Elimina backup per completare l'eliminazione di questo backup.
In alternativa, elimina il backup facendo clic sul nome del backup quando visualizzi un piano di backup:
Accedi alla console GDC.
Nel menu di navigazione, fai clic su Backup per i cluster.
Fai clic su Seleziona progetto e seleziona un'organizzazione o un progetto a seconda del tuo ruolo:
Amministratore del backup del cluster utente: seleziona un'organizzazione per visualizzare tutti i piani di backup in un'organizzazione oppure seleziona un progetto per visualizzare tutti i piani di backup in un progetto.
Creatore del backup: seleziona un progetto per visualizzare tutti i piani di backup in un progetto.
Fai clic sulla scheda Piani di backup.
Fai clic sul nome del piano di backup contenente il backup che vuoi eliminare.
Fai clic sulla scheda Backup.
Fai clic sul nome del backup che vuoi eliminare.
Fai clic sul pulsante Elimina backup.
Inserisci il nome del backup nel campo di testo.
Fai clic sul pulsante Elimina per completare l'eliminazione di questo backup.
Sostituisci PROJECT_NAME con il nome del tuo progetto GDC.
Questo esempio include i seguenti valori:
backupName: il nome del backup da eliminare. Questo backup deve esistere
nello stesso spazio dei nomi di DeleteClusterBackupRequest.
DeleteClusterBackupRequest: la risorsa che elimina la risorsa personalizzata di backup dal cluster
e rimuove tutti gli artefatti associati a quel backup dalla posizione di archiviazione
del backup, inclusi i dati del volume.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis page guides users on managing cluster workload backups in Google Distributed Cloud (GDC) air-gapped environments, covering the creation, viewing, and deletion of backups.\u003c/p\u003e\n"],["\u003cp\u003eCreating manual backups can be done through the GDC console or API, referencing an existing backup plan, and users must have appropriate roles, either User Cluster Backup Admin or Backup Creator.\u003c/p\u003e\n"],["\u003cp\u003eUsers can view backups through the GDC console or \u003ccode\u003ekubectl\u003c/code\u003e, with visibility determined by their assigned role: User Cluster Backup Admins can view all backups, while Backup Creators can only see backups within their project.\u003c/p\u003e\n"],["\u003cp\u003eDeleting backups requires using the GDC console or a \u003ccode\u003eDeleteClusterBackupRequest\u003c/code\u003e via API, and it is important to note that deleting backups is an irreversible action.\u003c/p\u003e\n"],["\u003cp\u003eBackups consist of config backup, a set of kubernetes resource descriptions, and volume backup, a backup of PersistentVolumeClaims, but it does not include cluster configurations.\u003c/p\u003e\n"]]],[],null,["# Back up your workloads\n\nThis page details how to create manual backups, view existing backups, and delete existing backups for cluster workloads in Google Distributed Cloud (GDC) air-gapped.\n\nBefore you begin\n----------------\n\nTo create, view, and delete backups, you must have the following:\n\n- The necessary identity and access role:\n\n - For Platform Administrator (PA) users:\n - 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.\n - For Application Operator (AO) users:\n - Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (`backup-creator`) role.\n - For more information, see [Role definitions](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/role-definitions).\n- AO users can only perform manual backups from an existing backup\n plan.\n\nCreate a manual backup\n----------------------\n\nIf your backup plan defines a schedule for the backup, the backups are\nautomatically created according to that schedule. You can also manually create a backup\noutside the scope of your backup plan schedule. For example, you might want to back\nup your workloads before you upgrade your applications. A backup does not\ninclude cluster configuration information, such as node configurations, node\npools, initial cluster size, or what features are enabled.\n\nTwo forms of data are captured in a backup:\n\n- **Config backup**: A set of Kubernetes resource descriptions extracted from the API server of the cluster undergoing backup.\n- **Volume backup** : A backup of `PersistentVolumeClaims`.\n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click the **Backup Plans** tab.\n4. Click the plan that you want to use for the backup.\n5. Click **Start a backup**.\n6. Enter a backup name and an optional description.\n7. Set the number of days to retain the backup. Once this number of days is reached, the backup is automatically deleted.\n8. Set the number of days during which backups cannot be deleted.\n9. Click **Start**.\n\n### API\n\nThe manual backup must reference an existing backup plan for the backup\nconfiguration and the backup must be created by issuing a\n`ManualClusterBackupRequest`.\n\nHere's an example of a `ManualClusterBackupRequest`: \n\n apiVersion: backup.gdc.goog/v1\n kind: ManualClusterBackupRequest\n metadata:\n name: manualbackuprequest-test\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n clusterBackupName: \"backup-test\"\n clusterBackupPlanRef: \"backupplan-test\"\n deleteLockDays: 5\n retainDays: 6\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your GDC project.\n\nThis example includes the following values:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nView a backup\n-------------\n\nUsers with the User Cluster Backup Admin (`user-cluster-backup-admin`) role can see all backups in the organization.\nUsers with the Backup Creator (`backup-creator`) role can see all of the backups in a project. \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** to select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backups in an organization or select a project to see all backups in a project.\n - Backup Creator: Select a project to see all backups in a project.\n4. Click the **Backups** tab.\n5. Click a backup in the list to view its details.\n\n### kubectl\n\nView a list of your backups: \n\n kubectl get clusterBackups\n\nAn example of the output: \n\n NAME STATE\n backup-test Succeeded\n\nDelete a backup\n---------------\n\nBackups can't be deleted by a regular interaction with the Kubernetes API\nserver. To delete a backup, use the GDC console or issue a `DeleteClusterBackupRequest`. \n\n### Console\n\nDelete the backup from the **Backups** tab:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** to select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all backups in an organization, or select a project to see all backups in a project.\n - Backup Creator: Select a project to see all backups in a project.\n4. Click the **Backups** tab.\n5. Click the three-dot menu icon for the backup you want to delete.\n6. Type the name of the backup into the text box.\n7. Click the **Delete Backup** button to complete the deletion of this backup.\n\n | **Note:** This operation can't be undone.\n\nAlternatively, delete the backup by clicking on the backup name when viewing a backup plan:\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** , and select an organization or project depending on your role:\n - User Cluster Backup Admin: Select an organization to see all of the backup plans in an organization, or select a project to see all of the backup plans in a project.\n - Backup Creator: Select a project to see all of the backup plans in a project.\n4. Click the **Backup Plans** tab.\n5. Click the name of the backup plan containing the backup you want to delete.\n6. Click the **Backups** tab.\n7. Click the name of the backup you want to delete.\n8. Click the **Delete Backup** button.\n9. Enter the name of the backup into the text field.\n10. Click the **Delete** button to complete the deletion of this backup.\n\n | **Note:** This operation can't be undone.\n\n### kubectl\n\nSend a `DeleteClusterBackupRequest` request: \n\n apiVersion: backup.gdc.goog/v1\n kind: DeleteClusterBackupRequest\n metadata:\n name: deletebackuprequest-test\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n clusterBackupRef: \"backup-test\"\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of your GDC project.\n\nThis example includes the following values:\n\n- `backupName`: the name of the backup being deleted. This backup must exist in the same namespace as the `DeleteClusterBackupRequest`.\n- `DeleteClusterBackupRequest`: the resource that deletes the backup custom resource from the cluster and removes all artifacts associated with that backup from the storage location of the backup, including volume data.\n\n| **Note:** Attempting to delete a `ClusterBackup` resource without applying a `DeleteClusterBackupRequest` resource doesn't clean object storage artifacts and might result in undefined behavior.\n\nWhat's next\n-----------\n\n- [Plan a set of restores](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster-backup/plan-restores)"]]
