Formations — 1 037 leçons en français

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 CODEOWNERS qui 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é.

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.