API geliştirme

AWS üzerinde Uygulama Geliştirme

Ricardo Sueiras

Principal Technologist

API Gateway tümleştirmeleri

 

• Birden çok arka uç tümleştirme seçeneği
• HTTP: herkese açık yönlenebilir herhangi bir uç nokta
• DynamoDB veya SNS gibi AWS hizmet API'leri
• Lambda işlevleri
• VPC bağlantılarıyla özel kaynaklar
• Gerçek arka uç olmadan sahte yanıtlar

Tümleştirme türleri: vekil

 

• Tümleştirme türü, API Gateway'in denetim düzeyini belirler
• Vekil türleri: AWS_PROXY ve HTTP_PROXY
• Tüm HTTP isteği doğrudan arka uca gönderilir
• API Gateway şeffaf bir geçiştir
• Yanıtı arka uç oluşturur

Tümleştirme türleri: vekil olmayan

• Vekil olmayan türler: AWS ve HTTP
• İstek ve yanıt dönüşümlerini sen yapılandırırsın
• Eşleme şablonlarıyla yönetilir
• Şablonlar Velocity Template Language (VTL) ile yazılır

 

İstek doğrulama

 

• İstekleri arka uca ulaşmadan önce doğrula
• Zorunlu alan eksiklerini yakalar
• Geçersiz JSON biçimini yakalar
• Hatalı parametre türlerini yakalar
• Başarısızlıklar genelde 400 Bad Request döner

İstek doğrulama

 

• Doğrulama şunları kapsayabilir:
  • Başlıklar
  • Sorgu dizesi parametreleri
  • İstek gövdesi
  • JSON şeması

İstek doğrulama

 

• Doğrulamanın faydaları:
  • Geçersiz arka uç isteklerini azaltır
  • Lambda yürütme maliyetini düşürür
  • API güvenilirliğini artırır

Dönüşümler

• Arka uç koduna dokunmadan istek ve yanıtları yeniden şekillendir
  • Yük yapısını değiştir
  • Alanları yeniden adlandır
  • Başlıkları dönüştür
  • Veri biçimlerini çevir
  • Uygulama ayrıntılarını gizle
• VTL eşleme şablonlarıyla çalışır

 

Hatalarla başa çıkma

 

• İki hata kategorisi
  • Ağ geçidi hataları: API Gateway tarafından üretilir
  • Tümleştirme hataları: arka uç arızaları
• Yaygın ağ geçidi hataları:
  • 400 Bad Request: istek doğrulaması başarısız
  • 429 Too Many Requests: sınır aşıldı (throttling)

Hatalarla başa çıkma

 

• Yaygın tümleştirme hataları:
  • 502 Bad Gateway: bozuk veya hatalı yanıt
  • 503 Service Unavailable: arka uç yok veya aşırı yükte
  • 504 Gateway Timeout: 29 saniyelik zaman aşımı aşıldı
  • Bölgesel ve Özel REST API'leri 29 saniyeyi aşabilir

Günlükleme

• Yürütme günlükleri ve CloudWatch metrikleri temel hata ayıklama araçlarıdır
• API Gateway, CloudWatch ile şunlar için tümleşir:
  • Günlükler
  • Metrikler
  • Yürütme izleme

 

 

Günlükleme

• CloudWatch günlükleri şunlarda sorun gidermeye yardım eder:
  • Başarısız tümleştirmeler
  • Dönüşüm hataları
  • Yetkilendirme hataları
  • Lambda yürütme sorunları

 

 

Aşamalar: API'leri ortamlar arasında yönetme

 

• Tek bir API tanımı birden çok ortamı destekler
• API Gateway bu ortamları aşamalarla yönetir

Aşamalar: API'leri ortamlar arasında yönetme

 

• Tek bir API tanımı birden çok ortamı destekler
• API Gateway bu ortamları aşamalarla yönetir
• Aşama, adlandırılmış bir başvurudur
• API yapılandırmanın bir dağıtım anlık görüntüsünü işaret eder

Aşamalar: API'leri ortamlar arasında yönetme

 

• Tek bir API tanımı birden çok ortamı destekler
• API Gateway bu ortamları aşamalarla yönetir
• Aşama, adlandırılmış bir başvurudur
• API yapılandırmanın bir dağıtım anlık görüntüsünü işaret eder
• Yaygın aşama adları:
  • Dev
  • Test
  • QA ve Prod

Aşamalar: API'leri ortamlar arasında yönetme

 

• Tek bir API tanımı birden çok ortamı destekler
• API Gateway bu ortamları aşamalarla yönetir
• Aşama, adlandırılmış bir başvurudur
• API yapılandırmanın bir dağıtım anlık görüntüsünü işaret eder
• Yaygın aşama adları: Dev, Test, QA, Prod
• Her aşamaya çağırma URL'si yansır

Aşamalar: API'leri ortamlar arasında yönetme

 

• Tek bir API tanımı birden çok ortamı destekler
• API Gateway bu ortamları aşamalarla yönetir
• Aşama, adlandırılmış bir başvurudur
• API yapılandırmanın bir dağıtım anlık görüntüsünü işaret eder
• Yaygın aşama adları: Dev, Test, QA, Prod
• Her aşamaya çağırma URL'si yansır
• Birden çok aşama, anında geri alma için tek bir dağıtıma işaret edebilir

Aşamalar: API'leri ortamlar arasında yönetme

 

• Değişiklikler yalnızca bir aşamaya dağıtılınca canlı olur

Aşama yetenekleri

• Her aşama bağımsız yapılandırılır
• Yapılandırma, aşama değişkenlerini içerir
• Aşama değişkenleri anahtar-değer çiftleridir
• Tek bir dağıtımı farklı arka uçlara yönlendir
• Ortam değişiklikleri için yeniden dağıtım gerekmez

 

Aşama yetenekleri

• Kanarya dağıtımları
  • Yalnızca REST API'ler
  • Trafiğin bir yüzdesini yeni dağıtıma gönder
  • Tam sürüme yükselt
  • Geri almak için kanaryayı sil

 

Aşama yetenekleri

• Kısıtlama (throttling)
  • Aşama düzeyinde ayarlanır
  • Tüm yöntemler için geçerlidir; yöntem bazında geçersiz kılınabilir

 

Aşama yetenekleri

• Kısıtlama (throttling)
  • Aşama düzeyinde ayarlanır
  • Tüm yöntemler için geçerlidir; yöntem bazında geçersiz kılınabilir
• Önbellekleme
  • Yalnızca REST API'ler
  • Arka uç yanıtlarını aşamada saklar
  • İstemciler Cache-Control ile atlayabilir
  • TTL 0–3600 saniye, varsayılan 300

 

Aşama yetenekleri

• Günlüklemede iki kip vardır
  • Erişim günlükleri
  • $context değişkenlerinden oluşturulur, bir CloudWatch günlük grubuna gönderilir
  • Yürütme günlükleri
  • Tam istek ve yanıt ayrıntısını yakalar

 

Hadi pratik yapalım!

AWS üzerinde Uygulama Geliştirme