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é, donclog,blameetmerge-basedeviennent 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.
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.