Évolution de schéma dans un flux : qui casse qui

Changer le schéma d'une API synchrone oblige à gérer deux versions pendant la durée d'un déploiement. Changer le schéma d'un message oblige à gérer toutes les versions qui ont existé, pour toujours ou presque. Le message publié ce matin sera lu par un consommateur déployé le mois dernier, par un autre déployé demain, et par un troisième qui rejouera le flux dans six mois avec un code qui n'existe pas encore. Il n'y a pas d'instant où tout le monde est à la même version. La question n'est donc jamais « ce changement est-il compatible ? » mais « compatible pour qui, et dans quel ordre de déploiement ? ».

Backward, forward, et qui déploie en premier

Les deux mots sont souvent employés l'un pour l'autre. Ils désignent deux garanties distinctes, et chacune impose qui déploie en premier.

Compatibilité ascendante (backward) : le nouveau lecteur sait lire les anciennes données. On peut alors mettre à jour les consommateurs d'abord ; ils liront les messages de l'ancien producteur, puis ceux du nouveau.

Compatibilité descendante (forward) : l'ancien lecteur sait lire les nouvelles données. On peut alors mettre à jour le producteur d'abord, et les consommateurs existants continuent sans redéploiement.

                     lit les messages v1     lit les messages v2
consommateur v1             oui              forward : doit tenir
consommateur v2      backward : doit tenir          oui

Dans une organisation où le producteur ne connaît pas tous ses consommateurs, ce qui est précisément l'intérêt d'un flux, personne ne maîtrise l'ordre de déploiement. Il faut donc les deux à la fois, la compatibilité complète. Et dès que les messages sont conservés et rejouables, elle doit être transitive : la version 5 du lecteur doit lire la version 1 des données, et pas seulement la version 4. Une chaîne de changements compatibles deux à deux peut ne pas l'être de bout en bout. Si l'on ajoute un champ facultatif en version 2, puis qu'on le rend obligatoire en version 3 parce que « tous les producteurs l'envoient », chaque pas semblait raisonnable, et les messages de la version 1 encore dans le journal deviennent illisibles.