نظرة عامة تنفيذيّة والأهميّة المعماريّة

يقدم التحديث الأخير لمنصة Vercel دعماً أصلياً للغة بايثون في بنية وسيط التوجيه (routing middleware)، مما يمثل تطوراً كبيراً في كيفية التعامل مع معالجة حركة المرور على مستوى الحافة (edge) لتطبيقات الويب القائمة على بايثون. تاريخياً، كان المطورون الذين يستخدمون أطر عمل بايثون مثل FastAPI وFlask وDjango على البنى التحتية بدون سرور أو الحافة مقيدين في قدرتهم على تنفيذ منطق توجيه منخفض الكمون، وإعادة كتابة عناوين URL، والتوجيه الشرطي قبل الوصول إلى بيئة تشغيل التطبيق الأساسية. يعمل هذا الإصدار على سد هذه الفجوة المعماريّة من خلال تمكين المطورين من اعتراض طلبات HTTP الواردة مباشرة عند الحافة باستخدام واجهات ASGI وWSGI القياسية المكتوبة بالكامل بلغة بايثون.

من منظور تصميم الأنظمة، فإن تفريغ منطق التوجيه، وفحص المصادقة، والتوطين الجغرافي، وإعادة كتابة المسارات إلى طبقة بايثون مجاورّة للحافة يعمل على تحسين استخدام الموارد بشكل جذري. فبدلاً من تشغيل بيئات تشغيل ثقيلة للتطبيقات أو جداول التوجيه داخل نشر متجانس رئيسي، تعمل وظائف الوكيل خفيفة الوزن بشكل فوري. يتيح هذا الفصل للبنى الحديثة السحابية الأصلية عزل إدارة حركة المرور عن منطق الأعمال، مما يضمن معالجة الطلبات غير المصرح بها أو المشوهة أو إعادة توجيهها قبل استهلاك دورات حوسبة خلفية كبيرة. ونتيجة لذلك، تحصل الفرق الهندسية على تحكم دقيق في دورات حياة الطلب دون التضحية بسهولة الاستخدام الخاصة بالمطورين والمضمنة في النظام البيئي لبايثون.

التحسينات الأساسية وسهولة استخدام المطورين

الركيزة الأساسية لهذا الإصدار هي دمج تشغيل بيئة بايثون مباشرة في خط أنابيب وسيط التوجيه في Vercel. يمكن للمطورين الآن كتابة وحدات وسيطة تتفاعل بسلاسة مع أطر عمل بايثون الشائعة المتزامنة وغير المتزامنة. تنفذ البنية هذه النصوص البرمجية قبل التطبيق الأساسي، مما يسمح للوسيط باعتراض الطلبات، أو إجراء مطابقة حتمية للمسارات، أو إصدار عمليات إعادة توجيه HTTP، أو تجاوز التطبيق بالكامل عن طريق إرجاع استجابات مباشرة. تعمل هذه الميزة على تبسيط العمليات مثل اختبار A/B، واكتشاف الروبوتات، وتوجيه التدويل، مما يقلل من رحلات الذهاب والإياب غير الضرورية إلى الخادم الأصلي.

تم التعامل بدقة مع سهولة استخدام المطورين من خلال التكيف مع نماذج إدارة تبعيات بايثون القياسية ومخطط تكوين Vercel الحالي. من خلال الاستفادة من ملف vercel.toml لتعيين نقطة دخول مخصصة لـ proxy، يمكن للمطورين بسهولة دمج منطق التوجيه المخصص في خطوط أنابيب النشر الخاصة بهم. علاوة على ذلك، توفر حزمة PyPI المخصصة vercel-proxy أدوات مساعدة متخصصة -مثل تطبيق Proxy- والتي تدعم بشكل أصلي التوجيه المستند إلى المسار خارج الصندوق. تمر المسارات غير المتطابقة بسلاسة إلى التطبيق الأساسي، مما يضمن سير عمل تحسين تدريجي وغير مكسر للمشاريع الحالية.

مصفوفة المقارنة المعمارية

التغييرات الجذرية وتنبيهات الهجرة

هذا الإصدار متوافق تمامًا مع الإصدارات السابقة مع تطبيقات وسيط التوجيه الحالية بلغتي جافا سكريبت وتايبسكريبت، مما يعني أن عمليات النشر القديمة لن تتعرض لأي تعطيل. ومع ذلك، فإن اعتماد وسيط توجيه بايثون يفرض قيوداً هيكلية محددة يجب على الفرق الهندسية استيعابها. والأهم من ذلك أن الوسيط يعمل بمعزل تام عن قاعدة بيانات التطبيق الرئيسي، حيث يمتلك حق الوصول حصرياً إلى التبعيات المعلنة صراحةً ضمن مجموعة تبعيات proxy في ملف pyproject.toml الخاص بك.

يجب على المطورين تقسيم قاعدة بياناتهم بعناية لمنع الاستيرادات الدائرية أو تضمين المكتبات الثقيلة داخل طبقة الوسيط. سيؤدي استيراد وحدات التطبيق الأساسية إلى نص الوكيل البرمجي إلى تضخم حزمة نشر الحافة وتقليل أداء التنفيذ. علاوة على ذلك، ونظراً لأن الوسيط يتم تنفيذه كـتطبيق ASGI أو WSGI قياسي، يجب أن تظل إدارة الحالة بلا حالة (stateless) أو تعتمد على ذاكرات تخزين مؤقت خارجية موزعة، حيث لن تستمر حالات الذاكرة المحلية بشكل موثوق عبر استدعاءات الحافة الموزعة.

دليل الترقية خطوة بخطوة

تتضمن ترقية أو إضافة وسيط توجيه بايثون إلى مشروع Vercel الخاص بك تكوين بيان المشروع الخاص بك ونشر نص نقطة الدخول. اتبع هذه الخطوات لإعداد بيئتك:

1. تكوين التبعيات في pyproject.toml اعزل تبعيات الوسيط الخاصة بك في مجموعة proxy مخصصة لضمان الحجم الأمثل للحزمة:

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

2. تنفيذ نقطة دخول الوكيل أنشئ نص وسيط التوجيه الخاص بك (على سبيل المثال، vercel/proxy.py) باستخدام أداة vercel-proxy لإدارة التوجيه المستند إلى المسار:

   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 وجه نقطة دخول الوكيل لتكوين مشروعك إلى وحدة بايثون التي تم إنشاؤها حديثاً:

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