Yönetici Özeti ve Mimari Önem

Vercel'in en son platform genişlemesi, yönlendirme ara katmanı mimarisi için yerel Python desteği sunarak Python tabanlı web uygulamalarının uç (edge) düzeyindeki trafik manipülasyonunu ele alma biçiminde önemli bir evrime işaret ediyor. Tarihsel olarak, sunucusuz veya uç altyapılarda FastAPI, Flask ve Django gibi Python çatılarını (framework) kullanan geliştiriciler, birincil uygulama çalışma zamanına ulaşmadan önce düşük gecikmeli yönlendirme mantığı, URL yeniden yazma ve koşullu yeniden yönlendirmeleri yürütme yetenekleri açısından kısıtlanmıştı. Bu sürüm, geliştiricilerin tamamen Python ile yazılmış standart ASGI ve WSGI arayüzlerini kullanarak gelen HTTP isteklerini doğrudan uç noktada engellemesine olanak tanıyarak bu mimari boşluğu kapatıyor.

Sistem tasarımı perspektifinden bakıldığında; yönlendirme mantığını, kimlik doğrulama kontrollerini, coğrafi yerelleştirmeyi ve yol yeniden yazmalarını uca yakın bir Python katmanına devretmek, kaynak kullanımını büyük ölçüde optimize eder. Çekirdek monolitik dağıtım içinde ağır uygulama çalışma zamanları veya yönlendirme tabloları başlatmak yerine, hafif vekil (proxy) fonksiyonları anında yürütülür. Bu ayrıştırma, modern bulut yerel mimarilerinin trafik yönetimini iş mantığından izole etmesini sağlayarak, yetkisiz veya hatalı biçimlendirilmiş isteklerin önemli arka uç hesaplama döngülerini tüketmeden önce işlenmesini veya yeniden yönlendirilmesini garanti eder. Sonuç olarak mühendislik ekipleri, Python ekosistemine özgü geliştirici ergonomisinden ödün vermeden istek yaşam döngüleri üzerinde ayrıntılı kontrol elde eder.

Temel Geliştirmeler ve Geliştirici Ergonomisi

Bu sürümün ana sütunu, Python çalışma zamanı yürütülmesinin doğrudan Vercel'in yönlendirme ara katmanı işlem hattına entegre edilmesidir. Geliştiriciler artık popüler asenkron ve senkron Python çatılarıyla sorunsuz bir şekilde arayüz oluşturan ara katman modülleri yazabilirler. Mimari, bu betikleri birincil uygulamanın yukarısında çalıştırarak ara katmanın istekleri engellemesine, belirleyici yol eşleştirmesi gerçekleştirmesine, HTTP yeniden yönlendirmeleri yayınlamasına veya doğrudan yanıtlar döndürerek uygulamayı tamamen atlamasına olanak tanır. Bu yetenek; A/B testi, bot tespiti ve uluslararasılaştırma yönlendirmesi gibi operasyonları basitleştirerek orijinal sunucuya yapılan gereksiz gidiş-dönüşleri azaltır.

Standart Python bağımlılık yönetim paradigmaları ve Vercel'in mevcut yapılandırma şemasıyla entegrasyon sayesinde geliştirici ergonomisi titizlikle ele alınmıştır. Belirlenen bir proxy giriş noktasını eşlemek için vercel.toml dosyasından yararlanarak geliştiriciler, özel yönlendirme mantığını dağıtım işlem hatlarına kolayca bağlayabilirler. Dahası, özel vercel-proxy PyPI paketinin sunulması; kullanıma hazır olarak yola dayalı yönlendirmeyi yerel olarak destekleyen Proxy uygulaması gibi özel araçlar sağlar. Eşleşmeyen yollar, temel uygulamaya şeffaf bir şekilde aktarılarak mevcut projeler için kesintisiz, aşamalı bir geliştirme iş akışı sağlanır.

Mimari Karşılaştırma Matrisi

Uyum Uyarısı Yaratan Değişiklikler ve Geçiş Uyarıları

Bu sürüm, mevcut JavaScript ve TypeScript yönlendirme ara katmanı uygulamalarıyla tamamen geriye dönük olarak uyumludur; yani eski dağıtımlar hiçbir kesinti yaşamayacaktır. Bununla birlikte, Python yönlendirme ara katmanının benimsenmesi, mühendislik ekiplerinin uyum sağlaması gereken belirli yapısal kısıtlamalar getirir. Özellikle ara katman, ana uygulama kod tabanından tamamen izole edilmiş olarak çalışır ve yalnızca pyproject.toml dosyanızdaki proxy bağımlılık grubu içinde açıkça bildirilen bağımlılıklara özel erişime sahiptir.

Ara katman katmanında döngüsel içe aktarmaları (circular imports) veya ağır kütüphane eklemelerini önlemek için geliştiriciler kod tabanlarını dikkatli bir şekilde bölmelidir. Çekirdek uygulama modüllerinin vekil betiğine aktarılması, uç dağıtım paketini şişirecek ve yürütme performansını düşürecektir. Ek olarak, ara katman standart bir ASGI veya WSGI uygulaması olarak çalıştığından, yerel bellek içi durumlar dağıtılmış uç çağrılarda güvenilir bir şekilde kalıcı olmayacağından durum yönetimi (state management) durumsuz (stateless) kalmalı veya harici dağıtık önbelleklere güvenmelidir.

Adım Adım Yükseltme Kılavuzu

Vercel projenize Python yönlendirme ara katmanı geçirmek veya eklemek, proje manifestonuzu yapılandırmayı ve bir giriş noktası betiği dağıtmayı içerir. Ortamınızı ayarlamak için şu adımları izleyin:

1. pyproject.toml İçinde Bağımlılıkları Yapılandırın Optimal paket boyutlandırması sağlamak için ara katman bağımlılıklarınızı özel bir proxy grubunda izole edin:

   [project]
   name = "my-vercel-project"
   version = "0.1.0"
   dependencies = ["fastapi>=0.100.0"]
   
   [dependency-groups]
   proxy = ["vercel-proxy>=0.1.0"]
   

2. Vekil Giriş Noktasını Uygulayın Yola dayalı yönlendirmeyi yönetmek için vercel-proxy aracını kullanarak yönlendirme ara katmanı betiğinizi (ör. vercel/proxy.py) oluşturun:

   from vercel_proxy import Proxy
   
   app = Proxy()
   
   @app.route("/legacy-path")
   def redirect_handler(request):
       return request.redirect("/new-path", status_code=301)
   

3. vercel.toml Dosyasını Güncelleyin Proje yapılandırmanızın vekil giriş noktasını yeni oluşturulan Python modülüne yönlendirin:

   {
     "proxy": "vercel/proxy.py"
   }