Monorepo à sous-modules Git : un tag par module pour des déploiements reproductibles
Pourquoi et comment épingler chaque sous-module par tag, ordre des commits (sous-module puis parent) et pièges des sessions parallèles.
Mon dépôt DBA est un dépôt parent dont chaque module et chaque application est un sous-module Git. Chacun est un vrai dépôt Azure DevOps indépendant, avec son historique et ses tags. Ça peut sembler lourd ; c'est ce qui me donne des déploiements reproductibles. Voici pourquoi et comment.
Pourquoi des sous-modules
- Une application peut avoir son propre pipeline, ses propres droits et son propre cycle de release.
- Les modules partagés (accès SQL, journalisation, aides Batch) sont versionnés séparément et réutilisés par toutes les applications.
- Le parent ne stocke qu'un pointeur (un SHA) par sous-module, plus les assets d'orchestration (pipelines, variables, docs).
Règle que je m'impose : un composant devient un sous-module seulement s'il a besoin de son propre tag ou de son propre pipeline. Les petits outils lancés à la main restent de simples dossiers du parent.
Les tags par sous-module
Format AAAA.M.N : le mois (sans zéro initial) puis un compteur qui repart à 1 chaque mois, jamais le jour. Les tags sont par sous-module, pas globaux au dépôt. Le prochain tag se calcule à partir du dernier :
git -C modules/CoreModule tag --sort=-version:refname | Select-Object -First 1
On tague après le merge sur main, pas sur une branche de travail.
La carte des tags
Pour un déploiement figé, une carte associe chaque chemin de sous-module à un tag. Elle est volontairement écrite dans le script, pas passée en paramètre : la version déployée est relue et revue comme du code.
$submoduleTags = [ordered]@{
'modules/CoreModule' = '2026.8.2'
'modules/BatchHelpers' = '2026.8.1'
'applications/ExportApp' = '2026.7.1'
}
foreach ($path in $submoduleTags.Keys) {
$tag = $submoduleTags[$path]
git -C $path fetch --tags origin
git -C $path checkout --quiet "refs/tags/$tag"
git -C $path describe --tags --exact-match # échoue si HEAD n'est pas exactement sur le tag
}
Le describe --exact-match final est la vérification : si le tag n'existe pas sur le remote, ou pointe ailleurs, on le voit tout de suite.
Le flux
flowchart TD
A["Commit dans le sous-module"] --> B["Push du sous-module"]
B --> C["Tag AAAA.M.N poussé sur le remote"]
C --> D["Commit du pointeur dans le parent"]
D --> E["Carte des tags mise à jour"]
E --> F["Clone ou mise à jour figée"]
F --> G["Vérification : describe exact-match"]
G --> H["Pipeline de déploiement"]
Ordre des commits
Toujours le sous-module d'abord, puis le parent. Un git commit à la racine ne capture jamais le contenu d'un sous-module, seulement le nouveau pointeur. Si le parent référence un SHA qui n'a pas été poussé, personne d'autre ne peut le récupérer.
Pièges avec les sessions parallèles
Plusieurs sessions (moi, un assistant IA, un script) travaillent parfois dans le même clone en même temps.
- Un script « commit tout » (
git add -A) ne convient que si je suis seul dans le clone. Sinon, je commite mes chemins et rien d'autre. - Avant un commit dans un sous-module, je relis sa branche : une autre session a pu la changer. Si mon commit a atterri sur la branche d'un autre, je ne reset pas et je ne change pas de branche ; je déplace
mainpar référence (git fetch . <sha>:refs/heads/main) puis je pousse. - Dans le parent, j'enregistre le pointeur par SHA plutôt qu'avec
git add <sous-module>, qui prend le HEAD que l'autre session a laissé :
git update-index --cacheinfo 160000,<sha>,applications/ExportApp
- Pour un long travail parallèle sur les mêmes sous-modules, un
git worktreedédié évite tous ces conflits.
Dans les pipelines
N'utilisez pas submodules: true pour n'en récupérer qu'une partie. Je déclare chaque dépôt comme resource et je le récupère explicitement avec checkout: et path:. Les modules suivent latest par défaut dans le pipeline : la reproductibilité vient de la carte des tags, pas des valeurs par défaut du YAML.
Retour d'expérience
- Un tag créé localement mais jamais poussé fait échouer le checkout sur toutes les autres machines (
remote tag not found). - Ajouter un sous-module à la liste stable = ajouter son entrée dans chaque script qui contient une carte.
- Figer un module alors que l'application tourne depuis
HEADcasse en silence dès qu'une fonction migre de l'application vers le module. - Une
HEADdétachée dans un sous-module est normale après un checkout de tag ; elle devient un piège dès qu'on tente de commiter dessus.