Formations — 1 037 leçons en français

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 :

// 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.

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.