Gérer les Fichiers Volumineux avec Git et Git LFS

Par Maxime Bréhin • Publié le 28 octobre 2024 • 2 min

Lorsque vous travaillez sur un projet, il est courant de devoir gérer des fichiers volumineux tels que des images, des vidéos, ou des modèles 3D. Ces fichiers peuvent rapidement alourdir votre dépôt Git, ralentir les opérations et compliquer la gestion des versions. Pour cela, Git Large File Storage (LFS) est un outil précieux.

Cet article explique comment configurer et utiliser Git et Git LFS pour extraire des fichiers volumineux de votre projet.

Qu’est-ce que Git LFS ?

Git LFS est une extension de Git qui permet de gérer efficacement les fichiers volumineux. Au lieu de stocker le contenu de ces fichiers dans le dépôt Git, Git LFS ne stocke qu’un pointeur vers l’emplacement réel des fichiers, qui sont stockés sur un serveur externe. Cela permet de réduire la taille du dépôt et d’accélérer les opérations de clonage et de téléchargement.

Étapes pour Utiliser Git et Git LFS

1. Installation de Git LFS

Pour commencer à utiliser Git LFS, vous devez l’installer sur votre machine. Suivez ces étapes :

Windows : Téléchargez le programme d’installation depuis git-lfs.github.com.

macOS : Utilisez Homebrew :

brew install git-lfs

Linux : Installez via votre gestionnaire de paquets. Par exemple, sur Ubuntu :

sudo apt-get install git-lfs

Après l’installation, initialisez Git LFS dans votre dépôt :

git lfs install

2. Configurer les Attributs Git pour LFS

Vous devez spécifier quels types de fichiers seront gérés par Git LFS. Cela se fait en ajoutant des règles aux attributs Git.

• Ouvrez (ou créez) le fichier .gitattributes à la racine de votre dépôt.
• Ajoutez des lignes pour indiquer quels fichiers doivent être gérés par LFS. Par exemple, pour gérer tous les fichiers PNG et MP4 :

*.png filter=lfs diff=lfs merge=lfs -text
*.mp4 filter=lfs diff=lfs merge=lfs -text

Ces lignes indiquent à Git d’utiliser LFS pour les fichiers ayant ces extensions.

Alternativement, vous pouvez ajouter les règles sans ouvrir le fichier des attributs en utilisant la commande :

git lfs track "*.png"

3. Ajouter des Fichiers Volumineux

Une fois que vous avez configuré les attributs, vous pouvez ajouter des fichiers volumineux comme vous le feriez normalement avec Git.

git add chemin/vers/fichier.png
git add chemin/vers/fichier.mp4

Lorsque vous ajoutez un fichier géré par LFS, Git remplace le fichier par un pointeur, tandis que le fichier réel est téléchargé sur le serveur LFS.

4. Valider et Pousser les Changements

Après avoir ajouté les fichiers, validez vos changements :

git commit -m "Ajout de fichiers volumineux avec LFS"

Puis poussez les changements vers le dépôt distant :

git push origin branche

Les fichiers volumineux seront téléchargés vers le serveur LFS pendant cette opération.

5. Cloner un Dépôt avec LFS

Lorsque vous clonez un dépôt utilisant Git LFS, assurez-vous d’avoir Git LFS installé. Lorsque vous clonez, les fichiers LFS seront automatiquement téléchargés :

git clone url_du_depot

Conclusion

Utiliser Git et Git LFS pour gérer des fichiers volumineux est une excellente solution pour maintenir la performance de votre dépôt. En suivant ces étapes, vous pouvez extraire et gérer efficacement les fichiers volumineux, tout en profitant de toutes les fonctionnalités de Git.

N’hésitez pas à consulter la documentation officielle de Git LFS pour plus d’informations et de conseils.

J’espère que cet article vous sera utile pour mieux gérer les fichiers volumineux dans vos projets ! Si vous avez des questions ou des besoins spécifiques, n’hésitez pas à demander.