Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 98 – Mikroservis iletişimi fikri

Mikroservis mimarisinde HTTP/JSON sözleşmesiyle versiyonlu endpoint oluşturma, adım adım örnekler ve sık yapılan hatalar.

Ders 98 – Mikroservis iletişimi fikri

Günümüz dağıtık sistemlerinde mikroservisler, uygulamaların ölçeklenebilir, bağımsız ve hızlı geliştirilmesini sağlar. Ancak servisler arasındaki iletişim doğru tanımlanmazsa sürüm uyumsuzlukları, veri kaybı ve bakım zorluğu gibi problemler ortaya çıkar. Bu derste, HTTP tabanlı JSON sözleşmesiyle versiyonlu bir endpoint nasıl tasarlanır, Python ile basit bir servis nasıl oluşturulur ve PHP istemcisiyle nasıl etkileşime girilir, adım adım gösterilecektir.

Temeller

Mikroservis iletişimi üç temel bileşene dayanır:

  • Protokol: HTTP/HTTPS en yaygın protokoldür; hafif, geniş destekli ve firewall dostudur.
  • Veri formatı: JSON, dil bağımsızlığı ve okunabilirliği sayesinde tercih edilir.
  • Sözleşme (contract): İstemci ve sunucu arasında paylaşılan bir API tanımıdır; genellikle OpenAPI/Swagger ile belgelenir.

Versiyonlu endpoint, sözleşmenin değişmesi durumunda geriye dönük uyumluluğu korur. Örneğin /api/v1/orders ve /api/v2/orders aynı kaynak için farklı veri modelleri sunabilir.

Adım Adım Uygulama

Bu bölümde, Flask kullanarak /api/v1/greeting adlı bir mikroservis oluşturacağız. Servis, bir name parametresi alır ve JSON olarak selam mesajı döner.

from flask import Flask, request, jsonify
app = Flask(__name__)

@app.route('/api/v1/greeting', methods=['GET'])
def greeting_v1():
    name = request.args.get('name', 'Dünya')
    return jsonify({
        'version': 'v1',
        'message': f'Merhaba, {name}!'
    })

if __name__ == '__main__':
    app.run(debug=True)

Bu kodu greeting_service.py dosyasına kaydedin, bir sanal ortam (python -m venv venv) oluşturup etkinleştirin ve pip install flask komutuyla Flask'ı kurun. Çalıştırdıktan sonra http://127.0.0.1:5000/api/v1/greeting?name=Ali adresine bir GET isteği gönderdiğinizde aşağıdaki JSON yanıtını alacaksınız:

{
  "version": "v1",
  "message": "Merhaba, Ali!"
}

Versiyon 2 için aynı endpoint'i /api/v2/greeting altında farklı bir veri modeliyle genişletebiliriz.

Örnek Kod

Aşağıda iki ayrı PHP örneği bulacaksınız. İlk örnek, bir PHP istemcisiyle mikroservise GET isteği gönderir. İkinci örnek ise Slim framework kullanarak basit bir PHP mikroservis oluşturur.

<?php
// php_client.php – Flask servisine GET isteği gönderir
$url = 'http://127.0.0.1:5000/api/v1/greeting?name=Ayşe';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $data = json_decode($response, true);
    echo "Versiyon: {$data['version']}, Mesaj: {$data['message']}\n";
} else {
    echo "Hata: HTTP $httpCode\n";
}
?>
<?php
// php_service.php – Slim framework ile versiyonlu endpoint
require __DIR__ . '/vendor/autoload.php';
$app = new \Slim\App();

$app->get('/api/v1/greeting', function ($request, $response, $args) {
    $params = $request->getQueryParams();
    $name = $params['name'] ?? 'Dünya';
    $payload = [
        'version' => 'v1',
        'message' => "Merhaba, $name!"
    ];
    $response->getBody()->write(json_encode($payload));
    return $response->withHeader('Content-Type', 'application/json');
});

$app->run();
?>

PHP örneklerini çalıştırmak için composer require slim/slim:"4.*" komutunu kullanın ve ardından php -S localhost:8080 php_service.php ile servisiniz dinlemeye başlasın.

Sık Karşılaşılan Hatalar

  • Versiyon karışıklığı: Endpoint URL'inde versiyon numarasını tutarlı tutmazsanız eski istemciler yeni sözleşmeyi anlamaz.
  • JSON kodlaması: Yanıtı json_encode yerine manuel string oluşturursanız karakter kaçış hataları ortaya çıkar.
  • CORS eksikliği: Tarayıcı tabanlı istemciler farklı origin'lerden çağrı yapıyorsa Access-Control-Allow-Origin başlığını eklemeyi unutmayın.
  • Hata yönetimi: 4xx/5xx durum kodlarını döndürüp gövdeye açıklama eklemezseniz istemci sorunları tanımlayamaz.

Özet ve Kontrol Listesi

Bu derste öğrendikleriniz:

  • Mikroservislerde HTTP/JSON sözleşmesinin önemi.
  • Versiyonlu endpoint tasarımı.
  • Flask ile basit bir Python servisi.
  • PHP cURL ile istemci ve Slim ile servis örnekleri.

Uygulama sonrası aşağıdaki kontrol listesini doldurun:

  • Versiyon numarası URL içinde tutarlı mı?
  • JSON yanıtı Content-Type: application/json başlığıyla mı gönderiliyor?
  • Hata durumları için uygun HTTP durum kodları kullanıldı mı?
  • PHP istemcisi ve servisi sorunsuz çalışıyor mu?

SSS

Soru 1: Versiyonlu endpoint yerine tek bir endpoint içinde Accept-Version başlığı kullanabilir miyim?
Cevap: Evet, header tabanlı sürümleme mümkündür ancak URL tabanlı sürümleme (ör. /v1/) daha okunaklı ve cache dostudur.

Soru 2: JSON yerine Protobuf gibi ikili formatlar kullanmak daha iyi mi?
Cevap: Protobuf performans avantajı sağlar, ancak ek şema yönetimi ve dil desteği gerektirir. Başlangıç seviyesinde JSON yeterlidir.

Soru 3: Mikroservisler arası iletişimde sadece HTTP yeterli mi?
Cevap: Çoğu senaryoda evet; yüksek performanslı düşük gecikmeli ihtiyaçlar için gRPC, RabbitMQ gibi mesaj kuyrukları tercih edilebilir.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

Python ile web, veri, otomasyon ve AI alanlarına yön veren ileri seviye bir yol haritası, adım ad…

Ders 99 – Kontrol listesi: üretim

Üretim ortamı için log, health, config ve secret yönetimini kapsayan kontrol listesi, adım adım ö…

Ders 97 – Veri doğrulama katmanı

Veri doğrulama katmanını Pydantic ve Cerberus ile nasıl kuracağınızı adım adım öğrenin, örnek PHP…

Ders 96 – Web scraping etiği

Web scraping yaparken yasal ve etik sorumlulukları, rate limit ve hizmet şartlarını nasıl uygulay…

Demo
Büyütülmüş Görsel