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.
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.