إدارة الإصدارات والنشر والتنسيق

تتمثل القيمة الأساسية لـ Module Federation في النشر المستقل: إذ يستطيع الفريق تحديث تطبيقه البعيد واختباره ونشره من دون التنسيق مع فرق المضيف أو تشغيل عمليات إعادة نشر للمضيف. يلتقط المضيف التغييرات تلقائيًا في المرة التالية التي يحمّل فيها remoteEntry.js من عنوان URL الخاص بالتطبيق البعيد.

بدلًا من تقديم remoteEntry.js على عنوان URL ثابت (يتغير مع كل عملية نشر)، أدرجوا تجزئة المحتوى في عنوان URL: remoteEntry.[hash].js. يجعل ذلك كل عملية نشر غير قابلة للتغيير — تستمر عناوين URL القديمة في العمل، ويشير المضيف إلى التجزئة الجديدة بعد تحديثه إلى عملية النشر الجديدة. تتيح عناوين URL غير القابلة للتغيير تخزينًا مؤقتًا قويًا على CDN.

بما أن المضيف يكتشف التطبيقات البعيدة عبر عنوان URL، يمكنكم تنفيذ اختبار A/B على مستوى البنية التحتية: قدّموا عناوين URL مختلفة لملف remoteEntry.js لمستخدمين مختلفين (بحيث تشير إلى إصدارات مختلفة من التطبيق البعيد). يتيح ذلك عمليات نشر canary حقيقية للواجهات الأمامية المصغّرة من دون أي منطق لأعلام الميزات في شيفرة التطبيق.

بدلًا من تضمين عناوين URL للتطبيقات البعيدة في إعداد Webpack مباشرةً، يجلب المضيف بيان JSON عند بدء التشغيل: GET /federation-manifest.json returns { buttonApp: 'https://cdn.example.com/button/remoteEntry.abc123.js' }. لتحديث الإصدار الذي يستخدمه المضيف، حدّثوا البيان — ولا حاجة إلى إعادة بناء المضيف.

عندما يتسبب نشر تطبيق بعيد في حدوث تراجع، يكون التراجع فوريًا: حدّثوا federation-manifest.json ليشير إلى عنوان URL السابق لـ remoteEntry.js. يبدأ المضيف فورًا باستخدام الإصدار القديم في دورة الطلب التالية. لا حاجة إلى إعادة بناء المضيف أو التراجع عنه أو إلى التنسيق بين الفرق.

يضيف Module Federation 2.0، أي الحزمة @module-federation/enhanced، تحسينات مهمة: دعمًا أفضل لـ TypeScript مع توليد تلقائي للأنواع من manifests الوحدات البعيدة، وواجهة API لإضافات وقت التشغيل تتيح منطق تحميل مخصصًا، وإدارة محسّنة لنطاق المشاركة لسيناريوهات التفاوض المعقدة حول الإصدارات.

تضيف حزمة vite-plugin-federation إمكانات Module Federation إلى المشاريع المبنية على Vite، باستخدام واجهة إعداد مشابهة لواجهة Webpack's ModuleFederationPlugin. وهي متوافقة مع الوحدات البعيدة في Vite والتطبيقات المضيفة في Webpack، والعكس صحيح، ما يتيح للفرق الانتقال إلى Vite تدريجيًا من دون التخلي عن Module Federation.

بالنسبة إلى البنى شديدة الديناميكية، يمكنكم ضبط عناوين URL للوحدات البعيدة بالكامل أثناء التشغيل: import(remoteRegistry[featureName])، حيث تتم تعبئة remoteRegistry عبر استدعاء API. يتيح ذلك إنشاء بنى تشبه الإضافات، بحيث يمكن إضافة واجهات أمامية مصغّرة جديدة من دون إعادة بناء تطبيق shell.

تتمثل المهمة الأساسية لتطبيق shell في التنسيق: فهو يقرأ manifest الخاص بالوحدة البعيدة، ويهيئ runtime الخاص بـ Module Federation، ويسجل الوحدات البعيدة ضمن مسارات مسماة، ويعرض الوحدة البعيدة المناسبة استنادًا إلى عنوان URL الحالي. صُمم shell ليكون رقيقًا عمدًا — فهو يعرف ما يجب تحميله، لا كيفية عرضه.

أضيفوا مراقبة الأداء إلى تحميل الوحدات البعيدة: غلّفوا عمليات استيراد الوحدات البعيدة داخل try/catch للتعامل مع إخفاقات التحميل بسلاسة، واعرضوا واجهة بديلة إذا كانت الوحدة البعيدة غير متاحة، وقيسوا الزمن اللازم لتنزيل remoteEntry.js وأجزاء المكوّنات، وأطلقوا تنبيهًا إذا تجاوز زمن تحميل الوحدة البعيدة حدًا معينًا، ما يشير إلى مشكلات في CDN.

يبدو مسار CI/CD الناضج في Module Federation على النحو الآتي: يرسل فريق الوحدة البعيدة commit → تنشئ CI عملية بناء للوحدة البعيدة → ترفع remoteEntry.[hash].js غير القابل للتغيير إلى CDN → تحدّث federation-manifest.json → يلتقط التطبيق المضيف الوحدة البعيدة الجديدة عند طلب المستخدم التالي. تتم أتمتة كل خطوة، ولا يشارك فريق التطبيق المضيف مطلقًا في عمليات نشر الوحدات البعيدة.

ما أسرع طريقة للتراجع عن عملية نشر سيئة لوحدة بعيدة في Module Federation؟

يتيح Module Federation النشر المستقل الحقيقي: إذ تنشر الوحدات البعيدة تحديثاتها من دون إعادة بناء التطبيق المضيف، ويكتشف التطبيق المضيف الإصدارات الجديدة تلقائيًا. استخدموا عناوين URL للوحدات البعيدة التي تتضمن تجزئة المحتوى للاستفادة من التخزين المؤقت غير القابل للتغيير على CDN، وmanifest ديناميكيًا لتوجيه الإصدارات بمرونة وإجراء عمليات تراجع فورية. تنقل vite-plugin-federation هذه الإمكانات إلى Vite، كما تتيح عمليات الاستيراد الديناميكية للوحدات البعيدة إنشاء بنى تشبه الإضافات. وينسق shell عملية تحميل الوحدات البعيدة، مع الحفاظ على بساطته عمدًا.