Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Cloner moins : sparse-checkout et clone superficiel

Cloner moins : sparse-checkout et clone superficiel

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

Trois leviers différents, qu'on confond souvent. Ils ne réduisent pas la même chose.

git clone --filter=blob:none URL      # moins d'objets téléchargés
git clone --depth 1 URL               # moins de commits
git sparse-checkout set --cone a/ b/  # moins de fichiers sur le disque

sparse-checkout : le disque de travail

git clone --filter=blob:none --sparse URL depot
cd depot
git sparse-checkout set --cone applications/boutique bibliotheques/coeur

Seuls ces répertoires — plus les fichiers à la racine — apparaissent dans le répertoire de travail. L'historique reste entier : log, blame et les branches fonctionnent normalement. Ce qu'on gagne, c'est le temps d'un status, d'un changement de branche et de l'indexation par l'éditeur.

--depth : l'historique

git clone --depth 1 --branch main URL

Un seul commit. Le clone est très léger et blame, log et merge-base deviennent faux ou impossibles. C'est fait pour une construction jetable, pas pour un poste de travail.

--filter=blob:none : le compromis

Tout le graphe de commits, aucun contenu de fichier avant qu'on en ait besoin. L'historique reste navigable ; Git va chercher ce qui manque à la demande.

Option Historique Contenus Fichiers extraits
clone complet tout tout tout
--filter=blob:none tout à la demande tout
--depth 1 dernier commit de ce commit tout
sparse-checkout inchangé inchangés les chemins choisis

Les termes à connaître

sparse-checkout

Restreint les fichiers extraits dans le répertoire de travail à certains chemins. L'historique et les objets restent complets : c'est le disque de travail qu'on allège, pas le dépôt.

Mode cône

git sparse-checkout set --cone : les motifs sont des répertoires, pas des expressions. Beaucoup plus rapide sur un gros dépôt, et beaucoup plus prévisible — c'est le mode par défaut aujourd'hui.

Clone superficiel

git clone --depth 1 : ne récupère que les derniers commits. L'historique est tronqué, donc log, blame et merge-base deviennent incomplets ou impossibles.

Clone partiel

git clone --filter=blob:none : récupère tout le graphe de commits mais aucun contenu de fichier avant qu'on en ait besoin. L'historique reste navigable, les contenus arrivent à la demande.

blob

L'objet Git qui contient le contenu d'un fichier. C'est le plus gros poste d'un dépôt ancien : les versions successives de chaque fichier y sont toutes conservées.

Récupération à la demande

Dans un clone partiel, Git va chercher un objet manquant au moment où une commande en a besoin. Pratique en local, catastrophique sur une machine d'intégration sans réseau rapide.

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.