Gérer les Fichiers Volumineux avec Git et Git LFS

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

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.

Tu veux aller plus loin et maîtriser pleinement les fondamentaux de Git ou être accompagné pour garantir la qualité de tes projets grâce à une bonne mise en place de Git ? On peut t’aider ou te former, il suffit de nous décrire ton besoin !
Tu peux aussi regarder le programme de notre formation "Comprendre Git" ou nous poser tes questions sur notre forum discord.