consumer-driven contract testingとは何ですか?

Question

Accepted Answer

**Contract testing**は、2つのサービスが完全な統合テストを実行せずにAPI上で合意していることを検証します。**consumer-driven contracts (CDC)**では、consumerが必要なものを定義し、providerがそれを提供できることを検証します。

## 問題

多くのサービス全体でのエンドツーエンドテストは遅く、不安定で、すべてのコミットで実行するのが難しいです。Contract testはAPIの互換性を損なう変更を早期に、隔離した状態で検出します。

## CDCの仕組み（例：Pact）

```text
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側の例

```js
// 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のCIはこれを再生し、その形状を返さなくなったら失敗します。

## CDCと統合テストの比較

| | Contract test | Integration test |
|---|---|---|
| 実行中のサービス | 1つずつ | すべて一緒に |
| 速度 | 高速 | 遅い |
| 検出するもの | Contract破損 | 実際の配線の問題 |

## なぜ重要なのか

Contract testは、システム全体を起動するコストと不安定性なしに、providerの変更がconsumerを破壊しないことへの信頼を与えます。

これにより独立したデプロイメントが安全になります：各チームのパイプラインは、その変更が誰かが依存しているcontractに違反するかどうかを即座に知ることができます。

	Contract test	Integration test
実行中のサービス	1つずつ	すべて一緒に
速度	高速	遅い
検出するもの	Contract破損	実際の配線の問題