E-NO
DevOps 10 min de lecture

Volumes nommés Docker : commandes de base avec exemples pratiques

calendar_today Publié : 2026-11-21
update Dernière mise à jour : 2026-11-21
analytics Efficacité SEO : 100%
Illustration du guide technique pour « Volumes nommés Docker : commandes de base avec exemples pratiques ».

Introduction

Les volumes nommés Docker sont le moyen le plus sûr de conserver les données d'une application entre les redémarrages de conteneurs, les reconstructions et les changements d'hôte. Contrairement aux volumes anonymes ou aux écritures dans la couche du conteneur, un volume nommé possède une identité claire, un cycle de vie et un chemin de récupération.

Ce guide présente les commandes essentielles que tout développeur, ingénieur DevOps ou équipe de démarrage devrait connaître. Vous apprendrez à créer des volumes nommés, à les attacher à des conteneurs, à inspecter leur contenu, à les sauvegarder, à les restaurer et à résoudre les pannes courantes.

Chaque exemple utilise des commandes Docker et Docker Compose réelles avec une sortie attendue. L'objectif est la sécurité opérationnelle : observer avant de modifier, limiter le rayon d'impact, utiliser des valeurs fictives plutôt que des secrets, vérifier les résultats et documenter les chemins de récupération.

Inventaire des versions et de l'environnement

Avant d'exécuter toute commande de volume, confirmez votre version de Docker et le pilote de stockage. Le comportement des volumes nommés est cohérent entre les versions récentes de Docker, mais les options du pilote peuvent varier.

docker version --format '{{.Server.Version}}'
docker info --format '{{.Driver}}'

Sortie attendue sur un hôte Linux typique :

24.0.7
overlay2

Pour un inventaire rapide des conteneurs en cours d'exécution et de leurs montages :

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Mounts}}"

Si vous devez voir exactement quels volumes un conteneur utilise, exécutez :

docker inspect <nom-du-conteneur> --format '{{ json .Mounts }}'

Pour les projets Docker Compose, listez les volumes définis dans le projet :

docker compose config --volumes

Vérifiez toujours les prérequis avant d'apporter des modifications. Sous Linux, le démon Docker doit être en cours d'exécution et votre utilisateur doit avoir la permission d'accéder à la socket Docker. Sous Windows et macOS, Docker Desktop doit être démarré.

Création et listage des volumes nommés

Créez un volume nommé avec :

docker volume create app-data

Listez tous les volumes :

docker volume ls

Inspectez les détails d'un volume :

docker volume inspect app-data

La sortie attendue montre le point de montage et le pilote :

[
  {
    "CreatedAt": "2025-02-17T10:30:00Z",
    "Driver": "local",
    "Labels": {},
    "Mountpoint": "/var/lib/docker/volumes/app-data/_data",
    "Name": "app-data",
    "Options": {},
    "Scope": "local"
  }
]

Vous pouvez créer un volume avec des options de pilote personnalisées, comme une taille ou un type de montage spécifique. Pour le pilote local, les options sont rarement nécessaires. Pour les pilotes cloud ou NFS, consultez la documentation du pilote.

