Тестирование контрактов проверяет, что два сервиса согласны по поводу своего API без запуска их вместе в полном интеграционном тесте. В контрактах, управляемых потребителем (consumer-driven contracts - CDC), потребитель определяет, что ему нужно, а поставщик проверяет, что он может это доставить.
Полные сквозные тесты на множестве сервисов медленные, нестабильные и сложные для запуска при каждом коммите. Тесты контрактов выявляют нарушающие API изменения рано, в изоляции.
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
});
CI поставщика воспроизводит это и падает, если больше не возвращает такую форму.
| Тест контракта | Интеграционный тест | |
|---|---|---|
| Сервисы запущены | По одному | Все вместе |
| Скорость | Быстро | Медленно |
| Обнаруживает | Нарушения контракта | Реальные проблемы подключения |
Тесты контрактов дают вам уверенность, что изменение поставщика не сломает потребителей, без затрат и нестабильности запуска всей системы.
Они делают независимое развертывание безопасным: конвейер каждой команды сразу узнает, нарушит ли его изменение контракт, от которого кто-то зависит.