5.4. Instantanés de volumes CSI

1. Créer un fichier avec l'objet VolumeSnapshotClass décrit par le YAML suivant :

   volumesnapshotclass.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: csi-hostpath-snap
   driver: hostpath.csi.k8s.io 1
   deletionPolicy: Delete

   1

   Le nom du pilote CSI utilisé pour créer des instantanés de cet objet VolumeSnapshotClass. Ce nom doit être identique au champ Provisioner de la classe de stockage responsable du PVC qui fait l'objet d'un instantané.

   Note

   Selon le pilote que vous avez utilisé pour configurer le stockage persistant, des paramètres supplémentaires peuvent être nécessaires. Vous pouvez également utiliser un objet VolumeSnapshotClass existant.

2. Créez l'objet que vous avez sauvegardé à l'étape précédente en entrant la commande suivante :

   $ oc create -f volumesnapshotclass.yaml

3. Créer un objet VolumeSnapshot:

   volumesnapshot-dynamic.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     volumeSnapshotClassName: csi-hostpath-snap 1
     source:
       persistentVolumeClaimName: myclaim 2

   1

   La demande d'une classe particulière par l'instantané de volume. Si le paramètre volumeSnapshotClassName est absent et qu'il existe une classe d'instantané de volume par défaut, un instantané est créé avec le nom de la classe d'instantané de volume par défaut. Mais si le champ est absent et qu'il n'existe pas de classe d'instantané de volume par défaut, aucun instantané n'est créé.

   2

   Le nom de l'objet PersistentVolumeClaim lié à un volume persistant. Il définit ce dont vous voulez créer un instantané. Requis pour le provisionnement dynamique d'un instantané.

4. Créez l'objet que vous avez sauvegardé à l'étape précédente en entrant la commande suivante :

   $ oc create -f volumesnapshot-dynamic.yaml

1. Fournissez une valeur pour le paramètre volumeSnapshotContentName en tant que source de l'instantané, en plus de définir la classe d'instantané de volume comme indiqué ci-dessus.

   volumesnapshot-manual.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: snapshot-demo
   spec:
     source:
       volumeSnapshotContentName: mycontent 1

   1

   Le paramètre volumeSnapshotContentName est requis pour les instantanés préprovisionnés.

2. Créez l'objet que vous avez sauvegardé à l'étape précédente en entrant la commande suivante :

   $ oc create -f volumesnapshot-manual.yaml

1. Pour afficher les détails de l'instantané de volume qui a été créé, entrez la commande suivante :

   $ oc describe volumesnapshot mysnap

   L'exemple suivant affiche les détails de l'instantané du volume mysnap:

   volumesnapshot.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshot
   metadata:
     name: mysnap
   spec:
     source:
       persistentVolumeClaimName: myclaim
     volumeSnapshotClassName: csi-hostpath-snap
   status:
     boundVolumeSnapshotContentName: snapcontent-1af4989e-a365-4286-96f8-d5dcd65d78d6 1
     creationTime: "2020-01-29T12:24:30Z" 2
     readyToUse: true 3
     restoreSize: 500Mi

   1

   Le pointeur sur le contenu de stockage réel qui a été créé par le contrôleur.

   2

   L'heure à laquelle l'instantané a été créé. L'instantané contient le contenu du volume qui était disponible à l'heure indiquée.

   3

   Si la valeur est définie sur true, l'instantané peut être utilisé pour restaurer un nouveau PVC.
   Si la valeur est définie sur false, l'instantané a été créé. Toutefois, le back-end de stockage doit effectuer des tâches supplémentaires pour rendre l'instantané utilisable afin qu'il puisse être restauré en tant que nouveau volume. Par exemple, les données de l'Amazon Elastic Block Store peuvent être déplacées vers un autre emplacement moins coûteux, ce qui peut prendre plusieurs minutes.

2. Pour vérifier que l'instantané de volume a été créé, entrez la commande suivante :

   $ oc get volumesnapshotcontent

   Le pointeur vers le contenu réel est affiché. Si le champ boundVolumeSnapshotContentName est rempli, un objet VolumeSnapshotContent existe et l'instantané a été créé.

3. Pour vérifier que l'instantané est prêt, confirmez que l'objet VolumeSnapshot est readyToUse: true.

Procédure

1. Spécifiez la politique de suppression dont vous avez besoin dans l'objet VolumeSnapshotClass, comme indiqué dans l'exemple suivant :

   volumesnapshotclass.yaml

   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
     name: csi-hostpath-snap
   driver: hostpath.csi.k8s.io
   deletionPolicy: Delete 1

   1

   Lors de la suppression de l'instantané de volume, si la valeur Delete est définie, l'instantané sous-jacent est supprimé en même temps que l'objet VolumeSnapshotContent. Si la valeur Retain est définie, l'instantané sous-jacent et l'objet VolumeSnapshotContent sont conservés.
   Si la valeur Retain est définie et que l'objet VolumeSnapshot est supprimé sans supprimer l'objet VolumeSnapshotContent correspondant, le contenu est conservé. L'instantané lui-même est également conservé dans le back-end de stockage.

2. Supprimez l'instantané du volume en entrant la commande suivante :

   oc delete volumesnapshot <volumesnapshot_name>

   Exemple de sortie

   volumesnapshot.snapshot.storage.k8s.io "mysnapshot" deleted

3. Si la politique de suppression est définie sur Retain, supprimez le contenu de l'instantané du volume en entrant la commande suivante :

   oc delete volumesnapshotcontent <volumesnapshotcontent_name> $ oc delete volumesnapshotcontent <volumesnapshotcontent_name>

4. Facultatif : si l'objet VolumeSnapshot n'est pas supprimé avec succès, entrez la commande suivante pour supprimer tous les finaliseurs de la ressource restante afin que l'opération de suppression puisse se poursuivre :

   Important

   Ne supprimez les finaliseurs que si vous êtes certain qu'il n'existe aucune référence existante à l'objet VolumeSnapshot, que ce soit à partir de réclamations de volume persistantes ou de contenus d'instantanés de volume. Même avec l'option --force, l'opération de suppression ne supprime pas les objets instantanés tant que tous les finaliseurs n'ont pas été supprimés.

   $ oc patch -n $PROJECT volumesnapshot/$NAME --type=merge -p '{"metadata": {"finalizers":null}}'

   Exemple de sortie

   volumesnapshotclass.snapshot.storage.k8s.io "csi-ocs-rbd-snapclass" deleted

   Les finaliseurs sont supprimés et l'instantané du volume est supprimé.

Procédure

1. Spécifiez une source de données VolumeSnapshot sur un PVC comme indiqué ci-dessous :

   pvc-restore.yaml

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: myclaim-restore
   spec:
     storageClassName: csi-hostpath-sc
     dataSource:
       name: mysnap 1
       kind: VolumeSnapshot 2
       apiGroup: snapshot.storage.k8s.io 3
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 1Gi

   1

   Nom de l'objet VolumeSnapshot représentant l'instantané à utiliser comme source.

   2

   Doit être réglé sur la valeur VolumeSnapshot.

   3

   Doit être réglé sur la valeur snapshot.storage.k8s.io.

2. Créez un PVC en entrant la commande suivante :

   $ oc create -f pvc-restore.yaml

3. Vérifiez que le PVC restauré a été créé en entrant la commande suivante :

   $ oc get pvc

   Un nouveau PVC tel que myclaim-restore s'affiche.