Definire il comportamento di ripristino dei dati di volume
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Autopilot
Standard
Questa pagina fornisce una panoramica delle policy di ripristino dei dati del volume. Spiega inoltre come configurare gli override e le associazioni della policy di ripristino dei dati del volume.
Panoramica
Il criterio di ripristino dei dati di volume definisce come ripristinare i dati di volume da un backup.
Puoi configurarlo a livello di piano di ripristino. Sono disponibili le seguenti opzioni per le norme:
Esegui il provisioning di nuovi volumi e ripristina i dati di volume dal backup: i nuovi
volumi permanenti (PV) vengono ripristinati utilizzando i dati di backup del volume
corrispondenti nel backup.
Riutilizza i volumi esistenti contenenti i tuoi dati: i PV vengono sottoposti a provisioning preliminare
utilizzando l'handle del volume del PV originale nel backup.
Non ripristinare i dati di volume: i PV non vengono ripristinati. Il backup per GKE ripristina solo le richieste di volumi permanenti (PVC) selezionate e prevede che il driver di archiviazione corrispondente esegua il provisioning dinamico di PV vuoti o li associ a PV di cui è stato eseguito il provisioning predefinito creato out-of-band.
Per istruzioni su come creare un piano di ripristino con criteri di ripristino dei dati del volume,
consulta Creare un piano di ripristino.
Esistono alcuni motivi per cui potresti voler definire un comportamento di ripristino del volume personalizzato
diverso dalla policy di ripristino dei dati del volume predefinita:
Per ripristinare un carico di lavoro con un ambiente di archiviazione che include diversi
tipi di volumi con vari livelli di supporto per il backup dei dati. Ad esempio,
il tuo workload potrebbe contenere volumi NFS e volumi Persistent Disk.
Per applicare un processo di ripristino diverso a un volume specifico.
Backup per GKE fornisce due meccanismi per definire il comportamento di ripristino dei volumi personalizzati:
Binding specifici per il tipo di volume, che puoi definire nell'ambito di un piano di ripristino.
Override specifici per il volume, che puoi definire nell'ambito di un ripristino.
Procedura di selezione della policy di ripristino dei dati di volume
Durante il processo di ripristino, Backup per GKE seleziona il criterio di ripristino del volume
appropriato per ogni PersistentVolumeClaim (PVC) utilizzando la seguente sequenza:
Prima dell'applicazione di qualsiasi regola di trasformazione, ogni PVC da ripristinare viene sottoposto a un processo di selezione e viene applicata la prima norma inclusa nell'ambito.
Se la richiesta di volume permanente non è associata a un volume permanente di cui è stato eseguito il backup, viene ripristinata solo la configurazione della richiesta di volume permanente. Non include alcun dato.
Se la PVC è inclusa in un override del criterio di ripristino dei dati del volume, ha la precedenza il criterio di override.
Se il tipo di volume della PVC è incluso in un binding del criterio di ripristino dei dati del volume,
viene applicato il criterio di binding.
Se nessuna delle condizioni precedenti corrisponde, il PVC utilizza la norma di ripristino dei dati del volume predefinita.
Associazioni della policy per il ripristino dei dati del volume
Le associazioni della policy di ripristino dei dati del volume ti consentono di ripristinare i dati del volume con una policy per un tipo di volume specifico. Questo criterio ha la precedenza sul criterio di ripristino del volume predefinito. L'associazione della policy di ripristino dei dati del volume è supportata solo per i dischi permanenti di Compute Engine.
gcloud
Aggiungi associazioni di criteri di ripristino dei dati del volume a un piano di ripristino esistente:
VOLUME_TYPE=POLICY: associa un tipo di volume supportato a
una policy di ripristino dei dati del volume. Ad esempio, gce-persistent-disk=restore-volume-data-from-backup
crea un binding che comporta il ripristino dei volumi del Persistent Disk utilizzando
il criterio Ripristina i dati di volume dal backup.
Console
Segui queste istruzioni per aggiungere binding a un piano di ripristino esistente nella console Google Cloud :
Nella console Google Cloud , vai alla pagina Google Kubernetes Engine.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic sulla scheda Ripristina piani.
Fai clic sul nome del piano di ripristino.
Fai clic sulla scheda Dettagli.
Nella sezione Restore configuration (Ripristina configurazione), fai clic su Modifica accanto a Ambito.
Nella sezione Definisci l'override della policy per tipi di volume specifici,
fai clic sulla casella di controllo Disco permanente GCE.
Dall'elenco Policy di ripristino dei dati del volume, scegli un tipo di policy di ripristino
che vuoi utilizzare per il disco permanente Compute Engine.
Fai clic su Salva modifiche.
Override del criterio di ripristino dei dati del volume
Gli override della policy di ripristino dei dati del volume definiscono la modalità di ripristino di volumi specifici.
I volumi vengono selezionati in base ai nomi e agli spazi dei nomi delle PVC. Puoi includere
più volumi in una singola sostituzione.
Gli override non impongono un ambito univoco, a differenza dei binding. Ciò significa che durante
il ripristino del volume viene utilizzato il criterio dell'ultimo override che corrisponde allo
spazio dei nomi e al nome di un volume.
Esempio di override
L'esempio seguente esegue l'override di ns-1/test-pvc e ns-1/test-pvc-2 per utilizzare
il criterio Riutilizza i volumi esistenti contenenti i tuoi dati e ns-2/test-pvc-3
per utilizzare il criterio Non ripristinare i dati del volume.
RESTORE_PLAN: il nome del piano di ripristino principale
da cui deriva questo ripristino.
BACKUP: il backup da ripristinare.
OVERRIDES_FILE: il percorso di un file YAML che definisce
gli override nello schema, come mostrato nell'esempio.
Console
Per creare un override della policy di ripristino dei dati del volume, devi fornire il nome della PVC, lo spazio dei nomi della PVC e una policy di ripristino.
Segui queste istruzioni per creare un ripristino con override nella console Google Cloud :
Nella console Google Cloud , vai alla pagina Google Kubernetes Engine.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic sulla scheda Backup.
Nell'elenco dei backup, trova quello che vuoi ripristinare e fai clic su Configura un ripristino.
Scegli un piano di ripristino dall'elenco dei piani applicabili a questo backup.
Nella sezione Assegna un nome al ripristino, inserisci un nome e una descrizione facoltativa per il ripristino.
Nella sezione Esegui override della policy di ripristino dei dati del volume, fai clic su Aggiungi policy
e completa i seguenti passaggi per ogni override:
In Nome PVC, inserisci il nome del PVC.
In Spazio dei nomi, inserisci lo spazio dei nomi del PVC.
Dall'elenco Policy di ripristino del volume, scegli come ripristinare i dati del volume della PVC.
[[["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-01 UTC."],[],[],null,["# Define volume data restore behavior\n\nAutopilot Standard\n\n*** ** * ** ***\n\nThis page provides an overview of volume data restore policies. It also\nexplains how to configure volume data restore policy bindings and overrides.\n\nOverview\n--------\n\nThe volume data restore policy defines how to restore volume data from a backup.\nYou can configure it at the restore plan level. It has the following policy options:\n\n- **Provision new volumes and restore volume data from backup**: New persistent volumes (PVs) are restored using the corresponding volume backup data in the backup.\n- **Reuse existing volumes containing your data**: PVs are pre-provisioned using the volume handle of the original PV in the backup.\n- **Don't restore volume data**: PVs aren't restored. Backup for GKE only restores the selected persistent volume claims (PVCs) and expects the corresponding storage driver to either dynamically provision blank PVs or bind them to pre-provisioned PVs created out-of-band.\n\nFor instructions on creating a restore plan with volume data restore policy,\nsee [Create a restore plan](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore-plan#create_a_restore_plan).\n\nThere are a few reasons why you might want to define custom volume restore\nbehavior apart from the default volume data restore policy:\n\n- To restore a workload with a storage environment that includes different types of volumes with varying levels of data backup support. For example, your workload may contain NFS volumes and Persistent Disk volumes.\n- To apply a different restore process to a specific volume.\n\nBackup for GKE provides two mechanisms for defining custom volume restore behavior:\n\n- Volume type specific bindings, which you can define as part of a [restore plan](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore-plan#create_a_restore_plan).\n- Volume specific overrides, which you can define as part of a [restore](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore#create_a_restore).\n\nVolume data restore policy selection process\n--------------------------------------------\n\nDuring the restore process, Backup for GKE selects the appropriate volume\nrestore policy for each PersistentVolumeClaim (PVC) using the following sequence:\n\n1. Before any transformation rules are applied, each PVC to be restored moves through a selection process and applies the first in-scope policy.\n2. If the PVC is not bound to a backed up PersistentVolume (PV), only the PVC configuration is restored. This doesn't include any data.\n3. If the PVC is included in a volume data restore policy override, the override policy takes precedence.\n4. If the PVC's volume type is included in a volume data restore policy binding, the binding policy is applied.\n5. If none of the earlier conditions match, the PVC uses the default volume data restore policy.\n\n| **Note:** If the **Provision new volumes and restore volume data from backup** policy is applied to a volume without a volume backup, Backup for GKE restores the PVC configuration without data.\n\nVolume data restore policy bindings\n-----------------------------------\n\nThe volume data restore policy bindings let you restore volume data with a\npolicy for a specific volume type. This policy takes precedence over the\ndefault volume restore policy. The volume data restore policy binding is only\nsupported for Compute Engine Persistent Disks. \n\n### gcloud\n\nAdd volume data restore policy bindings to an existing restore plan: \n\n gcloud beta container backup-restore restore-plans update \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e \\\n --volume-data-restore-policy-bindings=[\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nv\"\u003eVOLUME_TYPE\u003c/span\u003e\u003cspan class=\"devsite-syntax-o\"\u003e=\u003c/span\u003ePOLICY,...\u003c/var\u003e]\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e: the name of the restore plan that you want to update.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the [compute region](/compute/docs/regions-zones#available) for the resource, such as `us-central1`.\n- \u003cvar translate=\"no\"\u003eVOLUME_TYPE=POLICY\u003c/var\u003e: binds a supported volume type to a volume data restore policy. For example, `gce-persistent-disk=restore-volume-data-from-backup` creates a binding that results in Persistent Disk volumes being restored using the **Restore volume data from backup** policy.\n\n### Console\n\nUse the following instructions to add bindings to an existing restore plan in the Google Cloud console:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine** page.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. In the navigation menu, click **Backup for GKE**.\n\n3. Click the **Restore plans** tab.\n\n4. Click the restore plan name.\n\n5. Click the **Details** tab.\n\n6. In the **Restore configuration** section, click **Edit** that is next to **Scope**.\n\n7. In the **Define policy override for specific volume types** section,\n click the **GCE Persistent Disk** checkbox.\n\n8. From the **Volume data restore policy** list, choose a restore policy\n type that you want to use for Compute Engine Persistent Disk.\n\n9. Click **Save changes**.\n\nVolume data restore policy overrides\n------------------------------------\n\nThe volume data restore policy overrides define how to restore specific volumes.\nVolumes are selected by their PVC namespaces and PVC names. You can include\nmultiple volumes in a single override.\n\nOverrides don't enforce unique scoping, unlike bindings. This means that during\nvolume restoration, the policy from the latest override that matches a volume's\nnamespace and name is used.\n\n### Override example\n\nThe following example overrides `ns-1/test-pvc` and `ns-1/test-pvc-2` to use\nthe **Reuse existing volumes containing your data** policy and `ns-2/test-pvc-3`\nto use the **Don't restore volume data** policy. \n\n volumeDataRestorePolicyOverrides:\n - policy: REUSE_VOLUME_HANDLE_FROM_BACKUP\n selectedPvcs:\n namespacedNames:\n - namespace: ns-1\n name: test-pvc\n - namespace: ns-1\n name: test-pvc-2\n - policy: NO_VOLUME_DATA_RESTORATION\n selectedPvcs:\n namespacedNames:\n - namespace: ns-2\n name: test-pvc-3\n\n### gcloud\n\nCreate a restore with overrides: \n\n gcloud beta container backup-restore restores create \u003cvar translate=\"no\"\u003eRESTORE\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e \\\n --restore-plan=\u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e \\\n --backup=\u003cvar translate=\"no\"\u003eBACKUP\u003c/var\u003e \\\n --volume-data-restore-policy-overrides-file=\u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eRESTORE\u003c/var\u003e: the name of the restore that you want to create.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the [compute region](/compute/docs/regions-zones#available) of the parent restore plan.\n- \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e: the name of the parent restore plan this restore is derived from.\n- \u003cvar translate=\"no\"\u003eBACKUP\u003c/var\u003e: the backup to restore.\n- \u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e: the path to a YAML file that defines overrides in the schema as seen in the example.\n\n### Console\n\nTo create a volume data restore policy override, you need to provide the\nPVC name, PVC namespace, and a restore policy.\n\nUse the following instructions to create a restore with overrides in the Google Cloud console:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine** page.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. In the navigation menu, click **Backup for GKE**.\n\n3. Click the **Backups** tab.\n\n4. In the list of backups, find the backup that you want to restore and click **Set up a restore**.\n\n5. Choose a restore plan from the list of plans that apply to this backup.\n\n6. In the **Name the restore** section, enter a name and optional description for the restore.\n\n7. In the **Override volume data restore policy** section, click **Add policy**\n and complete the following for each override:\n\n 1. In **PVC name**, enter the name of the PVC.\n 2. In **Namespace**, enter the namespace of the PVC.\n 3. From the **Volume restore policy** list, choose how to restore that PVC's volume data.\n8. Click **Restore**.\n\nWhat's next\n-----------\n\n- Learn more about [restoring a backup](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore)."]]