Tüketici Odaklı Sözleşme Testleri ve Pact

Stack: SOFTWARE ARCHITECTURE STACK →Senior (L5)pattern

⚡ÖZET VE TEKNİK CEVAP

Tüketici Odaklı Sözleşme (CDC) testleri, API tüketicilerinin ihtiyaç duydukları kesin alan ve uç noktaları çalıştırılabilir sözleşmeler (Pact) olarak tanımlamasını sağlar; sağlayıcılar bu sözleşmeleri CI sürecinde doğrulayarak canlıda kırıcı değişiklikleri önler.

Mühendislik El Kitabı & Mekanizma

6 Boyutlu Mimari Analiz

⚙️1. Temel Çalışma Mekanizması

Mekanizma

Mikroservis ekosistemlerinde servisler arası uyumluluğu ortak staging ortamlarında uçtan uca test etmek yavaş, kırılgan ve yalancı hatalarla doludur. Tüketici Odaklı Sözleşme testleri bu dinamiği tersine çevirir: tüketiciler ihtiyaç duydukları beklentileri Pact Broker'a sözleşme olarak yükler; sağlayıcı CI sürecinde bu sözleşmeleri doğrular.

🎯2. Doğru Kullanım Senaryosu

Kapsam

Tüketici Odaklı Sözleşme testi, API tüketici beklentilerinin resmi sözleşmelere dönüştürüldüğü ve API sağlayıcıları tarafından izole birim test süreçlerinde bağımsız olarak doğrulandığı bir test metodolojisidir.

⚠️3. Prodüksiyon Arıza Modları

Kritik Risk

Staging ortamında aynı anda 50 mikroservisin ayağa kalkmasını gerektiren hantal uçtan uca testler yazmak. API sağlayıcılarının gerçek tüketicilerin o alanları nasıl kullandığını doğrulamadan kafalarına göre OpenAPI şeması yayınlaması. Acil hotfix sırasında can-i-deploy kontrolünü baypas edip canlıda kırıcı şema değişiklikleri yayına almak.

📡4. Teşhis ve Telemetri Sinyalleri

Metrikler

sağlayıcıdaki alan adı değişikliği canlı ortamda alt tüketiciyi çökertir, sürekli çöken uçtan uca entegrasyon test ortamları, koordinasyonsuz API dağıtımı kaynaklı kesintiler

🛡️5. Önleme ve Mimari Bariyerler

Bariyerler

✓
pact-broker can-i-deploy kontrolünü doğrudan CI/CD boru hattınızın canlıya çıkış kapısına entegre edin. Sağlayıcı sözleşme testlerini çalıştırmadan önce veritabanı durumunu temiz kurmak için Provider State mekanizmasını kullanın. Tüketici sözleşmelerini yalnızca tüketicinin gerçekten okuduğu alanlarla sınırlayın
✓
kullanılmayan alanları sözleşmeye eklemeyin

⚖️6. Mimari Ödünleşimler (Trade-offs)

Ödünleşim

CDC testleri kırılgan staging entegrasyon ortamlarına olan ihtiyacı ortadan kaldırırken, yeni bir sağlayıcı sürümünün canlıdaki tüketicileri bozmayacağına dair kesin mühendislik güvencesi sunar.

📋

Vaka İncelemesi (TinyCTO Saha Örneği)

GERÇEK DÜNYA TELEMETRİSİ

CDC yaşam döngüsü dört otomatik aşamadan oluşur:

▸
Tüketici Testi: Tüketici servis Pact tarafından üretilen sahte HTTP sunucusuna karşı birim testler yazar. Testler geçtiğinde Pact kesin istek ve yanıt şemasını içeren bir JSON sözleşmesi (pact.json) üretir.
▸
Pact Broker'a Yükleme: Tüketicinin CI boru hattı sözleşmeyi merkezi Pact Broker'a git commit SHA'sı ve ortam etiketiyle yükler.
▸
Sağlayıcı Doğrulaması: Sağlayıcı servis Pact Broker'daki tüm aktif sözleşmeleri çeker ve sahte sağlayıcı durumlarıyla yerel controller katmanında çalıştırır.
▸
can-i-deploy Onay Kapısı: Canlıya çıkmadan önce servis Pact Broker'a sorar: pact-broker can-i-deploy --pacticipant OrderService --version $GIT_SHA --to-environment production. Tüm matris kombinasyonları başarılıysa 0 kodu döner.

İnteraktif Konsept Alıştırmaları

2 Alıştırma

Mikroservislerde Tüketici Odaklı Sözleşme testinin tam Uçtan Uca entegrasyon testine göre temel avantajı nedir?

Karmaşık ve kırılgan çok servisli staging ortamlarına ihtiyaç duymadan hızlı ve izole CI birim testlerinde uyumluluğu doğrular.

`pact-broker can-i-deploy` komutu neyi doğrular?

Servisin belirli bir sürümünün, hedef ortamda çalışan tüm tüketici ve sağlayıcıların tam sürümleriyle başarıyla doğrulanıp doğrulanmadığını.