Contract testing επαληθεύει ότι δύο services συμφωνούν στο API τους χωρίς να τρέχουν μαζί σε ένα πλήρες integration test. Στα consumer-driven contracts (CDC), ο consumer ορίζει τι χρειάζεται, και ο provider επαληθεύει ότι μπορεί να το παραδώσει.
Οι πλήρες end-to-end tests σε πολλά services είναι αργές, unstable, και δύσκολο να τρέξουν σε κάθε commit. Οι contract tests πιάνουν breaking API changes νωρίς, σε απομόνωση.
1. Consumer writes expectations ─▶ generates a CONTRACT (Pact file)
2. Contract published to a broker
3. Provider runs the contract against itself in its own pipeline
4. Provider build FAILS if it would break the consumer
// consumer declares exactly what it expects from the provider
provider.given('order 42 exists')
.uponReceiving('a request for order 42')
.withRequest({ method: 'GET', path: '/orders/42' })
.willRespondWith({
status: 200,
body: { id: '42', total: 99.5 } // the shape the consumer relies on
});
Ο provider's CI ξαναπαίζει αυτό και αποτυγχάνει αν δεν επιστρέφει πλέον αυτό το shape.
| Contract test | Integration test | |
|---|---|---|
| Services running | One at a time | All together |
| Speed | Fast | Slow |
| Catches | Contract breaks | Real wiring issues |
Οι contract tests σας δίνουν την βεβαιότητα ότι μια αλλαγή provider δεν θα σπάσει consumers, χωρίς το κόστος και την instability του να ανοίξετε ολόκληρο το σύστημα.
Κάνουν το independent deployment ασφαλές: το pipeline κάθε ομάδας γνωρίζει αμέσως αν η αλλαγή του θα παραβίαζε ένα contract στο οποίο κάποιος εξαρτάται.