Skip to content

08 Migrer

Harrylepap edited this page Nov 13, 2026 · 1 revision

08. Migrer

On fige le comportement avant de toucher au socle.

Pourquoi

Une migration de socle est un pari asymétrique. Si elle réussit parfaitement, personne ne remarque rien : c'est le but. Si elle casse quoi que ce soit, tout le monde le remarque, et personne ne comprend pourquoi l'équipe a pris ce risque pour un bénéfice invisible.

Il faut donc la conduire avec une discipline particulière. Les migrations qui échouent ne manquent généralement pas de compétence technique. Elles manquent de méthode : on change trop de choses à la fois, on ne sait pas mesurer l'écart, et on découvre en production des comportements que personne n'avait documentés.

En pratique

Règle 1 : figer le comportement

Pendant la migration, aucune correction fonctionnelle. Pas même un bug évident, ancien et gênant. On le note dans une liste dédiée, on le corrige après la bascule.

La raison tient au diagnostic. Si le comportement change pendant la migration, chaque écart observé a deux explications possibles : la migration a introduit une régression, ou la correction a modifié le comportement. Distinguer les deux coûte des heures à chaque fois. Avec une seule variable en mouvement, un écart est forcément une régression.

Cette règle est impopulaire. Elle oblige à laisser en place, pendant des semaines, des défauts que tout le monde connaît. Il faut l'expliquer au métier en amont, et tenir.

Règle 2 : le filet se joue sur l'existant

Avant toute modification, on écrit des tests de caractérisation. Le terme vient de Michael Feathers : un test qui ne décrit pas ce que le système devrait faire, mais ce qu'il fait, défauts compris.

Ce qu'on oublie le plus souvent : ce filet s'exécute d'abord sur la pile actuelle. Pas sur la cible. S'il est écrit directement contre la nouvelle version, on ne sait pas s'il décrit l'ancien comportement ou le nouveau. Il doit passer au vert sur l'ancien monde avant qu'on touche quoi que ce soit.

flowchart LR
  A["Écrire le filet"] --> B["Vert sur la pile actuelle"]
  B --> C["Migrer"]
  C --> D{"Vert sur la nouvelle pile ?"}
  D -->|oui| E["Comportement préservé"]
  D -->|non| F["Écart précis à analyser"]
Loading

Les tests en boîte noire décrits dans Tester sont les meilleurs candidats : ils ignorent tout de l'intérieur, et survivent donc au changement de framework, de version de langage ou de base de données.

Un exemple de ce qu'on fige, et qui surprend toujours : un champ renvoyé null dans un cas limite, un ordre de tri implicite, un message d'erreur que l'application mobile analyse pour décider d'un affichage. Personne ne les a spécifiés. Quelqu'un en dépend.

Règle 3 : par morceaux

Le motif Strangler Fig, décrit par Martin Fowler, consiste à faire pousser le nouveau système autour de l'ancien, périmètre par périmètre, jusqu'à ce que l'ancien n'ait plus rien à faire.

En pratique :

  1. On identifie une frontière : un endpoint, un type de message, un traitement par lots.
  2. On migre ce périmètre seul.
  3. Un routage, un drapeau ou un proxy envoie le trafic vers l'un ou l'autre.
  4. On bascule progressivement, en gardant l'ancien chemin disponible.
  5. On passe au périmètre suivant.

Le « grand soir » où tout bascule d'un coup n'existe que dans les plannings optimistes.

Règle 4 : comparer, pas supposer

Quand c'est possible, on fait tourner l'ancien et le nouveau en parallèle sur le même trafic, et on compare les sorties. Le nouveau calcule mais ne fait pas foi ; on journalise les écarts.

Un écart n'est pas forcément une erreur : un horodatage, un arrondi, un ordre de champs JSON. Mais chaque écart est une question, et il faut y répondre avant de basculer.

Ce qu'on mesure

  • Le taux de passage du filet, sur l'ancien et sur le nouveau.
  • Le volume et la nature des écarts en parallèle.
  • Les indicateurs de production habituels, avant et après chaque bascule.
  • La liste des bugs gelés, pour qu'ils ne soient pas oubliés après.

Signaux d'alerte

  • « Tant qu'on y est, on pourrait aussi... »
  • Le filet de tests est écrit directement contre la nouvelle version.
  • Une date de bascule unique pour tout le système.
  • Des corrections fonctionnelles glissées dans les demandes de fusion de migration.
  • Personne ne sait dire combien de comportements le filet couvre.

Objections

« Laisser des bugs connus pendant des semaines, c'est irresponsable. » Un bug critique pour la sécurité ou l'argent des clients se corrige, migration ou pas, dans une livraison séparée, identifiée et testée seule. Les autres attendent. Ce qui serait irresponsable, c'est de ne plus pouvoir distinguer une régression d'une correction.

« Écrire des tests sur un comportement qu'on sait faux, c'est absurde. » C'est inconfortable, pas absurde. Le test documente ce qui existe. Après la migration, on corrige le bug et on modifie le test, en connaissance de cause.

« Faire tourner les deux systèmes en parallèle coûte cher. » Moins cher qu'un incident de bascule. Et on n'est pas obligé de comparer tout le trafic : un échantillon suffit souvent.

Pour aller plus loin

  • Martin Fowler, « StranglerFigApplication », sur martinfowler.com.
  • Michael Feathers, Working Effectively with Legacy Code, chapitre 13, Prentice Hall, 2004.
  • Sam Newman, Monolith to Microservices, O'Reilly, 2019.
  • GitHub Engineering, « Move Fast and Fix Things » (l'outil Scientist), 2015.

Clone this wiki locally