شحن موقع بناه وكيل إلى الإنتاج بلا مفاجآت

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

حدّد مُطلِق النشر قبل أول commit

هناك ترتيبان سليمان وثالث سيّئ. السليمان: دفعٌ إلى الفرع الرئيسي ينشر إلى الإنتاج، أو دفعٌ ينشر إلى معاينة مع ترقية يدوية. والسيّئ: وكيل يشغّل أمر النشر مباشرة، فيصبح ما يحدّد ما هو حيّ جملةً في نافذة محادثة لا commit يمكنك الإشارة إليه. اربط المستودع بالمضيف، كما يشرح توثيق النشر في Vercel ودليل النشر في Next.js، واجعل git هو المُطلِق.

هذا يمنحك أيضاً الأثر الذي يُمكّن كل ما يلي. فلكل نشرة commit، ولكل commit diff، وحين يتعطّل شيء في الرابعة عصراً تقرأ ما تغيّر بدلاً من إعادة بناء محادثة.

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

تحقّق منه في الصفحة المنشورة لا في الملف. اجلب HTML لرابط إنتاجي واقرأ وسوم canonical وOpen Graph التي عادت فعلاً. وبينما أنت هناك، تحقّق من مسار فرعي لا من الصفحة الرئيسية: فالميتاداتا تندمج من الأصل بطرق تحتفظ بصمت برابط الأصل، وهذا هو الفخّ الذي كُتب عنه هذا المقال عن وراثة الميتاداتا. ومرجع الميتاداتا في الفريمورك يوثّق سلوك الدمج.

ما يمسكه البناء وما لن يمسكه أبداً

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

تستحق الأخيرة جملة خاصة، لأنها تعضّ المواقع المبنيّة ساكنةً تحديداً. فإن كان محتواك يحمل تواريخ نشر وتقارنها بالوقت الحالي، فالمقارنة تجري وقت البناء على سيرفر ساعته بتوقيت UTC. والمقال المؤرّخ اليوم يُنشر أو لا يُنشر تبعاً لمنطقة زمنية لم تفكّر فيها أبداً. ونحن نقارن بـUTC عن قصد لهذا السبب بالضبط.

الصور: الكاش يعيش أطول من جلستك

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

قاعدتان تُغلقانه. غيّر اسم الملف حين تغيّر الصورة، وفرّغ كاش الصور المحلّي قبل أن تحكم على استبدال. لا ذكاء في أيٍّ منهما، وكلتاهما الفرق بين إصلاح في عشر ثوان وبين أصيل يوم.

نشرة المعاينة هي المراجعة

لقطة من سيرفر تطوير محلّي دليل ضعيف. أُخذت قبل استقرار الخطوط، أو في مُعالِج عرض لا يركّب كما يركّب المتصفّح، أو عند عرضٍ لا يستخدمه أحد. أما نشرة المعاينة فهي الشيء الحقيقي على رابط حقيقي، أي يمكنك جلب HTML لها، وتشغيل تدقيق صفحة عليها، ورؤيتها في المتصفّح الذي سيستخدمه عميلك.

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

الاستعادة ميزة، فاستخدمها

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

القائمة بالترتيب

لا شيء من هذا غريب، وهذا هو المقصد. نمط فشل المواقع التي بناها وكيل ليس عيوباً متطوّرة، بل كوداً كفؤاً نُشر في بيئة لم يفحصها أحد، وستّة فحوص روتينية تُغلق معظمه. وإن أردت البوابات مؤتمتة لا متذكَّرة، فـمقال الـhooks يغطّي ذلك، وقائمة الـSEO تغطّي ما يُتحقّق منه بعد أن يصبح الموقع حيّاً فعلاً. ويمكنك أيضاً رؤية المواقع التي شحنّاها بهذه الطريقة.