Partagez des données entre votre container Docker en cours d'exécution et votre ordinateur

Si vous n'avez pas encore Docker, consultez d'abord mon article Installer Docker et jouer avec PHP.

Quand vous lancez Docker sans spécifier de volume, tout ce qui se passe pendant l'exécution se passe en mémoire. Autrement dit : si le script PHP que vous exécutez depuis Docker crée des dossiers ou des fichiers, ils ne seront pas créés sur votre disque. Ils seront créés exclusivement en mémoire.

Ce que -v fait pour vous​

Démarrez un container PHP + Apache en partageant votre dossier courant avec le dossier servi par Apache :

$ docker run --detach --name step_1_2 -p 81:80 -v $(pwd):/var/www/html php:8.3-apache▋

Créez maintenant un fichier index.php dans ce dossier. Sur votre disque, dans votre éditeur, pas dans le container :

<?php

echo "<h1>Hello world! I'm a shared script</h1>";?

Rendez-vous sur http://127.0.0.1:81/ et le container le sert déjà :

Pas de copie, pas de rebuild, pas de docker cp. Vous avez enregistré un fichier et le container l'a vu.

Pourquoi ça marche​

• Sans -v, tout ce que le container écrit ne vit qu'en mémoire : supprimez le container et c'est perdu. C'est le comportement par défaut, et c'est une fonctionnalité (voir Sous le capot plus bas).
• Avec -v, le partage est bi-directionnel : votre éditeur écrit un fichier, le container le voit ; le script PHP écrit un fichier dans /var/www/html, il apparaît sur votre disque.
• Le flag -u décide à qui appartiennent les fichiers que le container crée sur votre disque. Oubliez-le et vous récupérerez des fichiers appartenant à root dans votre propre projet.

À vous de jouer​

Pour cet article, créons un dossier temporaire dans votre dossier /tmp : démarrez une console Linux et exécutez mkdir /tmp/docker-volume && cd /tmp/docker-volume, puis lancez la commande docker run montrée plus haut.

Explication des arguments utilisés dans cette commande :

• --name step_1_2 : pour plus de clarté, nous utilisons un autre nom,
• -p 81:80 : cette fois, nous utilisons le port 81 sur notre ordinateur et nous le mappons sur le port 80 du container,
• -v $(pwd):/var/www/html : l'instruction -v sert à définir un volume. Ici, nous synchronisons le dossier /var/www/html du container avec $(pwd) (ou ${PWD} en notation Linux), qui correspond au dossier courant sur notre ordinateur.

Pour créer le fichier index.php, si vous avez Visual Studio Code sur votre machine, exécutez ceci dans la console Linux : cd /tmp/docker-volume && code index.php. Cela démarre VSCode et vous pourrez créer le script.

Le même container, avant que le fichier existe​

Si vous vous rendez sur http://127.0.0.1:81/ avant de créer index.php, vous obtenez plutôt ceci :

Comme vous le savez probablement, Apache affiche par défaut le contenu du dossier /var/www/html. Et, à ce moment-là, nous n'avons pas de fichier index.php dans notre container, donc nous obtenons la page Forbidden. Même container, même commande ; la seule chose qui a changé entre cette capture et la précédente, c'est un fichier que vous avez enregistré sur votre propre disque.

Ce que nous avons utilisé ici est un bind mount : un de vos dossiers, monté dans le container. Docker propose aussi des volumes gérés, qu'il stocke lui-même quelque part en dehors de votre projet ; Utiliser les volumes avec Docker, cas d'usage compare les deux et explique quand préférer l'un à l'autre.

Sous le capot (passez cette section si vous voulez juste l'utiliser)​

Passons maintenant à la question de la propriété des fichiers :

Pour être sûr que les fichiers/dossiers créés dans le container vous appartiennent et n'appartiennent pas à root, modifiez la ligne de commande comme ceci :

$ docker run --detach --name step_1_2 -p 81:80 -v $(pwd):/var/www/html -u ${UID}:${GID} php:8.3-apache▋

Le nouveau flag -u ${UID}:${GID} réutilise votre id utilisateur et votre id de groupe courants et transmet cette information à Docker. Désormais, l'utilisateur courant dans le container Docker ne sera plus root mais un utilisateur avec vos uid/gid locaux. Les fichiers/dossiers créés dans le container Docker vous appartiendront donc, sur votre disque.

Conclusion​

Un seul flag, -v host_folder:container_folder, et votre éditeur devient l'éditeur du container. Les deux choses à retenir dans trois mois : la synchronisation va dans les deux sens, et -u ${UID}:${GID} est ce qui empêche root de s'approprier vos fichiers.

Un bind mount n'est qu'un des deux types de volume proposés par Docker. Quand les données appartiennent au container plutôt qu'à vous (une base de données, un cache), un volume géré est le bon outil : Utiliser les volumes avec Docker, cas d'usage passe en revue les trois stratégies.