Lab 03 : Gestion des volumes dans OKS
Objectifs
Section intitulée « Objectifs »À l’issue de ce lab, vous serez capable de :
- identifier les StorageClasses fournies par OKS et leur politique de rétention (
RetainouDelete) ; - créer un PersistentVolumeClaim (PVC) qui provisionne dynamiquement un volume BSU (Block Storage Unit) ;
- monter ce volume dans un Pod et vérifier la persistance des données ;
- créer un VolumeSnapshot, qui crée un snapshot OUTSCALE du volume ;
- restaurer les données dans un nouveau volume à partir du snapshot.
Architecture du lab
Section intitulée « Architecture du lab »Dans ce lab, vous travaillez dans le cluster oks-lab01-cluster créé au Lab 01, dans le namespace oks-lab03.
Le cluster OKS intègre le pilote CSI (Container Storage Interface) d’OUTSCALE, bsu.csi.outscale.com. Quand un Pod utilise un PVC, ce pilote crée un volume BSU, dans la Sous-région du nœud, puis l’attache au nœud qui exécute le Pod. Dans Kubernetes, ce volume est représenté par un PersistentVolume (PV).
Vous créez ensuite un VolumeSnapshot du PVC : le pilote CSI crée un snapshot OUTSCALE du volume BSU. Vous supprimez le Pod et le PVC d’origine, puis vous créez un nouveau PVC à partir du snapshot : un nouveau volume BSU est créé avec les données sauvegardées.
Prérequis
Section intitulée « Prérequis »Avant de commencer, vous devez disposer :
- du cluster
oks-lab01-clusterà l’étatready, avec ses NodePools, créé dans le Lab 01 ; - du fichier
oks-lab01-kubeconfig.yamlrécupéré dans le Lab 01 ; - de kubectl et octl installés et configurés (Lab 01) ;
- de connaissances de base sur les objets Kubernetes Pod et namespace.
Le lab utilise la région eu-west-2.
1. Préparer l’environnement
Section intitulée « 1. Préparer l’environnement »1.1 Accéder au cluster
Section intitulée « 1.1 Accéder au cluster »-
Placez-vous dans le répertoire qui contient le fichier
oks-lab01-kubeconfig.yaml, puis indiquez à kubectl de l’utiliser :Terminal window export KUBECONFIG=$PWD/oks-lab01-kubeconfig.yamlRemarque : si vous avez supprimé ce fichier, récupérez-le de nouveau :
Terminal window (umask 077; octl kube cluster kubeconfig oks-lab01-cluster --project oks-lab01-project > oks-lab01-kubeconfig.yaml) -
Vérifiez l’accès au cluster :
Terminal window kubectl get nodes
1.2 Créer le namespace du lab
Section intitulée « 1.2 Créer le namespace du lab »kubectl create namespace oks-lab032. Identifier les StorageClasses
Section intitulée « 2. Identifier les StorageClasses »Une StorageClass décrit un type de stockage que Kubernetes peut provisionner à la demande : le pilote utilisé, le type de volume BSU et le comportement à la suppression.
-
Listez les StorageClasses du cluster :
Terminal window kubectl get storageclassExemple de sortie :
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGEbsu-gp2 (default) bsu.csi.outscale.com Retain WaitForFirstConsumer true 30dbsu-gp2-del bsu.csi.outscale.com Delete WaitForFirstConsumer true 30dbsu-io1-50 bsu.csi.outscale.com Retain WaitForFirstConsumer true 30dbsu-io1-50-del bsu.csi.outscale.com Delete WaitForFirstConsumer true 30dbsu-standard bsu.csi.outscale.com Retain WaitForFirstConsumer true 30dbsu-standard-del bsu.csi.outscale.com Delete WaitForFirstConsumer true 30d -
Analysez les colonnes :
- Le nom reprend le type de volume BSU :
standard(magnétique),gp2(SSD usage général) ouio1(SSD à IOPS provisionnées, ici 50 IOPS par Gio). (default): la StorageClassbsu-gp2est utilisée par tout PVC qui n’indique pas de StorageClass.RECLAIMPOLICY: avecRetain, le volume BSU est conservé quand le PVC est supprimé ; avecDelete(suffixe-del), il est supprimé.VOLUMEBINDINGMODE: avecWaitForFirstConsumer, le volume BSU n’est créé qu’au démarrage du premier Pod qui utilise le PVC, dans la Sous-région de son nœud.
- Le nom reprend le type de volume BSU :
Attention : un volume BSU conservé par la politique
Retainn’est pas supprimé avec le PVC : il reste lié à un PV à l’étatReleased, et continue de consommer du stockage. Dans ce lab, vous utilisez la StorageClassbsu-standard-delpour que les volumes soient supprimés avec leur PVC.
3. Provisionner un volume avec un PVC
Section intitulée « 3. Provisionner un volume avec un PVC »3.1 Créer le PVC
Section intitulée « 3.1 Créer le PVC »-
Créez un fichier
oks-lab03-pvc.yamlavec le contenu suivant :apiVersion: v1kind: PersistentVolumeClaimmetadata:name: oks-lab03-pvcnamespace: oks-lab03spec:accessModes:- ReadWriteOncestorageClassName: bsu-standard-delresources:requests:storage: 5GiReadWriteOnce(RWO) : le volume ne peut être monté en lecture-écriture que par un seul nœud à la fois. C’est le cas de tout volume BSU, qui ne peut être attaché qu’à une seule VM.storage: 5Gi: taille du volume BSU demandé.
-
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab03-pvc.yaml -
Affichez le PVC :
Terminal window kubectl get pvc -n oks-lab03Exemple de sortie :
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGEoks-lab03-pvc Pending bsu-standard-del <unset> 10sLe PVC est à l’état
Pending: c’est normal. Avec le modeWaitForFirstConsumer, le volume BSU n’est créé que lorsqu’un Pod utilise le PVC.
3.2 Utiliser le PVC dans un Pod
Section intitulée « 3.2 Utiliser le PVC dans un Pod »-
Créez un fichier
oks-lab03-app.yamlavec le contenu suivant :apiVersion: v1kind: Podmetadata:name: oks-lab03-appnamespace: oks-lab03spec:containers:- name: appimage: busybox:1.36command: ["/bin/sh", "-c"]args: ["while true; do date -u >> /data/out.txt; sleep 5; done"]volumeMounts:- name: datamountPath: /datavolumes:- name: datapersistentVolumeClaim:claimName: oks-lab03-pvcLe Pod ajoute la date et l’heure toutes les 5 secondes dans le fichier
/data/out.txt, stocké sur le volume BSU. -
Appliquez le manifeste, puis attendez que le PVC soit lié à un volume :
Terminal window kubectl apply -f oks-lab03-app.yamlkubectl wait pvc/oks-lab03-pvc -n oks-lab03 \--for=jsonpath='{.status.phase}'=Bound --timeout=3m -
Affichez le PVC et le PV créé :
Terminal window kubectl get pvc -n oks-lab03kubectl get pvExemple de sortie :
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGEoks-lab03-pvc Bound pvc-3f1c9a52-6b1e-4d7f-9c2a-1e8d4b7a6c10 5Gi RWO bsu-standard-del 1mLe PVC est à l’état
Bound: il est lié au PVpvc-3f1c..., qui représente le volume BSU créé par le pilote CSI. -
Affichez l’identifiant du volume BSU qui correspond au PV :
Terminal window kubectl get pv -o custom-columns=PV:.metadata.name,VOLUME_BSU:.spec.csi.volumeHandle,CLAIM:.spec.claimRef.nameLa colonne
VOLUME_BSUaffiche l’identifiant du volume BSU créé par le pilote CSI (il commence parvol-).Remarque : les volumes BSU des clusters OKS sont gérés par OKS : ils n’apparaissent pas dans la liste des volumes de votre compte (
octl iaas volume list).
3.3 Vérifier l’écriture des données
Section intitulée « 3.3 Vérifier l’écriture des données »-
Vérifiez que le Pod est à l’état
Running:Terminal window kubectl get pods -n oks-lab03 -
Affichez le contenu du fichier écrit sur le volume :
Terminal window kubectl exec -n oks-lab03 oks-lab03-app -- cat /data/out.txtExemple de sortie :
Tue Oct 27 14:37:04 UTC 2026Tue Oct 27 14:37:09 UTC 2026Tue Oct 27 14:37:14 UTC 2026Une nouvelle ligne est ajoutée toutes les 5 secondes. Notez l’heure de la première ligne : vous la comparerez après la restauration.
4. Sauvegarder le volume avec un VolumeSnapshot
Section intitulée « 4. Sauvegarder le volume avec un VolumeSnapshot »4.1 Vérifier la prise en charge des snapshots
Section intitulée « 4.1 Vérifier la prise en charge des snapshots »Les snapshots de volumes reposent sur trois CRDs (VolumeSnapshotClass, VolumeSnapshot, VolumeSnapshotContent) et sur un contrôleur de snapshots. OKS installe les CRDs dans le cluster et exécute le contrôleur de snapshots avec le control plane : il n’apparaît pas parmi les Pods du cluster.
-
Vérifiez la présence des CRDs :
Terminal window kubectl api-resources --api-group=snapshot.storage.k8s.ioLes trois ressources
volumesnapshotclasses,volumesnapshotcontentsetvolumesnapshotss’affichent.
Attention : n’installez pas vous-même le contrôleur de snapshots du projet
external-snapshotter: il entrerait en concurrence avec celui géré par OKS.
4.2 Créer la VolumeSnapshotClass
Section intitulée « 4.2 Créer la VolumeSnapshotClass »Une VolumeSnapshotClass est aux snapshots ce qu’une StorageClass est aux volumes : elle indique le pilote qui crée les snapshots et le comportement à la suppression.
-
Créez un fichier
oks-lab03-snapshotclass.yamlavec le contenu suivant :apiVersion: snapshot.storage.k8s.io/v1kind: VolumeSnapshotClassmetadata:name: oks-lab03-vscdriver: bsu.csi.outscale.comdeletionPolicy: Deletedriver: le même pilote CSI que les StorageClasses BSU.deletionPolicy: Delete: le snapshot OUTSCALE est supprimé quand le VolumeSnapshot est supprimé.
-
Appliquez le manifeste :
Terminal window kubectl apply -f oks-lab03-snapshotclass.yaml
4.3 Créer le VolumeSnapshot
Section intitulée « 4.3 Créer le VolumeSnapshot »-
Créez un fichier
oks-lab03-snapshot.yamlavec le contenu suivant :apiVersion: snapshot.storage.k8s.io/v1kind: VolumeSnapshotmetadata:name: oks-lab03-snapshotnamespace: oks-lab03spec:volumeSnapshotClassName: oks-lab03-vscsource:persistentVolumeClaimName: oks-lab03-pvc -
Appliquez le manifeste, puis attendez que le snapshot soit prêt à l’emploi :
Terminal window kubectl apply -f oks-lab03-snapshot.yamlkubectl wait volumesnapshot/oks-lab03-snapshot -n oks-lab03 \--for=jsonpath='{.status.readyToUse}'=true --timeout=5m -
Affichez le VolumeSnapshot :
Terminal window kubectl get volumesnapshot -n oks-lab03La colonne
READYTOUSEaffichetrue. -
Affichez l’identifiant du snapshot BSU créé par le pilote CSI :
Terminal window kubectl get volumesnapshotcontent \-o custom-columns=CONTENT:.metadata.name,SNAPSHOT_BSU:.status.snapshotHandle,READY:.status.readyToUseLa colonne
SNAPSHOT_BSUaffiche l’identifiant du snapshot (il commence parsnap-). Le VolumeSnapshotContent est l’objet Kubernetes qui représente ce snapshot.
5. Restaurer les données depuis le snapshot
Section intitulée « 5. Restaurer les données depuis le snapshot »5.1 Supprimer l’application d’origine
Section intitulée « 5.1 Supprimer l’application d’origine »Pour démontrer que le snapshot est indépendant du volume d’origine, supprimez le Pod et le PVC :
kubectl delete pod oks-lab03-app -n oks-lab03kubectl delete pvc oks-lab03-pvc -n oks-lab03Avec la StorageClass bsu-standard-del, le volume BSU d’origine est supprimé. Lancez kubectl get pv : le PV passe d’abord à l’état Released, puis disparaît au bout de quelques secondes, une fois le volume BSU supprimé. Le snapshot, lui, est toujours présent dans kubectl get volumesnapshotcontent.
5.2 Créer un PVC et un Pod à partir du snapshot
Section intitulée « 5.2 Créer un PVC et un Pod à partir du snapshot »-
Créez un fichier
oks-lab03-restore.yamlavec le contenu suivant :apiVersion: v1kind: PersistentVolumeClaimmetadata:name: oks-lab03-pvc-restorednamespace: oks-lab03spec:accessModes:- ReadWriteOncestorageClassName: bsu-standard-delresources:requests:storage: 5GidataSource:name: oks-lab03-snapshotkind: VolumeSnapshotapiGroup: snapshot.storage.k8s.io---apiVersion: v1kind: Podmetadata:name: oks-lab03-app-restorednamespace: oks-lab03spec:containers:- name: appimage: busybox:1.36command: ["/bin/sh", "-c"]args: ["while true; do date -u >> /data/out.txt; sleep 5; done"]volumeMounts:- name: datamountPath: /datavolumes:- name: datapersistentVolumeClaim:claimName: oks-lab03-pvc-restoredLe champ
dataSourceindique que le nouveau volume BSU doit être créé à partir du snapshotoks-lab03-snapshot, et non vide. Sa taille doit être supérieure ou égale à celle du volume d’origine. -
Appliquez le manifeste, puis attendez que le Pod soit prêt :
Terminal window kubectl apply -f oks-lab03-restore.yamlkubectl wait pod/oks-lab03-app-restored -n oks-lab03 \--for=condition=Ready --timeout=5m
5.3 Vérifier les données restaurées
Section intitulée « 5.3 Vérifier les données restaurées »-
Affichez le début du fichier restauré :
Terminal window kubectl exec -n oks-lab03 oks-lab03-app-restored -- head -n 3 /data/out.txtLa première ligne est identique à celle relevée à l’étape 3.3 : les données écrites avant le snapshot ont été restaurées.
-
Affichez la fin du fichier :
Terminal window kubectl exec -n oks-lab03 oks-lab03-app-restored -- tail -n 3 /data/out.txtLes dernières lignes ont été ajoutées par le nouveau Pod, après la restauration. Entre les deux, il manque les lignes écrites entre la création du snapshot et la suppression du Pod d’origine : un snapshot fige les données à l’instant de sa création.
Validation du lab
Section intitulée « Validation du lab »Pour valider votre lab, vérifiez les points suivants :
kubectl get storageclassaffiche les StorageClasses BSU, dontbsu-standard-delavec la politiqueDelete.kubectl get volumesnapshot -n oks-lab03afficheoks-lab03-snapshotavecREADYTOUSEàtrue.kubectl get volumesnapshotcontentaffiche un identifiant de snapshot BSU (snap-...).kubectl get pvc -n oks-lab03afficheoks-lab03-pvc-restoredà l’étatBound.- La première ligne de
/data/out.txtdans le Podoks-lab03-app-restoredest celle relevée à l’étape 3.3.
Challenge
Section intitulée « Challenge »- Augmentez la taille du PVC
oks-lab03-pvc-restoredde 5 Gio à 8 Gio, sans recréer le Pod, puis vérifiez la nouvelle taille du système de fichiers dans le Pod. - Faites de
bsu-gp2-della StorageClass par défaut du cluster, vérifiez le résultat, puis rétablissezbsu-gp2comme StorageClass par défaut.
Question : Pourquoi un PVC en
ReadWriteMany(RWX), monté par plusieurs nœuds à la fois, ne peut-il pas utiliser une StorageClass BSU ?
💡 Correction — Agrandissement du volume
Les StorageClasses BSU autorisent l’agrandissement (ALLOWVOLUMEEXPANSION à true).
kubectl patch pvc oks-lab03-pvc-restored -n oks-lab03 \ -p '{"spec":{"resources":{"requests":{"storage":"8Gi"}}}}'kubectl get pvc oks-lab03-pvc-restored -n oks-lab03 -wQuand la colonne CAPACITY affiche 8Gi, vérifiez la taille dans le Pod :
kubectl exec -n oks-lab03 oks-lab03-app-restored -- df -h /dataLe volume BSU a été agrandi, puis le système de fichiers étendu, sans arrêter le Pod. La taille d’un volume BSU ne peut qu’augmenter.
💡 Correction — Changement de StorageClass par défaut
Une seule StorageClass doit porter l’annotation is-default-class. Retirez-la d’abord de bsu-gp2, puis ajoutez-la à bsu-gp2-del :
kubectl patch storageclass bsu-gp2 \ -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'kubectl patch storageclass bsu-gp2-del \ -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'kubectl get storageclassRétablissez ensuite la configuration d’origine, car le cluster est partagé par les labs suivants :
kubectl patch storageclass bsu-gp2-del \ -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'kubectl patch storageclass bsu-gp2 \ -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'💡 Correction — Question du challenge
Un volume BSU est un volume en mode bloc qui ne peut être attaché qu’à une seule VM à la fois. Les StorageClasses BSU ne proposent donc que le mode ReadWriteOnce. Pour un stockage partagé en ReadWriteMany, il faut une solution de stockage distribué, comme Longhorn (Lab Avancé 02).
Nettoyage du lab
Section intitulée « Nettoyage du lab »Attention : avant de supprimer une ressource, vérifiez qu’elle n’est pas utilisée par d’autres labs.
Ressources à conserver pour les labs suivants
Section intitulée « Ressources à conserver pour les labs suivants »Si vous prévoyez de continuer avec le Lab 04, ne supprimez pas les ressources du Lab 01 :
- le cluster OKS
oks-lab01-clusteret ses NodePools ; - le fichier kubeconfig
oks-lab01-kubeconfig.yaml.
Ressources à supprimer
Section intitulée « Ressources à supprimer »Supprimez les ressources suivantes, qui ne seront pas réutilisées :
-
Supprimer le VolumeSnapshot. Avec la politique
Delete, le snapshot OUTSCALE est supprimé :Terminal window kubectl delete volumesnapshot oks-lab03-snapshot -n oks-lab03 -
Supprimer le namespace, avec le Pod et le PVC restaurés. Avec la StorageClass
bsu-standard-del, le volume BSU est supprimé :Terminal window kubectl delete namespace oks-lab03 -
Supprimer la VolumeSnapshotClass :
Terminal window kubectl delete volumesnapshotclass oks-lab03-vsc -
Vérifiez qu’il ne reste ni PV ni snapshot du lab :
Terminal window kubectl get pvkubectl get volumesnapshotcontentLes deux commandes affichent
No resources found.