ਖਪਤ ਕਨਵਾਲੇ ਬਿੰਦੀ ਸਮਝੌਤੇ ਦਾ ਪਰੀਖਣ (consumer-driven contract testing) ਕੀ ਹੈ?

Question

Accepted Answer

**ਸਮਝੌਤੇ ਦਾ ਪਰੀਖਣ (Contract testing)** ਦੋ ਸੇਵਾਵਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰਦਾ ਹੈ ਕਿ ਉਹ ਆਪਣੇ API ਬਾਰੇ ਸਹਿਮਤ ਹਨ **ਬਿਨਾ** ਉਨ੍ਹਾਂ ਨੂੰ ਪੂਰੇ ਏਕੀਕਰਣ ਪਰੀਖਣ ਵਿੱਚ ਇਕੱਠੇ ਚਲਾਏ। **ਖਪਤ ਕਨਵਾਲੀ ਸਮਝੌਤਾਂ (consumer-driven contracts - CDC)** ਵਿੱਚ, ਖਪਤ ਕਰਨ ਵਾਲਾ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦਾ ਹੈ ਕਿ ਉਸ ਨੂੰ ਕੀ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ ਪ੍ਰਦਾਤਾ ਪੁਸ਼ਟੀ ਕਰਦਾ ਹੈ ਕਿ ਇਹ ਇਸ ਨੂੰ ਪ੍ਰਦਾਨ ਕਰ ਸਕਦਾ ਹੈ।

## ਸਮੱਸਿਆ

ਬਹੁਤ ਸਾਰੀਆਂ ਸੇਵਾਵਾਂ ਵਿੱਚ ਪੂਰੇ ਸਿਰੇ ਤੋਂ ਅੰਤ ਤੱਕ ਪਰੀਖਣ ਸ਼ਾਖ, ਅਸਥਿਰ ਅਤੇ ਹਰੇਕ ਕਮਿਟ ਉੱਤੇ ਚਲਾਉਣਾ ਮੁਸ਼ਕਲ ਹਨ। ਸਮਝੌਤੇ ਦੇ ਪਰੀਖਣ 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
```

## ਖਪਤ ਕਰਨ ਵਾਲੇ ਪਾਸੇ ਦਾ ਉਦਾਹਰਣ

```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
  });
```

ਪ੍ਰਦਾਤਾ ਦਾ CI ਇਸ ਨੂੰ ਦੁਬਾਰਾ ਚਲਾਉਂਦਾ ਹੈ ਅਤੇ ਅਸਫਲ ਹੁੰਦਾ ਹੈ ਜੇ ਇਹ ਅੱਗੇ ਉਸ ਰੂਪ ਨੂੰ ਵਾਪਸ ਨਹੀਂ ਕਰਦਾ।

## CDC ਬਨਾਮ ਏਕੀਕਰਣ ਪਰੀਖਣ

| | ਸਮਝੌਤੇ ਦਾ ਪਰੀਖਣ | ਏਕੀਕਰਣ ਪਰੀਖਣ |
|---|---|---|
| ਸੇਵਾਵਾਂ ਚਲ ਰਹੀਆਂ | ਇੱਕ ਸਮੇਂ | ਸਭ ਇਕੱਠੇ |
| ਗਤੀ | ਤੇਜ਼ | ਸ਼ਾਖ |
| ਫੜਦਾ ਹੈ | ਸਮਝੌਤੇ ਟੁੱਟਣਾ | ਅਸਲ ਤਾਰ ਨਾ ਜੁੜਨਾ |

## ਇਹ ਕਿਉਂ ਮਾਇਨੇ ਰਖਦਾ ਹੈ

ਸਮਝੌਤੇ ਦੇ ਪਰੀਖਣ ਤੁਹਾਨੂੰ ਆਤਮ ਵਿਸ਼ਵਾਸ ਦਿੰਦੇ ਹਨ ਕਿ ਇੱਕ ਪ੍ਰਦਾਤਾ ਤਬਦੀਲੀ ਖਪਤ ਕਰਨ ਵਾਲਿਆਂ ਨੂੰ ਨਹੀਂ ਤੋੜੇਗੀ, ਬਿਨਾ ਸਮੁੱਚੀ ਪ੍ਰਣਾਲੀ ਨੂੰ ਚਾਲੂ ਕਰਨ ਦੀ ਲਾਗਤ ਅਤੇ ਅਸਥਿਰਤਾ ਦੇ।

ਉਹ ਸਧਾਰਣ ਤੌਰ 'ਤੇ ਤਾਲਮੇਲ ਨੂੰ ਸੁਰੱਖਿਅਤ ਬਣਾਉਂਦੇ ਹਨ: ਹਰੇਕ ਟੀਮ ਦੀ ਪਾਈਪ ਲਾਈਨ ਤੁਰੰਤ ਜਾਣਦੀ ਹੈ ਕਿ ਕੀ ਇਸ ਦੀ ਤਬਦੀਲੀ ਕਿਸੇ ਸਮਝੌਤੇ ਦੀ ਉਲੰਘਣਾ ਕਰੇਗੀ ਜਿਸ ਉੱਤੇ ਕਦੀ ਨਿਰਭਰ ਹੈ।

	ਸਮਝੌਤੇ ਦਾ ਪਰੀਖਣ	ਏਕੀਕਰਣ ਪਰੀਖਣ
ਸੇਵਾਵਾਂ ਚਲ ਰਹੀਆਂ	ਇੱਕ ਸਮੇਂ	ਸਭ ਇਕੱਠੇ
ਗਤੀ	ਤੇਜ਼	ਸ਼ਾਖ
ਫੜਦਾ ਹੈ	ਸਮਝੌਤੇ ਟੁੱਟਣਾ	ਅਸਲ ਤਾਰ ਨਾ ਜੁੜਨਾ