HOWTO · Docker

Monter un répertoire hôte dans un conteneur Docker

Apprenez à monter un répertoire de l’hôte dans un conteneur Docker avec -v, --volume ou --mount.

Sur cette page

Un montage de liaison (bind mount) relie un répertoire de l’hôte à un chemin dans un conteneur Docker. Utilisez-le lorsqu’un conteneur doit lire ou modifier les fichiers d’un répertoire précis de l’hôte, par exemple le code source pendant le développement. L’exemple ci-dessous prépare un répertoire et un fichier sur l’hôte ; les commandes Docker montrent comment rendre ce répertoire accessible dans un shell Alpine. Les commandes Docker sont données à titre d’exemple et n’ont pas été exécutées pendant cette étape de rédaction.

Utiliser les montages de liaison pour monter le répertoire hôte dans un conteneur Docker

Un montage de liaison rend le chemin de l’hôte que vous avez choisi accessible à un chemin du conteneur. Contrairement à un volume géré par Docker, sa source correspond à un emplacement précis sur l’hôte. Les modifications apportées aux fichiers de ce répertoire sont visibles depuis le point de montage dans le conteneur. Une application peut voir ces modifications, mais son rechargement à chaud dépend de sa capacité à surveiller ou à recharger ses fichiers.

Monter un répertoire hôte avec -v ou --volume

Cet exemple Python crée sur l’hôte un répertoire nommé site, y écrit un fichier, puis affiche le nom de ce fichier. Exécutez-le depuis le répertoire à partir duquel vous lancerez Docker :

from pathlib import Path

site = Path("site")
site.mkdir(exist_ok=True)
(site / "hello.txt").write_text("Hello from the host.\n")
print("\n".join(sorted(path.name for path in site.iterdir())))
hello.txt

Le fichier créé sur l’hôte sera accessible dans /site avec un conteneur lancé par docker run --rm -it --volume "$PWD/site:/site" alpine:3.20 sh. La valeur du volume suit la forme chemin-hôte:chemin-conteneur[:options] : $PWD/site désigne le répertoire de l’hôte, /site est son emplacement dans le conteneur et le suffixe facultatif ro rend le montage accessible en lecture seule. Les options courtes -v et longues --volume utilisent la même syntaxe ; -v "$PWD/site:/site:ro" donne donc la variante en lecture seule.

Pendant que le shell du conteneur est ouvert, créez un nouveau fichier sur l’hôte avec touch "$PWD/site/from-host.txt". À l’invite du conteneur, lancez ls /site/from-host.txt pour vérifier que ce fichier est visible au point de montage. Lorsque le montage autorise l’écriture, les fichiers créés dans /site sont également enregistrés dans le répertoire de l’hôte. Avec un montage en lecture seule, le conteneur peut lire les fichiers, mais ne peut pas les modifier par ce montage.

Les formes -v et --volume créent sous forme de répertoire toute source absente sur l’hôte. Vérifiez le chemin ainsi obtenu avant d’utiliser le conteneur : une faute de frappe peut créer un nouveau répertoire vide et donner l’impression que les fichiers attendus ont disparu.

Monter un répertoire hôte avec --mount

Avec --mount, chaque réglage est indiqué dans un champ clé-valeur, et les champs sont séparés par des virgules. Pour reprendre le même exemple, lancez docker run --rm -it --mount "type=bind,source=$PWD/site,target=/site" alpine:3.20 sh. type=bind sélectionne un montage de liaison, source désigne le répertoire de l’hôte et target son chemin dans le conteneur. Ajoutez readonly aux champs du montage pour empêcher les écritures. L’ordre des champs ne détermine pas quel chemin est la source ou la destination : ce sont les clés qui l’indiquent.

Contrairement à -v et --volume, --mount renvoie une erreur si la source du montage de liaison n’existe pas. Créez le répertoire de l’hôte et vérifiez qu’il existe avant de démarrer le conteneur. Les chemins contenant des virgules demandent une attention particulière avec cette syntaxe ; choisissez un chemin adapté ou consultez la syntaxe des montages Docker pour votre plateforme.

Un montage de liaison donne au conteneur accès au chemin de l’hôte sélectionné. Ne montez que les répertoires nécessaires à la tâche, évitez d’exposer des fichiers sensibles et préférez un accès en lecture seule si le conteneur n’a pas besoin d’écrire. Le partage des chemins de l’hôte et les permissions peuvent aussi dépendre de la configuration de Docker sur votre système.

Conclusion

Utilisez -v ou --volume pour la forme compacte avec des chemins séparés par des deux-points, ou --mount pour des champs clé-valeur explicites. Les deux rendent un répertoire de l’hôte accessible à un chemin du conteneur ; -v peut créer une source absente, tandis que --mount exige que cette source existe. Choisissez un montage de liaison lorsque le conteneur doit accéder à un chemin précis de l’hôte. Un volume géré par Docker convient souvent mieux aux données d’application que Docker doit gérer indépendamment d’un répertoire particulier de l’hôte.