Pour supprimer un volume (seulement après qu'il ne soit plus utilisé) :

docker volume rm app-data

Pour supprimer tous les volumes inutilisés en toute sécurité :

docker volume prune

Exécutez toujours docker volume ls et inspectez quels conteneurs pourraient encore utiliser un volume avant de le supprimer.

Attacher des volumes nommés aux conteneurs

Attachez un volume nommé à un conteneur en utilisant l'indicateur --mount (recommandé) ou l'ancien raccourci -v.

Avec --mount :

docker run -d \
  --name my-app \
  --mount source=app-data,target=/var/lib/app \
  nginx:alpine

Avec -v :

docker run -d \
  --name my-app \
  -v app-data:/var/lib/app \
  nginx:alpine

Les volumes nommés sont automatiquement créés s'ils n'existent pas lors de l'utilisation de -v. Avec --mount, vous devez d'abord créer le volume ou utiliser --mount source=app-data,volume-opt=... pour le créer.

Vérifiez que le volume est correctement monté :

docker inspect my-app --format '{{ range .Mounts }}{{ .Name }} -> {{ .Destination }}{{ end }}'

Sortie attendue :

app-data -> /var/lib/app

Lecture et écriture de données dans les volumes nommés

Pour inspecter directement le contenu d'un volume nommé, vous pouvez démarrer un conteneur temporaire qui monte le volume et exécute un shell :

docker run --rm -it -v app-data:/data alpine sh

Dans le shell, explorez avec les commandes standard :

ls -la /data
cat /data/somefile.txt

Pour écrire un fichier dans le volume depuis l'hôte, utilisez un conteneur temporaire :

docker run --rm -v app-data:/data alpine sh -c "echo 'bonjour' > /data/bonjour.txt"

Vérifiez que le fichier est présent :

docker run --rm -v app-data:/data alpine cat /data/bonjour.txt

Ce modèle est utile pour initialiser des données, déboguer ou extraire des fichiers sans exposer le système de fichiers hôte.

Sauvegarde et restauration des volumes nommés

La sauvegarde d'un volume nommé consiste à lancer un conteneur temporaire qui monte le volume source et un montage bind vers un répertoire de sauvegarde sur l'hôte. Le conteneur archive les données du volume dans une archive tar.

Exemple de commande de sauvegarde pour le volume app-data :

docker run --rm \
  -v app-data:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/app-data-backup.tar.gz -C /data .

Restaurez à partir d'une archive de sauvegarde :

docker run --rm \
  -v app-data:/data \
  -v $(pwd):/backup \
  alpine sh -c "tar xzf /backup/app-data-backup.tar.gz -C /data"

Testez toujours la sauvegarde en restaurant vers un nouveau volume et en vérifiant l'intégrité des fichiers avant de vous y fier.

Utilisation des volumes nommés avec Docker Compose

Dans Docker Compose, les volumes nommés sont déclarés dans la section de niveau supérieur volumes et référencés dans les définitions de service.

Exemple de docker-compose.yml :

services:
  web:
    image: nginx:alpine
    volumes:
      - web-data:/usr/share/nginx/html
  db:
    image: postgres:16
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  web-data:
  db-data:

Compose crée automatiquement les volumes lors de l'exécution de docker compose up. Pour inspecter les volumes créés par Compose :

docker volume ls | grep monprojet_

Compose utilise le nom du projet comme préfixe pour éviter les conflits. Pour remplacer explicitement le nom du volume, utilisez la propriété name :

volumes:
  db-data:
    name: mesdonneesdb

Pour sauvegarder un volume géré par Compose, référencez le nom exact du volume indiqué par docker volume ls.

Pièges courants et comment les éviter

Écriture dans la couche du conteneur au lieu du volume

Problème : L'application écrit dans un chemin qui n'est pas un montage de volume, et les données sont perdues lorsque le conteneur est supprimé.

Pourquoi cela se produit : Chemin de montage du volume mal configuré, ou l'application utilise par défaut un répertoire différent.

Comment l'éviter : Exécutez toujours docker inspect pour confirmer les destinations de montage. Testez la persistance en arrêtant et en supprimant le conteneur, puis en le recréant et en vérifiant que les données sont toujours disponibles.

Suppression accidentelle d'un volume en cours d'utilisation

Problème : docker volume prune supprime un volume encore nécessaire à un conteneur arrêté.

Pourquoi cela se produit : Prune supprime uniquement les volumes non référencés par un conteneur, mais si un conteneur est arrêté (pas supprimé), il peut encore détenir une référence. Cependant, il existe des cas limites avec les anciennes versions de Docker.

Comment l'éviter : Exécutez docker ps -a et docker volume ls avant de supprimer. Préférez la suppression explicite des volumes connus.

Problèmes de permissions avec les montages bind vs volumes nommés

Problème : Les volumes nommés sont gérés par Docker et évitent les conflits de permissions de l'hôte, mais les montages bind peuvent exposer des incohérences UID/GID de l'hôte.

Pourquoi cela se produit : L'utilisateur du conteneur peut ne pas avoir d'accès en lecture/écriture au répertoire monté en bind sur l'hôte.

Comment l'éviter : Utilisez des volumes nommés pour la production, et si des montages bind sont nécessaires, ajustez les permissions avec chown ou exécutez le conteneur avec le bon utilisateur.

Oubli de sauvegarder avant la reconstruction du conteneur

Problème : Perte de données après la recréation d'un conteneur avec une nouvelle image ou configuration.

Pourquoi cela se produit : L'ancien conteneur peut être supprimé avant la sauvegarde du volume, ou le volume n'est pas réutilisé.

Comment l'éviter : Sauvegardez toujours le volume avant d'apporter des modifications destructives. Intégrez les commandes de sauvegarde dans votre flux de travail de déploiement.

Dépannage des montages de volume

Si un volume ne semble pas monté :

docker inspect <conteneur> --format '{{ json .Mounts }}'

Recherchez "Name":"app-data" et "Destination":"/var/lib/app". S'ils manquent, le conteneur a probablement été créé sans le montage ou avec une faute de frappe.

Si le volume est monté mais vide alors qu'il devrait contenir des données, vérifiez si l'application a écrit dans un chemin différent. Exécutez un conteneur shell temporaire et explorez :

docker run --rm -it -v app-data:/data alpine sh

Si des fichiers manquent après une reconstruction, confirmez que le nouveau conteneur utilise le même volume nommé et qu'aucun docker volume rm ou prune n'a eu lieu.

Considérations de performance et de pilote

Le pilote local par défaut stocke les volumes sur le système de fichiers de l'hôte. Pour la plupart des applications sur un seul hôte, cela est suffisant.

Si vous avez besoin de volumes partagés entre plusieurs hôtes, envisagez des pilotes comme NFS, CIFS ou des pilotes de fournisseurs cloud (par exemple, EFS, Azure File). Ceux-ci nécessitent une configuration supplémentaire et peuvent avoir des performances inférieures à celles des volumes locaux.

Surveillez l'utilisation des volumes avec :

docker system df -v

Cela montre l'utilisation de l'espace par volume, ce qui aide à identifier les volumes volumineux ou en croissance.

Meilleures pratiques de sécurité

  • Ne montez jamais la socket Docker dans un conteneur sauf en cas de nécessité absolue.
  • Évitez les conteneurs privilégiés qui peuvent accéder à tous les volumes de l'hôte.
  • Utilisez des montages en lecture seule pour les volumes contenant une configuration statique ou des données que le conteneur ne doit pas modifier :
docker run --rm -v app-data:/data:ro alpine ls -la /data
  • Stockez les secrets dans Docker secrets ou un gestionnaire de secrets dédié, pas dans les volumes. Si un volume contient des données sensibles, restreignez l'accès via les permissions du système de fichiers et les options du pilote de volume.

Liste de contrôle des opérations pour les volumes nommés

Cette liste de contrôle vous aide à vérifier systématiquement la santé du volume avant d'apporter des modifications. Chaque élément a une commande et un résultat attendu. Revisitez cette liste de contrôle trimestriellement ou avant tout déploiement majeur.

  1. Le volume existe-t-il ?
  • Commande : docker volume ls | grep app-data
  • Attendu : app-data apparaît dans la liste.
  • Responsable : Ingénieur DevOps (Priya Shah, responsable ingénierie)
  1. Le conteneur utilise-t-il le volume ?
  • Commande : docker inspect my-app --format '{{ .Mounts }}'
  • Attendu : La sortie inclut "Name":"app-data".
  • Responsable : Développeur d'application (Marcus Chen, développeur senior)
  1. Les données sont-elles accessibles dans le conteneur ?
  • Commande : docker exec my-app ls /var/lib/app
  • Attendu : Les fichiers de l'application sont listés.
  • Responsable : Développeur d'application
  1. La sauvegarde est-elle récente et restaurable ?
  • Commande : Exécutez le script de sauvegarde, puis restaurez vers un volume de test et comparez le nombre de fichiers.
  • Attendu : Aucune erreur et les comptes correspondent.
  • Responsable : Ingénieur DevOps
  1. L'utilisation du disque est-elle dans les limites ?
  • Commande : docker system df -v | grep app-data
  • Attendu : La taille est inférieure au seuil d'alerte (par exemple, 80 % du disque).
  • Responsable : Ingénieur DevOps
  1. Pas de volumes orphelins ?
  • Commande : docker volume ls -qf dangling=true
  • Attendu : Liste vide ou seulement les orphelins connus.
  • Responsable : Ingénieur DevOps

Fréquence de révision : mensuelle pour les systèmes de production, trimestrielle pour les environnements de développement.

Conclusion

Les volumes nommés Docker sont un outil fondamental pour les données persistantes dans les conteneurs. Maîtriser les commandes de base permet des sauvegardes sûres, un dépannage efficace et un comportement d'application fiable.

Commencez par une vérification à faible risque : créez un volume de test, montez-le sur un conteneur, écrivez des données, supprimez le conteneur et confirmez que les données survivent en attachant le volume à un nouveau conteneur. Cela valide votre compréhension et votre environnement.

Rappelez-vous les principes fondamentaux : observer avant de changer, limiter les modifications à un élément défini, vérifier les résultats et toujours définir un chemin de récupération. Avec ces pratiques, vous pouvez gérer en toute confiance les volumes nommés en développement et en production.

Recherches connexes

Score de qualité de l’article

Utilité pour le lecteur 100%
  • check_circle Guide prêt à lire
  • check_circle Exemples pratiques inclus
  • check_circle URL d’article optimisée pour le SEO