۱. نمای کلی اجرایی و اهمیت معماری
vercel رسماً پشتیبانی جامع از مسیریابی در سطح پروژه را برای برنامه‌های پایتون ارائه کرده است که به‌طور اساسی شکاف بین قابلیت‌های قدرتمند شبکه لبه (Edge Network) خود و فریم‌ورک‌های بک‌اند مبتنی بر پایتون مانند FastAPI، Django و Flask را پر می‌کند. از لحاظ تاریخی، بارهای کاری پایتون که روی محیط‌های بدون سرور (Serverless) یا کانتینری‌شده در ورسل مستقر می‌شدند، به شدت به پیکربندی‌های مسیریابی در سطح برنامه یا تعاریف استاتیک جاسازی‌شده مستقیماً در آرتیفکت‌های استقرار از طریق vercel.json متکی بودند. در حالی که این رویکرد سنتی کاربردی بود، اما به این معنا بود که هرگونه تغییر در مسیریابی — مانند اجرای بازنویسی مسیر (path rewrite) یا تزریق هدرهای پاسخ خاص — مستلزم ساخت کامل و استقرار مجدد برنامه‌ی زیربنایی بود.
با این انتشار، ورسل قوانین مسیریابی ارزیابی‌شده در سطح CDN را معرفی می‌کند که بالاتر از کد برنامه‌ی پایتون شما عمل می‌کنند. با انتقال مستقیم این هوک‌های اجرایی به لایه CDN ورسل، درخواست‌های ورودی پیش از رسیدن به لایه اجرای تابع بدون سرور، رهگیری، تحلیل و در سطح جهانی دستکاری می‌شوند. این جداسازی دغدغه‌های مسیریابی از کد برنامه، مصرف منابع بدون سرور را به‌طور اساسی بهینه‌سازی می‌کند. نمونه‌های پردازشی دیگر صرفاً برای مدیریت تغییر مسیر یا تزریق هدر راه‌اندازی نمی‌شوند که این امر منجر به بهبود معیارهای زمان تا اولین بایت (TTFB) و کاهش چشمگیر جریمه‌های شروع سرد (cold-start) برای دپلوئمونت‌های پایتون توزیع‌شده در سطح جهانی می‌شود. علاوه بر این، از آنجا که قوانین از باینری‌های استقرار جدا شده‌اند، به‌روزرسانی‌ها فوراً در تمام مناطق لبه در سراسر جهان بدون تغییر چرخه حیات برنامه‌ی زیربنایی منتشر می‌شوند.
۲. بهبودهای هسته و ارگونومی توسعه‌دهنده
محور معماری این انتشار، معرفی قوانین مسیریابی ارزیابی‌شده در لبه است که بلافاصله پس از انتشار اجرا می‌شوند. توسعه‌دهندگان اکنون می‌توانند هدرهای پاسخ را دستکاری کرده و بازنویسی درخواست‌ها را به مقصد مسیرهای داخلی (مانند هدایت /old مستقیماً به یک مسیر سرویس‌دهی شده توسط FastAPI مانند /new) از طریق چندین رابط یکپارچه مدیریت کنند. این کنترل‌پین چندرابطی انعطاف‌پذیری بی‌سابقه‌ای را فراهم می‌کند و از جریان‌های کاری بصری از طریق داشبورد، عملیات مبتنی بر ترمینال از طریق CLI ورسل، اتوماسیون برنامه‌نویسی از طریق SDK پایتون (vercel) و تعاریف زیرساخت به عنوان کد از طریق REST API یا vercel.json پشتیبانی می‌کند.
گنجاندن یک کپسوله‌ساز اختصاصی SDK پایتون (vercel) یک پیروزی ارگونومیک برجسته برای توسعه‌دهندگان پایتون است. با انتزاع API REST ورسل به متدهای ایدوماتیک پایتون مانند add_route و update_route_version، تیم‌ها می‌توانند قوانین مسیریابی CDN را به‌طور بومی در پایپ‌لاین‌های CI/CD، مجموعه‌های تست یا پنل‌های مدیریتی پویای بک‌اند خود ادغام کنند. قوانینی که از طریق SDK یا CLI مرحله‌بندی می‌شوند، هنگام انتشار در تمام گره‌های لبه جهانی اعمال می‌شوند، در حالی که تاریخچه نسخه قوی قابل دسترسی از طریق تب History داشبورد را برای بازگردانی سریع و بدون خرابی (zero-downtime rollbacks) حفظ می‌کنند.
۳. ماتریس مقایسه معماری
| قابلیت / معیار | مبنای قبلی (vercel.json و مسیریابی در سطح برنامه) |
معماری جدید (python-projects-now-support-rout) |
|---|---|---|
| تأخیر لبه (Edge Latency) | بالاتر؛ درخواست‌ها به منطق برنامه یا پیکربندی‌های متصل به vercel.json مرتبط با استقرارها برخورد می‌کنند. |
حداقل؛ قوانین در لایه CDN ورسل پیش از رسیدن به نمونه‌های پردازشی اجرا می‌شوند. |
| سربار حافظه و پردازش | توابع بدون سرور باید برای ارزیابی تغییر مسیرها یا تزریق هدرها راه‌اندازی شوند. | سربار پردازشی صفر برای قوانین رهگیری‌شده؛ توابع کاملاً دور زده می‌شوند. |
| APIهای کنترل | عمدتاً محدود به ویرایش‌های مبتنی بر فایل و محرک‌های استقرار. | رابط کاربری داشبورد، CLI ورسل، SDK پایتون (vercel) و REST API. |
| وابستگی استقرار | برای به‌روزرسانی رفتار مسیریابی به یک استقرار کد کامل نیاز داشت. | مستقل از استقرارها؛ قوانین منتشر شده فوراً اعمال می‌شوند. |
۴. تغییرات ناسازگار و نکات مهم مهاجرت
این نسخه کاملاً با نسخه‌های قبلی سازگار است. پیکربندی‌های مسیریابی موجود در vercel.json بدون نیاز به تغییر به کار خود ادامه خواهند داد. با این حال، توسعه‌دهندگان باید اولویت عملیاتی معرفی‌شده توسط قوانین مسیریابی در سطح پروژه را درک کنند. قوانین در سطح پروژه کاملاً خارج از آرتیفکت‌های استقرار شما زندگی می‌کنند و به شدت قبل از مسیرهای سطح استقرار ارزیابی می‌شوند. در نتیجه، یک قانون منتشر شده در سطح پروژه به طور سیستماتیک بر یک بازنویسی vercel.json پیکربندی شده دقیقاً برای همان مسیر اولویت خواهد داشت. تیم‌هایی که منطق مسیریابی قدیمی را به لایه CDN جدید منتقل می‌کنند، باید فایل‌های vercel.json موجود خود را ممیزی کنند تا از تداخل‌های ناخواسته مسیریابی جلوگیری کنند.
۵. راهنمای ارتقای گام‌به‌گام
ارتقای جریان کاری خود برای بهره‌برداری از مسیریابی در سطح CDN برای پروژه‌های پایتون مستقیماً نیازمند به‌روزرسانی ابزارها و تعریف قوانین از طریق رابط دلخواه شما است. این مراحل را برای پیاده‌سازی اولین بازنویسی ارزیابی‌شده در لبه دنبال کنید:
به‌روزرسانی CLI ورسل: مطمئن شوید که آخرین نسخه CLI را برای دسترسی به جدیدترین مجموعه‌های دستورات مسیریابی اجرا می‌کنید.
npm i -g vercel@latestنصب یا به‌روزرسانی SDK پایتون: اگر قصد دارید مسیریابی را به صورت برنامه‌نویسی از طریق پایتون مدیریت کنید، بسته رسمی را نصب کنید.
pip install --upgrade vercelاستقرار برنامه‌نویسی قوانین (اختیاری): از SDK پایتون در اسکریپت‌های اتوماسیون خود برای مرحله‌بندی و انتشار نگاشت مسیر از یک مسیر قدیمی به یک نقطه پایانی جدید FastAPI/Flask استفاده کنید.
import vercel # مرحله‌بندی یک قانون مسیریابی که /old را به /new هدایت می‌کند vercel.add_route(path="/old", destination="/new", type="rewrite") # انتشار نسخه به‌روزرسانی شده قانون در سطح جهانی vercel.update_route_version()