Accueil › Git & CI/CD › Monorepo ou multi-dépôts
Monorepo ou multi-dépôts
Monorepo, sous-modules et gros dépôtsavance
La question n'est pas « quel est le bon choix » mais « quel problème acceptez-vous d'avoir ».
Ce qu'un monorepo donne
depot/
bibliotheques/coeur/
bibliotheques/http/
applications/boutique/
applications/admin/
Un seul commit peut modifier coeur et les quatre projets qui l'utilisent.
Une seule revue, une seule exécution de tests, un seul retour arrière. Il
n'existe jamais deux versions de coeur en circulation : il n'y en a qu'une,
celle du dépôt.
Ce qu'il coûte
Le clone grossit avec l'historique de tous les projets. L'intégration
continue doit apprendre à ne rebâtir que ce qui est touché, sinon chaque commit
lance tout. Et la frontière que donnait un dépôt séparé — qui a le droit de
toucher à quoi — doit être recréée avec CODEOWNERS et des règles de
protection par chemin.
Ce que les multi-dépôts donnent
Chaque équipe livre à son rythme, derrière une version publiée. Le clone est petit, les droits sont évidents, l'outillage est standard.
Ce qu'ils coûtent
# bibliothèque : publier 2.0.0
# puis, dans chaque dépôt appelant, un commit de migration…
Un changement cassant devient une campagne. Entre la publication et la dernière migration, plusieurs versions de la bibliothèque coexistent en production, et personne ne sait exactement qui utilise laquelle.
| Besoin | Monorepo | Multi-dépôts |
|---|---|---|
| Changement traversant | un commit | une campagne |
| Taille du clone | croissante | petite |
| Indépendance de livraison | à construire | native |
| Outillage | à construire | standard |
Les termes à connaître
- Monorepo
Un seul dépôt Git contenant plusieurs projets — applications, bibliothèques, outils. Un commit peut traverser plusieurs projets à la fois, et il n'existe qu'une version de chaque chose.
- Multi-dépôts
Un dépôt par projet. Chaque projet a son historique, ses droits et son rythme de livraison, et dépend des autres par des paquets publiés et versionnés.
- Changement atomique
Une modification d'une bibliothèque et de tous ses appelants dans un seul commit. Possible en monorepo, impossible entre deux dépôts — on y passe forcément par deux commits et une fenêtre d'incohérence.
- Projets affectés
L'ensemble des projets qu'il faut rebâtir et retester après un changement. Se calcule depuis les fichiers modifiés et le graphe de dépendances, en remontant transitivement vers les dépendants.
- Graphe de dépendances
Qui dépend de qui. En monorepo, il est lisible en entier et vérifiable automatiquement ; en multi-dépôts, il est dispersé dans les fichiers de dépendances et personne n'en a la vue complète.
- Propriétaires de code
Un fichier
CODEOWNERSqui associe un motif de chemin à une équipe. C'est ce qui remplace, en monorepo, la frontière que donnait naturellement un dépôt séparé.
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.