CloudEvents voyage : identifier un événement et contrôler sa reprise

Le repère documentaire et sa portée

CloudEvents requiert id, source, specversion et type ; le couple source et id distingue un événement et peut identifier sa retransmission. Enveloppe d’événement ; ne garantit ni ordre, livraison unique, authenticité ni état final d’une réservation.

Séparer enveloppe, transport et dossier

Décrivez qui produit l’événement, quel message le transporte et quelle opération le consommateur peut effectuer. Le corps métier doit permettre de retrouver le dossier concerné selon son propre contrat. Une enveloppe lisible ne prouve pas l’authenticité du message ni la prise en charge de tous les types par le logiciel destinataire.

Définir l’identité et les effets autorisés

Conservez la source et l’identité d’événement dans la stratégie de traitement. Faites préciser si une retransmission doit être reconnue et quels effets ne doivent pas être répétés. Une référence de commande présente dans plusieurs événements ne signifie pas qu’ils soient identiques ; une modification et une annulation demandent des décisions différentes.

Préparer plusieurs producteurs

Scénario fictif : deux partenaires publient chacun un événement portant le même identifiant, mais pour deux dossiers différents. Faites traiter les messages et démontrer que le logiciel ne les confond pas. Le registre doit permettre de retrouver le producteur, le type, la référence métier et le résultat sans s’appuyer sur une identité de message isolée.

Rejouer duplication et arrivée tardive

Recevez un événement fictif deux fois, puis un état ancien après une évolution plus récente. Faites vérifier les effets produits, la lecture de l’état courant et les règles de priorité. Ne supposez pas que l’enveloppe détermine l’ordre commercial. La consigne au voyageur doit correspondre au dossier encore valable après rapprochement.

Conserver les messages non compris

Un type nouveau ou un champ inexploitable doit rester traçable avec une décision de reprise. Faites préciser si le message est suspendu, refusé ou transmis à un responsable. Une réussite du transport ne vaut pas exécution métier. Le support doit connaître l’état du traitement et les éléments nécessaires pour relire le dossier sans rejouer une action déjà accomplie.

Cas à rapprocher : UUID des dossiers : conserver l’identité sans en faire un droit d’accès

Un événement peut utiliser un UUID comme identifiant selon son contrat, mais l’enveloppe doit encore conserver source et type. Rapprochez identité d’événement, retransmission et dossier avant d’appliquer un effet. La seule possession de la référence ne doit pas autoriser sa lecture.

UUID des dossiers : conserver l’identité sans en faire un droit d’accès · Vérifier les preuves de ce dossier

Sources et périmètre des faits documentés

La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.

• CNCF : CloudEvents, spécification 1.0.2 — Enveloppe d’événement ; ne garantit ni ordre, livraison unique, authenticité ni état final d’une réservation. (consultée le 10/10/2026)