1. Yönetici Özeti ve Mimari Önem
Vercel, FastAPI, Django ve Flask gibi Python tabanlı arka uç çerçeveleri ile sağlam Edge Network yetenekleri arasındaki boşluğu temelden kapatarak Python uygulamaları için kapsamlı proje düzeyinde yönlendirme desteğini resmi olarak kullanıma sundu. Geçmişte, Vercel'deki sunucusuz veya konteynerli ortamlara dağıtılan Python iş yükleri, uygulama düzeyindeki yönlendirme yapılandırmalarına veya vercel.json aracılığıyla doğrudan dağıtım yapılarına gömülü statik tanımlara büyük ölçüde güveniyordu. İşlevsel olmakla birlikte, bu geleneksel yaklaşım, bir yol yeniden yazma (path rewrite) yürütme veya belirli yanıt üstbilgileri (response headers) enjekte etme gibi herhangi bir yönlendirme değişikliğinin, alttaki uygulamanın tamamen yeniden oluşturulmasını ve yeniden dağıtılmasını gerektirdiği anlamına geliyordu.
Bu sürüme sahip Vercel, Python uygulama kodunuzun yukarı akışında çalışan, CDN tarafından değerlendirilen yönlendirme kurallarını sunar. Bu yürütme kancalarını doğrudan Vercel CDN katmanına kaydırarak, gelen istekler sunucusuz işlev yürütme katmanına asla ulaşmadan önce küresel olarak kesintiye uğratılır, analiz edilir ve manipüle edilir. Yönlendirme kaygılarının uygulama kodundan bu şekilde ayrılması, sunucusuz kaynak tüketimini temelden optimize eder. İşlem örnekleri artık yalnızca yol yeniden yönlendirmesini veya üstbilgi enjeksiyonunu işlemek için ayağa kaldırılmaz; bu da daha hızlı İlk Bayt Süresi (TTFB) metrikleri ve küresel olarak dağıtılan Python dağıtımları için büyük ölçüde azaltılmış soğuk başlatma cezaları ile sonuçlanır. Dahası, kurallar dağıtım ikililerinden ayrı tutulduğundan, güncellemeler alttaki uygulama yaşam döngüsünü değiştirmeden tüm uç bölgelerde anında küresel olarak yayılır.
2. Temel Geliştirmeler ve Geliştirici Ergonomisi
Bu sürümün mimari odak noktası, yayınlandığı anda anında yürütülen, uçta değerlendirilen yönlendirme kurallarının sunulmasıdır. Geliştiriciler artık birden çok entegre arayüz aracılığıyla yanıt üstbilgilerini manipüle edebilir ve dahili yolları hedefleyen istek yeniden yazmalarını düzenleyebilir (örneğin, /old yolunu doğrudan FastAPI tarafından sunulan /new gibi bir yola yönlendirme). Bu çoklu yüzeyli kontrol düzlemi; kontrol paneli aracılığıyla görsel iş akışlarına, Vercel CLI aracılığıyla terminal odaklı işlemlere, Python SDK (vercel) aracılığıyla programatik otomasyona ve REST API veya vercel.json aracılığıyla altyapı olarak kod tanımlarına hitap eden benzeri görülmemiş bir esneklik sağlar.
Özel bir Python SDK sarmalayıcısının (vercel) dahil edilmesi, Python geliştiricileri için öne çıkan ergonomik bir kazançtır. Vercel REST API'sini add_route ve update_route_version gibi deyimsel Python yöntemlerinde soyutlayarak, ekipler CDN yönlendirme kurallarını CI/CD boru hatlarına, test paketlerine veya dinamik arka uç yönetim panellerine yerel olarak entegre edebilir. SDK veya CLI aracılığıyla hazırlanan kurallar, hızlı ve sıfır kesintili geri alma işlemleri için kontrol panelinin Geçmiş (History) sekmesi aracılığıyla erişilebilen sağlam bir sürüm geçmişini korurken, yayınlandığı anda tüm küresel uç düğümlerde geçerli olur.
3. Mimari Karşılaştırma Matrisi
| Yetenek / Metrik | Önceki Temel Çizgi (vercel.json ve Uygulama Düzeyinde Yönlendirme) |
Yeni Mimari (python-projects-now-support-rout) |
|---|---|---|
| Uç Gecikmesi | Daha yüksek; istekler uygulama mantığına veya dağıtımlara bağlı vercel.json yapılandırmalarına çarpar. |
Minimum; kurallar işlem örneklerine ulaşmadan önce Vercel CDN katmanında yürütülür. |
| Bellek ve İşlem Ek Yükü | Sunucusuz işlevler, yönlendirmeleri değerlendirmek veya üstbilgileri enjekte etmek için ayağa kalkmalıdır. | Kesilen kurallar için sıfır işlem ek yükü; işlevler tamamen atlanır. |
| Kontrol API'leri | Temel olarak dosya tabanlı düzenlemeler ve dağıtım tetikleyicileri ile sınırlıdır. | Kontrol Paneli Arayüzü, Vercel CLI, Python SDK (vercel) ve REST API. |
| Dağıtım Bağımlılığı | Yönlendirme davranışını güncellemek için tam bir kod dağıtımı gerekiyordu. | Dağıtımlardan bağımsız; yayınlanan kurallar anında geçerli olur. |
4. Önemli Değişiklikler ve Geçiş Uyarıları
Bu sürüm, önceki sürümlerle tamamen geriye dönük olarak uyumludur. Mevcut vercel.json yönlendirme yapılandırmaları, herhangi bir değişiklik gerekmeden sorunsuz bir şekilde çalışmaya devam edecektir. Bununla birlikte, geliştiriciler proje düzeyindeki yönlendirme kurallarının getirdiği operasyonel önceliği anlamalıdır. Proje düzeyindeki kurallar tamamen dağıtım yapıtlarınızın dışında bulunur ve kesinlikle dağıtım düzeyindeki yollardan önce değerlendirilir. Sonuç olarak, yayınlanan proje düzeyinde bir kural, tam olarak aynı yol için yapılandırılmış bir vercel.json yeniden yazma kuralına göre sistematik olarak öncelik kazanacaktır. Eski yönlendirme mantığını yeni CDN katmanına taşıyan ekipler, istenmeyen yönlendirme çakışmalarını önlemek için mevcut vercel.json dosyalarını denetlemelidir.
5. Adım Adım Yükseltme Kılavuzu
İş akışınızı Python projeleri için CDN düzeyinde yönlendirmeden yararlanacak şekilde yükseltmek, araçlarınızı güncellemenizi ve kurallarınızı tercih ettiğiniz arayüz aracılığıyla tanımlamanızı gerektirir. İlk uçta değerlendirilen yeniden yazma işleminizi uygulamak için şu adımları izleyin:
Vercel CLI'yi Güncelleyin: En yeni yönlendirme komut setlerine erişmek için CLI'nin en son sürümünü çalıştırdığınızdan emin olun.
npm i -g vercel@latestPython SDK'yı Yükleyin veya Güncelleyin: Yönlendirmeyi Python aracılığıyla programatik olarak yönetmeyi planlıyorsanız, resmi paketi yükleyin.
pip install --upgrade vercelKuralları Programatik Olarak Dağıtın (İsteğe Bağlı): Eski bir yolu yeni bir FastAPI/Flask uç noktasına eşleyen bir kuralı hazırlamak ve yayınlamak için otomasyon betikleriniz içinde Python SDK'yı kullanın.
import vercel # /old yolunu /new yoluna yönlendiren bir yönlendirme kuralı hazırlayın vercel.add_route(path="/old", destination="/new", type="rewrite") # Güncellenen kural sürümünü küresel olarak yayınlayın vercel.update_route_version()