Définir le comportement de restauration des données de volume
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Autopilot
Standard
Cette page présente les règles de restauration des données de volume. Elle explique également comment configurer des liaisons et des exceptions sur les règles de restauration des données de volume.
Présentation
La règle de restauration des données de volume définit la façon dont les données de volume seront restaurées à partir d'une sauvegarde.
Vous pouvez la configurer au niveau du plan de restauration. Elle propose les options suivantes :
Provisionner de nouveaux volumes et restaurer les données de volume à partir de la sauvegarde : les nouveaux volumes persistants (PV, Persistent Volume) sont restaurés à l'aide des données de sauvegarde de volume correspondantes dans la sauvegarde.
Réutiliser les volumes existants contenant vos données : les PV sont préprovisionnés à l'aide du descripteur de volume du PV d'origine dans la sauvegarde.
Ne pas restaurer les données du volume : les PV ne sont pas restaurés. Le service Sauvegarde pour GKE restaure uniquement les demandes de volume persistant (PVC, Persistent Volume Claim) sélectionnées et attend du pilote de stockage correspondant soit qu'il provisionne de manière dynamique des PV vides, soit qu'il les associe à des PV préprovisionnés créés hors bande.
Pour savoir comment créer un plan de restauration avec une règle de restauration des données de volume, consultez la section Créer un plan de restauration.
Il existe différents cas d'utilisation pour lesquels vous pourrez souhaiter définir un comportement de restauration de volume personnalisé, au-delà de la règle de restauration des données de volume par défaut :
Pour restaurer une charge de travail avec un environnement de stockage incluant différents types de volumes avec différents niveaux de compatibilité de la sauvegarde de données. Par exemple, votre charge de travail peut contenir des volumes NFS et des volumes Persistent Disk.
Pour appliquer un autre processus de restauration à un volume spécifique.
Sauvegarde pour GKE propose deux mécanismes permettant de définir un comportement de restauration de volume personnalisé :
Des liaisons spécifiques au type de volume, que vous pouvez définir dans le cadre d'un plan de restauration.
Des exceptions spécifiques à certains volumes, que vous pouvez définir dans le cadre d'une restauration.
Processus de sélection de la règle de restauration des données de volume
Au cours du processus de restauration, Sauvegarde pour GKE sélectionne la règle de restauration de volume appropriée pour chaque PersistentVolumeClaim (PVC), en appliquant la séquence suivante :
Avant que des règles de transformation ne soient appliquées, chaque PVC à restaurer passe par un processus de sélection et applique la première règle correspondant au champ d'application.
Si le PVC n'est pas associé à un PersistentVolume (PV) sauvegardé, seule la configuration de PVC est restaurée. Cette configuration n'inclut aucune donnée.
Si le PVC est inclus dans une exception à la règle de restauration des données de volume, l'exception à la règle a priorité.
Si le type de volume de la PVC est inclus dans une liaison de règle de restauration des données de volume, la règle de liaison est appliquée.
Si aucune des conditions précédentes ne correspond, la PVC utilise la règle de restauration des données de volume par défaut.
Liaisons de règles de restauration des données de volume
Les liaisons de règles de restauration des données de volume vous permettent de restaurer des données de volume à l'aide d'une règle, pour un type de volume spécifique. Cette règle est prioritaire sur la règle de restauration de volume par défaut. La liaison de règle de restauration des données de volume n'est disponible que pour les volumes Persistent Disk Compute Engine.
gcloud
Ajoutez des liaisons de règles de restauration des données de volume à un plan de restauration existant :
RESTORE_PLAN : nom du plan de restauration que vous souhaitez mettre à jour.
PROJECT_ID : ID de votre projet Google Cloud .
LOCATION : région de calcul de la ressource, par exemple us-central1.
VOLUME_TYPE=POLICY : lie un type de volume compatible à une règle de restauration des données de volume. Par exemple, gce-persistent-disk=restore-volume-data-from-backup crée une liaison qui entraîne la restauration de volumes Persistent Disk à l'aide de la règle Restaurer les données de volume à partir de la sauvegarde.
Console
Suivez les instructions ci-dessous pour ajouter des liaisons à un plan de restauration existant dans la console Google Cloud :
Dans la console Google Cloud , accédez à la page Google Kubernetes Engine.
Dans le menu de navigation, cliquez sur Sauvegarde pour GKE.
Cliquez sur l'onglet Plans de restauration.
Cliquez sur le nom du plan de restauration.
Cliquez sur l'onglet Détails.
Dans la section Configuration de restauration, cliquez sur le bouton Modifier situé à côté de Portée.
Dans la section Définir des exceptions aux règles pour des types de volume spécifiques, cochez la case Disque persistant GCE.
Dans la liste Règle de restauration des données de volume, choisissez le type de règle de restauration que vous souhaitez utiliser pour le volume Persistent Disk Compute Engine.
Cliquez sur Enregistrer les modifications.
Forçages de la règle de restauration des données de volume
Les exceptions à la règle de restauration des données de volume définissent la façon dont des volumes spécifiques seront restaurés.
Les volumes sont sélectionnés en fonction de leur espace de noms et de leur nom de PVC. Vous pouvez inclure plusieurs volumes dans une même exception.
Les exceptions n'appliquent pas de champ d'application unique, contrairement aux liaisons. Cela signifie que lors de la restauration d'un volume, la règle utilisée est celle de la dernière exception correspondant à l'espace de noms et au nom d'un volume.
Exemple d'exception
L'exemple suivant force ns-1/test-pvc et ns-1/test-pvc-2 à utiliser la règle Réutiliser les volumes existants contenant vos données, et ns-2/test-pvc-3 à utiliser la règle Ne pas restaurer les données du volume.
RESTORE_PLAN : nom du plan de restauration parent à partir duquel cette restauration est dérivée.
BACKUP : sauvegarde à restaurer.
OVERRIDES_FILE : chemin d'accès à un fichier YAML qui définit les exceptions dans le schéma, comme illustré dans l'exemple.
Console
Pour créer une exception à la règle de restauration des données de volume, vous devez indiquer le nom de la PVC, son espace de noms et une règle de restauration.
Suivez les instructions ci-dessous pour créer une restauration avec des exceptions dans la console Google Cloud :
Dans la console Google Cloud , accédez à la page Google Kubernetes Engine.
Dans le menu de navigation, cliquez sur Sauvegarde pour GKE.
Cliquez sur l'onglet Sauvegardes.
Dans la liste des sauvegardes, identifiez celle que vous souhaitez restaurer, puis cliquez sur Configurer une restauration.
Choisissez un plan de restauration dans la liste des plans qui s'appliquent à cette sauvegarde.
Dans la section Nommer la restauration, saisissez un nom et éventuellement une description pour la restauration.
Dans la section Remplacer la règle de restauration des données de volume, cliquez sur Ajouter une règle, puis procédez comme suit pour chaque exception :
Dans Nom de la PVC, saisissez le nom de la PVC.
Dans Espace de noms, saisissez l'espace de noms de la PVC.
Dans la liste Règle de restauration de volume, choisissez comment restaurer les données de volume de cette PVC.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
