Mise en place des volumes persistants
Un conteneur sans volume perd tout au redémarrage. Création, montage, backup et nettoyage : la mise en place complète, sans les pièges classiques.
Un conteneur qui redémarre et repart avec une base vide, c'est le premier incident de toute stack Docker. Le coupable n'est presque jamais le conteneur : c'est l'absence de volume, ou un volume monté sur le mauvais chemin.
Voici la mise en place complète, du docker volume create jusqu'à la restauration d'une sauvegarde, avec les pièges qui coûtent vraiment des données.
Un conteneur sans volume est une base jetable
Tout ce qu'un conteneur écrit sans montage atterrit dans sa couche inscriptible, gérée par le storage driver. Détruis le conteneur, la couche part avec lui.
Le test prend dix secondes. Écris un fichier, sors, relance :
docker run --rm --name test alpine sh -c "echo bonjour > /data.txt && cat /data.txt"
# bonjour
# conteneur supprimé à la sortie, /data.txt n'existe plus nulle partUn volume vit en dehors du cycle de vie du conteneur. La doc Docker le dit sans détour : les volumes sont « le mécanisme privilégié pour persister les données générées et utilisées par les conteneurs » (docs.docker.com).
Deuxième effet, moins connu : écrire dans la couche inscriptible passe par une union filesystem, donc une couche d'abstraction en plus. Un volume écrit directement dans le filesystem de l'hôte, ce qui va plus vite pour tout ce qui ressemble à des I/O soutenues — base de données, index de recherche, uploads.
Volume nommé, bind mount, tmpfs : le tableau de décision
Trois mécanismes, trois usages. Se tromper ici coûte soit des performances, soit des données.
| Type | Où vivent les données | Bon usage | Sauvegarde |
|---|---|---|---|
| Volume nommé | /var/lib/docker/volumes/<nom>/_data, géré par Docker | Bases, données applicatives, prod | Simple (tar via conteneur jetable) |
| Bind mount | Un chemin de l'hôte que tu choisis | Code en dev, configs, accès direct depuis l'hôte | Rsync ou snapshot classique |
| tmpfs | RAM uniquement | Caches, sessions, fichiers temporaires | Aucune, par définition |
Règle simple : dès que tu n'as pas besoin de lire les fichiers depuis l'hôte, prends un volume nommé. Le bind mount garde un intérêt réel en développement — tu édites un fichier sur ta machine, le conteneur le voit immédiatement.
Pour du volume jetable en RAM, la syntaxe --mount est plus lisible que les options courtes :
docker run --rm --mount type=tmpfs,destination=/tmp/cache,tmpfs-size=64m nginxCréer et monter un volume nommé, pas à pas
La création explicite n'est pas obligatoire, mais elle rend le volume visible dans ton inventaire avant même le premier run.
docker volume create app-data
docker volume inspect app-dataLa sortie ressemble à ceci (Docker 29, driver local) :
[
{
"CreatedAt": "2026-11-03T06:12:41Z",
"Driver": "local",
"Labels": null,
"Mountpoint": "/var/lib/docker/volumes/app-data/_data",
"Name": "app-data",
"Options": null,
"Scope": "local"
}
]Le montage se fait avec -v nom:/chemin ou --mount type=volume,src=nom,dst=/chemin. Je préfère la seconde en production : elle échoue si la source n'existe pas, au lieu de créer silencieusement un volume ou un dossier.
docker run -d --name web \
--mount type=volume,src=app-data,dst=/usr/share/nginx/html \
nginx:alpine
docker exec web sh -c "echo '<h1>hello</h1>' > /usr/share/nginx/html/index.html"
docker rm -f web
docker run -d --name web2 --mount type=volume,src=app-data,dst=/usr/share/nginx/html nginx:alpine
curl -s localhost:80 | head -1
# <h1>hello</h1> → le fichier a survécu à la suppression du conteneurUn même volume peut être monté dans plusieurs conteneurs simultanément. C'est pratique pour un sidecar de sauvegarde, risqué pour deux writers concurrents sur du SQLite.
Le copy-on-first-use qui surprend tout le monde
Monte un volume nommé vide sur un répertoire déjà rempli dans l'image, et Docker copie le contenu de l'image dans le volume. C'est le copy-on-first-use.
Conséquence concrète : tu montes un volume vide sur /etc/nginx en pensant écraser la conf, et tu récupères la conf par défaut recopiée dedans. Puis tu modifies l'image, et le volume garde l'ancienne version.
Pour un volume de données applicatives, ce comportement est indésirable. On le désactive :
docker run -d --name api \
--mount type=volume,src=api-data,dst=/app/data,volume-nocopy \
monimage/api:1.4Avec volume-nocopy, le répertoire du conteneur reste vide tant que l'application ne l'a pas rempli. Plus de contenu fantôme qui survit à trois versions de l'image.
Postgres en Compose : le fichier qui survit à un redéploiement
Le cas réel, c'est Compose. Voici le service minimal avec un volume nommé et une sauvegarde planifiable.
services:
db:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_USER: app
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: app
volumes:
- pgdata:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d app"]
interval: 10s
volumes:
pgdata:
name: app_pgdataLe champ name: évite la surprise du préfixe de projet. Sans lui, Compose nomme le volume monprojet_pgdata — change le nom du dossier et tu repars sur un volume neuf, vide.
Deux commandes à ne jamais confondre dans le même terminal :
docker compose down # arrête et supprime les conteneurs, garde les volumes
docker compose down -v # supprime aussi les volumes déclarésLa seconde est légitime en test, catastrophique en prod. La référence CLI est explicite : -v détruit les volumes nommés et anonymes attachés aux services.
Si ton volume existe déjà hors de Compose, déclare-le externe pour empêcher toute création accidentelle :
volumes:
pgdata:
external: true
name: app_pgdataSauvegarder et restaurer un volume sans arrêter la prod
Le tar via conteneur jetable reste la méthode la plus portable. On monte le volume en lecture seule et on écrit l'archive sur l'hôte.
docker run --rm \
-v app_pgdata:/data:ro \
-v "$PWD":/backup \
alpine sh -c "tar czf /backup/pgdata-$(date +%F).tar.gz -C /data ."
# restauration
docker run --rm \
-v app_pgdata:/data \
-v "$PWD":/backup \
alpine sh -c "rm -rf /data/* && tar xzf /backup/pgdata-2026-11-03.tar.gz -C /data"Une nuance importante : un tar sur le répertoire de données Postgres pris à chaud peut produire une archive incohérente. Le fichier existe, il se restaure, et la base refuse de démarrer.
Pour une base relationnelle, sauvegarde logique d'abord :
docker exec -e PGPASSWORD="$DB_PASSWORD" db \
pg_dump -U app -Fc app > backup/app-$(date +%F).dumpLe tar complet garde son intérêt pour les volumes sans moteur transactionnel : uploads, index de recherche, fichiers statiques. Sur les stratégies de rotation et de vérification des archives, mon guide pratique des backups détaille la partie planification.
Un volume sur NFS, et pourquoi je l'évite pour SQLite
Le driver local accepte des options de montage. Ça permet de créer un volume qui pointe vers un export NFS :
docker volume create --driver local \
--opt type=nfs4 \
--opt o=addr=10.0.0.5,rw,nfsvers=4.1 \
--opt device=:/exports/pgdata \
pgdata-nfsLe conteneur ne voit aucune différence. Le stockage, lui, est distant — et c'est là que les problèmes arrivent.
Sur SQLite, un volume NFS est une mauvaise idée : le verrouillage applicatif est réputé peu fiable sur NFS, et une coupure réseau au mauvais moment suffit à corrompre le fichier. J'ai vu trop de blogs et de petites apps tourner sur SQLite pour considérer ce point comme théorique.
Sur Postgres, NFS fonctionne mais les I/O deviennent le facteur limitant, et fsync sur un montage réseau n'offre pas les mêmes garanties qu'un disque local. Pour de la donnée qui compte, garde les volumes sur le disque du VPS et réplique par sauvegarde.
Nettoyage : prune est un fusil chargé
Les volumes orphelins s'accumulent vite : chaque docker run -v /chemin sans nom crée un volume anonyme qui survit à la suppression du conteneur.
Pour les lister :
docker volume ls --filter dangling=truePour les supprimer, mets un label sur ce que tu veux protéger et filtre l'inverse. C'est la seule protection réelle contre un prune lancé à 2h du matin par un script de maintenance.
# marquer les volumes critiques au moment du create
docker volume create --label keep=1 app_pgdata
# ne supprimer que les volumes sans ce label
docker volume prune --filter "label!=keep"Depuis Docker 23, docker volume prune --all supprime tous les volumes non utilisés, anonymes compris. Sans --all, seuls les anonymes sont visés — vérifie la version de ton moteur avant de câbler ça dans un cron. La doc de prune liste aussi les filtres label, label! et until.
Les cinq erreurs qui coûtent des données
- Monter le volume sur le mauvais chemin. Postgres attend
/var/lib/postgresql/data. Un/var/lib/postgrescrée un volume vide, la base s'initialise ailleurs, et tu crois avoir persisté. Vérifie avecdocker inspect -f '{{json .Mounts}}' <conteneur>. - Utiliser
down -ven prod. Une faute de frappe, et le volume du projet disparaît avec les conteneurs. - Laisser le préfixe Compose décider. Renommer un dossier de projet change le nom du volume, donc le contenu visible.
- Monter le même volume en écriture dans deux conteneurs. Deux writers, un seul fichier de données : corruption garantie à la première écriture concurrente.
- Sauvegarder sans tester la restauration. Une archive de 400 Mo qui ne se restaure pas, c'est une fausse sécurité. Restaure dans un volume jetable une fois par trimestre.
Le point 5 mérite un script, pas une bonne intention : monte un volume restore-test, extrais l'archive, démarre le service dessus, vérifie une requête. Si ça échoue, tu l'apprends le mardi après-midi et pas le jour de l'incident.
Côté orchestration, la logique change à peine quand tu passes à Kubernetes : le PersistentVolumeClaim remplace le volume nommé, et la question du bon chemin de montage reste identique. J'ai détaillé les optimisations côté cluster dans cet article sur les volumes persistants Kubernetes.
FAQ volumes Docker
Où sont stockés mes volumes sur l'hôte ?
Par défaut dans /var/lib/docker/volumes/<nom>/_data, avec le driver local. docker volume inspect te donne le chemin exact, qui dépend de la racine de données configurée pour le démon.
Un volume survit-il à docker compose down ?
Oui, tant que tu n'ajoutes pas -v. Le down simple supprime les conteneurs et le réseau, pas les volumes nommés.
Puis-je copier un volume vers une autre machine ?
Oui : archive en tar, transfert, extraction dans un volume créé sur la cible. C'est justement l'un des arguments de la doc Docker en faveur des volumes face aux bind mounts.
Volume ou bind mount pour du développement ?
Bind mount pour le code que tu édites — le conteneur voit tes changements sans rebuild. Volume nommé pour les dépendances (node_modules, cache pip) : le bind mount écrase le contenu de l'image et les performances chutent sur macOS et Windows.
Comment supprimer un volume utilisé par un conteneur arrêté ?
Supprime le conteneur d'abord, sinon Docker refuse avec un volume is in use. docker ps -a révèle les conteneurs arrêtés qui retiennent le volume.