Définir le comportement de restauration des données de volume

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 :

  1. 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.
  2. 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.
  3. 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é.
  4. 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.
  5. 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 :

  gcloud beta container backup-restore restore-plans update RESTORE_PLAN \
      --project=PROJECT_ID \
      --location=LOCATION \
      --volume-data-restore-policy-bindings=[VOLUME_TYPE=POLICY,...]

Remplacez les éléments suivants :

  • 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 via la console Google Cloud :

  1. Dans Google Cloud Console, accédez à la page Google Kubernetes Engine.

    Accéder à Google Kubernetes Engine

  2. Dans le menu de navigation, cliquez sur Sauvegarde pour GKE.

  3. Cliquez sur l'onglet Plans de restauration.

  4. Cliquez sur le nom du plan de restauration.

  5. Cliquez sur l'onglet Détails.

  6. Dans la section Configuration de restauration, cliquez sur le bouton Modifier situé à côté de Portée.

  7. Dans la section Définir des exceptions aux règles pour des types de volume spécifiques, cochez la case Disque persistant GCE.

  8. 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.

  9. 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.

    volumeDataRestorePolicyOverrides:
    - policy: REUSE_VOLUME_HANDLE_FROM_BACKUP
      selectedPvcs:
        namespacedNames:
        - namespace: ns-1
            name: test-pvc
        - namespace: ns-1
            name: test-pvc-2
    - policy: NO_VOLUME_DATA_RESTORATION
      selectedPvcs:
        namespacedNames:
        - namespace: ns-2
            name: test-pvc-3

gcloud

Créez une restauration comportant des exceptions :

gcloud beta container backup-restore restores create RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --backup=BACKUP \
    --volume-data-restore-policy-overrides-file=OVERRIDES_FILE

Remplacez les éléments suivants :

  • RESTORE : nom de la restauration que vous souhaitez créer.
  • PROJECT_ID : ID de votre projet Google Cloud
  • LOCATION : région de calcul du plan de restauration parent.
  • 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 comportant des exceptions dans la console Google Cloud :

  1. Dans Google Cloud Console, accédez à la page Google Kubernetes Engine.

    Accéder à Google Kubernetes Engine

  2. Dans le menu de navigation, cliquez sur Sauvegarde pour GKE.

  3. Cliquez sur l'onglet Sauvegardes.

  4. Dans la liste des sauvegardes, identifiez celle que vous souhaitez restaurer, puis cliquez sur Configurer une restauration.

  5. Choisissez un plan de restauration dans la liste des plans qui s'appliquent à cette sauvegarde.

  6. Dans la section Nommer la restauration, saisissez un nom et éventuellement une description pour la restauration.

  7. 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 :

    1. Dans Nom de la PVC, saisissez le nom de la PVC.
    2. Dans Espace de noms, saisissez l'espace de noms de la PVC.
    3. Dans la liste Règle de restauration de volume, choisissez comment restaurer les données de volume de cette PVC.

  8. Cliquez sur Restaurer.

Étapes suivantes