Docker prend trop de place sur Mac : pourquoi, et la solution

Où se trouve réellement l'espace de Docker

Docker Desktop exécute les conteneurs dans une petite machine virtuelle Linux. Le disque de cette machine est un seul fichier de votre Mac, situé à l'emplacement ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw.

Le fichier est creux (sparse). Le Finder peut l'afficher à sa taille maximale autorisée alors qu'il en utilise bien moins. La commande ci-dessous donne les deux chiffres : la première colonne indique l'espace réellement occupé sur votre disque, et la taille qui apparaît plus loin sur la ligne est le maximum.

C'est pourquoi il n'est pas possible de supprimer les fichiers d'un conteneur depuis macOS, et pourquoi le dossier apparaît comme un seul élément énorme dans n'importe quel outil d'analyse de disque.

ls -klsh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

Voir ce qui occupe l'espace

Docker Desktop étant lancé, demandez le détail à Docker. La commande ci-dessous liste quatre choses : les images, les conteneurs, les volumes locaux et le cache de build, avec la taille totale de chacun et la part qui peut être récupérée.

Ajoutez -v pour obtenir une ligne par image, conteneur et volume. Cela vaut la minute de lecture. Sur la plupart des machines de développement, les gros éléments sont les anciennes images et le cache de build, mais si ce sont les volumes qui sont volumineux, il s'agit de données, et cela demande plus de précautions.

docker system df

Étape 1 : l'élagage sans risque

Commencez par la commande ci-dessous. Elle supprime les conteneurs arrêtés, les réseaux qu'aucun conteneur n'utilise, les images orphelines, c'est-à-dire les couches qui ne portent plus de tag et auxquelles plus rien ne fait référence, et le cache de build inutilisé. Docker liste ce qu'il va supprimer et vous demande de confirmer.

Elle ne supprime ni les images qui portent un tag, ni les conteneurs en cours d'exécution, ni les volumes. Pour beaucoup de gens, cela suffit.

Rien de tout cela n'est difficile à récupérer. Un conteneur supprimé peut être recréé à partir de son image, et le cache de build ne vous coûte qu'un prochain build plus lent. La seule chose à vérifier est qu'un conteneur arrêté ne contient pas des fichiers que vous y avez écrits sans jamais les copier ailleurs.

docker system prune

Étape 2 : les images inutilisées et le cache de build

S'il vous faut plus d'espace, visez précisément les images et le cache de build.

• docker image prune -a supprime toutes les images qu'aucun conteneur n'utilise, qu'elles portent un tag ou non. Vous les récupérerez ou les reconstruirez la prochaine fois que vous en aurez besoin.
• docker builder prune supprime le cache de build. Ajoutez -a pour le supprimer en entier, et pas seulement la partie orpheline. Vos prochains builds partent de zéro et prennent plus de temps.
• docker system prune -a fait les deux opérations ci-dessus en plus du nettoyage de l'étape 1.
• docker container ls -a affiche les conteneurs arrêtés. L'un de ceux que vous voulez garder maintient peut-être une grosse image en cours d'utilisation.

Étape 3 : les volumes, avec précaution

Les volumes sont l'endroit où les conteneurs gardent les données qui doivent survivre : fichiers de bases de données, fichiers téléversés, caches de paquets. Les élaguer peut supprimer un vrai travail, alors regardez d'abord.

Listez-les avec la première commande ci-dessous et vérifiez à quels projets ils appartiennent. La deuxième commande supprime les volumes anonymes qu'aucun conteneur n'utilise. Ajouter -a étend l'opération aux volumes nommés qu'aucun conteneur n'utilise, et c'est là que se trouve en général une base de données de développement locale.

Si un volume compte, sauvegardez-le ou exportez la base de données avant d'élaguer. Les volumes d'un projet Compose peuvent être supprimés en même temps que ce projet avec docker compose down -v, exécuté dans le dossier du projet.

docker volume ls
docker volume prune

Récupérer l'espace sur votre Mac

Après l'élagage, Docker Desktop rend à macOS l'espace libéré dans le disque virtuel. Avec le format Docker.raw, cela se produit normalement en quelques instants, même si les outils qui affichent la taille maximale du fichier ne montrent aucun changement. Exécutez à nouveau la commande ls de la première section pour voir le chiffre réel.

Pour l'empêcher de grossir autant à l'avenir, ouvrez Docker Desktop, allez dans Settings, puis Resources, et abaissez la limite d'utilisation du disque. Docker vous avertit si la modification doit effacer des données existantes.

Si vous voulez repartir entièrement de zéro, l'écran Troubleshoot (dépannage) de Docker Desktop propose une option Clean / Purge data (nettoyer et purger les données) et une réinitialisation aux réglages d'usine. Les deux suppriment toutes les images, tous les conteneurs et tous les volumes.

Ce qui ne se trouve pas dans Docker.raw

Quelques éléments liés à Docker se trouvent hors du disque virtuel. Les dossiers que vous montez dans des conteneurs sont des dossiers ordinaires de votre Mac, et aucun élagage n'y touche. Les dossiers de projets contiennent leurs propres résultats de build, comme node_modules. Et si vous supprimez Docker Desktop, ses outils d'aide, ses conteneurs de groupe et le dossier ~/.docker restent en place, sauf si vous les supprimez aussi.

Le rôle de Diskzy

Diskzy indique la taille réelle de Docker.raw sur la carte du disque, pour que vous sachiez quand il est temps d'élaguer depuis Docker. Il ne réduit pas le fichier à votre place.

Si vous décidez de supprimer complètement Docker Desktop, l'onglet Uninstall (désinstallation) de Diskzy supprime l'app avec ce qu'elle a laissé, y compris les conteneurs, les agents de lancement et les outils d'aide privilégiés. Tout va dans la corbeille.