Accueil › Architecture & design patterns › Le contrat entre services, et comment le faire évoluer
Le contrat entre services, et comment le faire évoluer
Communiquer entre servicesavance
Un contrat, c'est ce que le consommateur a le droit de supposer. Dès qu'un service est déployé indépendamment, le producteur et ses consommateurs ne sont plus jamais à jour en même temps. Toute évolution doit donc survivre à cette fenêtre de décalage.
Deux sens de compatibilité, qu'on confond en entretien :
- en arrière : un consommateur ancien lit un message nouveau ;
- en avant : un consommateur nouveau lit un message ancien.
// Ajout d'un champ facultatif : compatible dans les deux sens.
const avant = { id: "c1", montant: 30 };
const apres = { id: "c1", montant: 30, devise: "EUR" };
// Consommateur ancien : ignore « devise », continue.
// Consommateur nouveau : doit traiter son absence.
const devise = (m) => m.devise ?? "EUR";
Le renommage, lui, n'est jamais compatible : c'est une suppression doublée d'un ajout.
// ❌ casse tout consommateur qui lit « montant »
const apres = { id: "c1", montantTotal: 30 };
La règle pratique tient en une phrase : ajouter du facultatif est sûr ; retirer, renommer ou resserrer ne l'est pas. Et côté consommateur, la tolérance — ne lire que ce dont on a besoin, ignorer le reste — supprime à elle seule la majorité des ruptures.
Les termes à connaître
- Contrat
Ce sur quoi producteur et consommateur se sont mis d'accord : forme des messages, champs obligatoires, sens des valeurs, codes d'erreur.
- Compatibilité en arrière
Un consommateur écrit pour l'ancienne version comprend encore les messages produits par la nouvelle.
- Compatibilité en avant
Un consommateur déjà mis à jour comprend encore les messages produits par l'ancienne version.
- Tolérance du consommateur
Ne lire que les champs dont on a besoin, ignorer les autres, et ne pas échouer sur un champ inconnu.
- Expansion puis contraction
Ajouter le nouveau, faire migrer les consommateurs, retirer l'ancien — trois déploiements séparés plutôt qu'un changement simultané.
- Test de contrat
Un test détenu par le consommateur et exécuté contre le producteur, qui échoue quand le producteur casse un usage réel.
- Versionnage
Exposer plusieurs formes du contrat en parallèle, pour que la migration des consommateurs n'ait pas à être simultanée.
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.