Conserver les données avec un volume

Un conteneur se remplace : on le supprime, on en recrée un neuf, et c’est même la façon normale de le mettre à jour. Mais tout ce qu’il a écrit dans sa couche d’écriture part avec lui. Une base de données rangée là serait effacée à la première mise à jour.

La solution : ranger les données à côté du conteneur.

Volume nommé ou dossier monté ?

Docker propose deux façons de sortir les données du conteneur.

	Volume nommé	Dossier monté
S’écrit	-v owlnet-data:/data	-v "${PWD}:/data"
Qui le gère	Docker, dans son propre espace	Vous : c’est un dossier de votre ordinateur
Idéal pour	Les données d’une application ou d’une base	Des fichiers que vous éditez vous-même
À savoir	Monté vide sur un dossier rempli, il reçoit une copie du contenu de l’image	Il masque ce que l’image contenait à cet endroit

Retenez la dernière ligne : c’est l’origine de nombreuses surprises. Un dossier monté remplace le contenu d’origine par celui de votre dossier — s’il est vide, l’application trouve un dossier vide.

Exercice 1 : prouver la persistance

Créez un volume, puis faites écrire un fichier dedans par un conteneur jetable. alpine est un système minuscule, parfait pour ces petites tâches.

docker volume create owlnet-data
docker run --rm -v owlnet-data:/data alpine sh -c "echo 'Bonjour depuis le volume' > /data/message.txt"

Grâce à --rm, ce conteneur a déjà disparu. Un second, tout neuf, va relire le fichier :

docker run --rm -v owlnet-data:/data:ro alpine cat /data/message.txt

« Bonjour depuis le volume » s’affiche : le premier conteneur n’existe plus, le volume a gardé la donnée. Le :ro final monte le volume en lecture seule, car ce second conteneur n’a besoin que de lire.

Pour voir la fiche du volume :

docker volume inspect owlnet-data

Exercice 2 : un dossier modifié en direct

Reprenez le dossier mon-image de l’épisode 4, et montez-le dans un Nginx tout neuf, à la place de sa page d’accueil :

cd ~/docker-lab/mon-image
docker run -d --name owlnet-direct -p 127.0.0.1:8082:80 -v "${PWD}:/usr/share/nginx/html:ro" nginx:alpine

${PWD} désigne le dossier où vous vous trouvez : PowerShell comme le Terminal Ubuntu le comprennent. Ouvrez http://127.0.0.1:8082 : votre page s’affiche.

Maintenant, modifiez le titre dans index.html, enregistrez, et actualisez le navigateur. Le changement apparaît immédiatement, sans construire d’image. À l’épisode 4, la page était copiée dans l’image ; ici, le conteneur lit directement votre dossier.

Dernière expérience, plus inquiétante : ouvrez http://127.0.0.1:8082/Dockerfile. Le navigateur télécharge votre Dockerfile. Un dossier monté partage tout son contenu : ne montez jamais un dossier plus large que nécessaire, et encore moins votre dossier personnel entier.

Persistant ne veut pas dire sauvegardé

Un volume survit au conteneur. Il ne survit ni à une panne de disque, ni à une fausse manœuvre. La sauvegarde se fait avec… un conteneur, qui emballe le contenu du volume dans une archive, dans votre dossier docker-lab :

cd ~/docker-lab
docker run --rm -v owlnet-data:/data:ro -v "${PWD}:/sauvegarde" alpine tar czf /sauvegarde/owlnet-data.tar.gz -C /data .

Deux montages dans la même commande : le volume en lecture seule, et votre dossier comme destination. Une sauvegarde qui n’a jamais été restaurée n’est qu’un espoir : restaurez-la dans un nouveau volume, et relisez le message.

docker volume create owlnet-restaure
docker run --rm -v owlnet-restaure:/data -v "${PWD}:/sauvegarde:ro" alpine tar xzf /sauvegarde/owlnet-data.tar.gz -C /data
docker run --rm -v owlnet-restaure:/data:ro alpine cat /data/message.txt

Si « Bonjour depuis le volume » s’affiche, votre méthode de sauvegarde est prouvée. C’est la même, à l’identique, pour les données d’une vraie application : seul le nom du volume change.

Nettoyer

docker rm -f owlnet-direct
docker volume rm owlnet-data owlnet-restaure