LLI Wiki — My Digital Knowledge Base

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

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.

git update-index --cacheinfo 160000,<sha>,applications/ExportApp

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

Mastodon LLIMastodon SocialFosstodon