Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Les fichiers volumineux

Les fichiers volumineux

Monorepo, sous-modules et gros dépôtsavance

Git conserve toutes les versions de tous les fichiers, pour toujours. Supprimer un gros fichier dans un commit ultérieur ne le retire pas du dépôt : il reste accessible depuis les commits où il existait.

git rm gros.zip
git commit -m "Retire l'archive"
# le clone pèse toujours autant

Pourquoi les binaires coûtent plus cher

La compression de Git stocke l'écart entre deux versions proches. Entre deux versions d'un fichier source, cet écart est minuscule. Entre deux exports d'une image, il n'y a presque rien de commun : chaque version pèse son poids entier.

La réponse : LFS

git lfs install
git lfs track "*.psd"
git add .gitattributes maquette.psd
git commit -m "Ajoute la maquette"

Le dépôt ne contient plus qu'un fichier pointeur :

version https://git-lfs.github.com/spec/v1
oid sha256:4d7a2…
size 104857600

Le contenu réel vit sur un serveur dédié et n'est téléchargé que pour les versions effectivement extraites. Le clone cesse de grossir avec l'historique des binaires.

Ce qui n'est jamais rattrapable facilement

Un binaire déjà dans l'historique n'en sort que par une réécriture complète avec git filter-repo. Toutes les empreintes changent, tous les clones existants deviennent incompatibles. On préfère donc l'éviter dès le départ, avec un .gitignore qui refuse les artefacts de construction.

Les termes à connaître

Objet immuable

Chaque version de chaque fichier est stockée comme un objet identifié par son empreinte. Supprimer un fichier dans un commit ultérieur n'enlève rien : l'objet reste accessible depuis les commits antérieurs.

Delta

La compression de Git stocke les différences entre versions proches d'un fichier. Elle fonctionne très bien sur du texte et presque pas sur un binaire, dont chaque version repart de zéro.

Git LFS

Extension qui remplace le contenu d'un gros fichier par un fichier pointeur de quelques lignes, et stocke le contenu réel sur un serveur dédié, téléchargé au besoin.

Fichier pointeur

Ce que LFS versionne à la place du binaire : un petit fichier texte contenant la version du format, l'empreinte du contenu et sa taille. C'est lui qui apparaît dans les différences.

.gitattributes

Fichier versionné qui déclare les chemins suivis par LFS (*.psd filter=lfs diff=lfs merge=lfs -text). Sans lui chez un collègue, ses ajouts repartent en binaires ordinaires.

filter-repo

Outil de réécriture massive de l'historique, le seul moyen de faire disparaître un gros fichier des commits passés. Réécrit toutes les empreintes concernées et casse tous les clones existants.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.