Contract testing patikrina, kad dvi paslaugos sutaria dėl jų API be jų kartu paleistos pilnoje integracijos bandyme. Consumer-driven contracts (CDC) atveju vartotojas apibrėžia, ką jam reikia, ir teikėjas patvirtina, kad gali tai suteikti.
Visapusiai end-to-end bandymai keliose paslaugose yra lėti, nestabilūs ir sunkiai vykdomi kiekviename įsidiegime. Sutarčių bandymai greitai, izoliuotai, prieš pradedant, aptinka laužančius API pakeitimus.
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
});
Teikėjo CI pakartotinai paleidi tai ir nepavyksta, jei ji nebegrąžina tos pačios formos.
| Contract test | Integration test | |
|---|---|---|
| Paslaugos paleistos | Po vieną | Visos kartu |
| Greitis | Greita | Lėta |
| Aptinka | Sutarčių laužymus | Realiųjų sujungimo problemas |
Sutarčių bandymai suteikia pasitikėjimą, kad teikėjo pakeitimas nesulaužys vartotojų, be visos sistemos paleidimo kaštų ir nestabilumo.
Jie sudaro nepriklausomą diegimą saugų: kiekvienos komandos pipeline'as iš karto žino, ar jos pakeitimas pažeis nuo kurio nors priklausomą sutartį.