Je travaillais donc récemment sur un projet dans lequel je devais travailler avec des ressources haute résolution et, par conséquent, elles étaient de grande taille. Je n'ai pas pu transférer les fichiers vers mon référentiel. Chaque fois que j'ai essayé, j'ai reçu l'erreur suivante :

remote : erreur : le fichier file.csv fait 182,47 Mo ; cela dépasse la limite de taille de fichier de GitHub de 100,00 Mo
distant : erreur : GH001 : fichiers volumineux détectés. Vous voudrez peut-être essayer Git Large File Storage - https://git-lfs.github.com.

Parlons maintenant de l'extension git Git LFS et de la façon de l'utiliser.

Git Large File Storage (LFS) est une extension Git conçue pour gérer plus efficacement les fichiers volumineux de votre référentiel.

1. Qu'est-ce que Git ?

Git est un système de contrôle de version qui vous permet de suivre les modifications apportées à votre code et de collaborer avec d'autres. Normalement, Git enregistre tout le contenu (fichiers, code, etc.) directement dans votre référentiel, y compris les images, vidéos ou fichiers binaires volumineux.

2. Pourquoi avons-nous besoin de Git LFS ?

Par défaut, Git stocke tout, mais les fichiers volumineux comme les images haute résolution, les vidéos ou les ensembles de données peuvent rendre votre référentiel très volumineux et lent. Chaque fois que vous envoyez ou extrayez des modifications, Git télécharge toutes les données, ce qui prend du temps et utilise plus d'espace de stockage sur votre machine.

Git LFS est conçu pour gérer ces fichiers volumineux plus efficacement en :

• Stockage des gros fichiers séparément : Au lieu de sauvegarder les gros fichiers directement dans votre référentiel, Git LFS les remplace par des pointeurs (petites références). Le fichier réel est stocké en dehors de votre dépôt dans un emplacement distinct.

• Garder le dépôt léger : de cette façon, votre référentiel reste léger et rapide car Git ne télécharge les fichiers volumineux que lorsque vous en avez besoin.

3.Comment fonctionne Git LFS ?

Lorsque vous ajoutez un fichier volumineux (par exemple, une vidéo ou une image) à votre référentiel, Git LFS le remplace par un petit fichier pointeur.

Le fichier pointeur indique à Git LFS où le gros fichier est réellement stocké.
Lorsque quelqu'un d'autre clone votre référentiel ou extrait des modifications, il obtiendra le fichier de pointeur au lieu du gros fichier lui-même, à moins qu'il ne supprime explicitement les gros fichiers.

4. Premiers pas avec Git LFS

Pour commencer à utiliser Git LFS dans votre projet, suivez ces étapes :

1.Installez Git LFS : vous devez installer Git LFS sur votre machine. Pour la plupart des systèmes, cela se fait en exécutant :

git lfs install

2.Suivez les fichiers volumineux : une fois installé, vous devez indiquer à Git LFS quels fichiers suivre (par exemple, tous les fichiers .png ou _.mp4 _files). Cela se fait à l'aide de la commande git lfs track :

git lfs track "*.png"

Cela indique à Git LFS de suivre tous les fichiers se terminant par .png.

3.Commit les modifications : après avoir exécuté la commande track, Git LFS crée un fichier .gitattributes qui définit les règles pour lesquelles les fichiers doivent être suivis. Vous devez valider ce fichier dans votre référentiel :

git add .gitattributes
git commit -m "Track large files using Git LFS"

4.Ajouter et transférer des fichiers volumineux : désormais, lorsque vous ajoutez un fichier volumineux (par exemple, une vidéo ou une image), Git LFS le gérera automatiquement :

git add largefile.mp4
git commit -m "Add large video file"
git push

Note
Assurez-vous d'avoir initialisé et configuré LFS avant de valider vos fichiers volumineux, sinon git LFS ne suivrait pas le fichier lorsque vous le pousseriez. Et vous continuerez à obtenir l'erreur comme avant. J'ai également rencontré ce problème lorsque j'ai commencé à utiliser l'extension git LFS.

5. Extraire des fichiers volumineux :
Lorsque quelqu'un clone ou extrait votre référentiel, il obtiendra par défaut les fichiers de pointeur légers. S'ils veulent les fichiers volumineux, ils peuvent les extraire avec :

git lfs pull

6. Avantages de Git LFS

• Accélération des opérations Git : votre référentiel reste rapide car Git n'a pas à gérer directement les fichiers volumineux.

• Réduit l'utilisation du stockage : les fichiers volumineux sont stockés séparément, ce qui réduit la taille de votre dépôt.

• Collaboration efficace : seuls les fichiers volumineux nécessaires sont téléchargés en cas de besoin.

7. Inconvénients de Git LFS

• Limites de stockage : certaines plates-formes (comme GitHub) offrent un stockage gratuit limité pour LFS, et vous devrez peut-être payer pour un stockage supplémentaire si vous avez beaucoup de fichiers volumineux.

• Extraction plus lente avec les fichiers volumineux : si vous avez beaucoup de fichiers volumineux et que vous les téléchargez tous en même temps, cela peut quand même prendre du temps, bien que Git LFS optimise cela par rapport à Git standard.

N'hésitez pas à ajouter des commentaires ou des questions. Je leur répondrai avec plaisir