
درس مصغّر 27 من 30 · تشغيل موقعك وصيانته
حدّد النسختين
لمن هذا الدرس؟
لمن ينشرون من مستودع ويريدون فحص التعديلات قبل إطلاقها. يستطيع مساعد برمجة وأدوات المستودع والاستضافة تولّي آلية الفروع.
تحتاج المراجعة إلى نقطة بداية وتعديل مقترح معًا.
هدف هذا الدرس
- أنشئ نسخة مراجعة منفصلة.
- قارن المعاينة والموقع الحالي بالمهمة نفسها.
- اربط الموافقة بالنسخة التي راجعتها فعلًا.
شرح ومثال محلول وتدريب
قبل أن تبدأ
تحتاج إلى مستودع GitHub منفصل تملكه مربوط بمشروع Netlify تجريبي، مع تفعيل معاينات طلبات السحب. تستهلك عمليات البناء السحابية رصيد الحساب. توفر الحزمة ملفات البداية والتعديل؛ استخدم موقعًا قابلًا للحذف بدل تعديل إنتاجي حقيقي.
تحقّق من مهارات البداية
هذه مهارات مفيدة وليست دروسًا إلزامية تمنع الدخول. ابدأ هنا إن كنت تتقنها، وإلا افتح التحضير المرتبط. ملفات البداية مرفقة، فلا تحتاج إلى موقع شخصي سابق.
- كيف تنشر موقعك من GitHub
اربط مستودعًا تجريبيًا بالاستضافة.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. انتظار البناء السحابي وإعداد الحساب وقت إضافي. يجب ألا تحتوي المعاينات العامة على بيانات اختبار خاصة أو أسرار إنتاج.
افهم الفكرة
استخدم صفحة البداية المرفقة لنشر P1 في مشروع استضافة تدريبي منفصل. قارنها بمساعدة المساعد بصفحة التعديل المرفقة: تقول P1 “Find contact information”، وتقول P2 “Contact me”. ينبغي أن يصلا إلى قسم Contact نفسه.
احتفظ بعنوان P1 المنشور حاليًا أساسًا للمقارنة. مكان P2 المقترحة فرع مراجعة لم يُدمج ومعاينة منفصلة له؛ وسجل علامات النسخ الظاهرة لتمييز الصفحة التي تختبرها.
مثال عملي
هذا تعديل صغير للصياغة، وليس نظام تواصل جديدًا. ينبغي أن تصبح التسمية المقترحة أوضح مع استمرار عمل وجهة التواصل الحالية.
استخدم تعديل موقع التدريب المرفق. ساعدني في إنشاء فرع مراجعة وطلب سحب منفصلين مع معاينة Netlify، مع إبقاء النسخة التجريبية المنشورة الحالية دون تغيير. اعرض الرابطين وحدّد النسخة قيد المراجعة. لا تدمج أو تنشر نسخة إنتاجية دون موافقتي. ساعدني في اختبار المهمة المعدلة وتسجيل المشكلات المتبقية.ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
أي تعديل ستراجع؟ وكيف ستميّز النسخة الحالية والمقترحة؟
عرض حل نموذجي مشروح
سأقارن “Find contact information” في P1 مع “Contact me” في P2. ينبغي أن يصلا إلى قسم Contact. سأبقي P1 الأساس المنشور، وأتعرف إلى المعاينة غير المدمجة من علامة P2؛ وسأسجل الرابطين.
ما تتضمنه الإجابة السليمة
- يحدد تعديل تسمية التواصل بدقة وما يجب أن يبقى كما هو.
- يميز P1 المنشورة عن P2 المقترحة في المعاينة.
كيف يعمل؟ (اختياري)
عاين تغييرًا قبل نشره
امنح النسخة المقترحة رابط مراجعة خاصًا بينما يظل الإنتاج يعمل.
تتيح المعاينة اختبار ناتج بناء فرع فعلي قبل دمجه في مصدر الإنتاج. قد يبدو ملف محلي جيدًا وتظل فيه مسارات بناء أو إعدادات بيئة خاطئة.
تستخدم هذه الورشة تغييرًا صغيرًا عمدًا: تقول P1 «Find contact information» وتقول P2 «Contact me». ستحدد النسختين وتفحص مهمة التواصل نفسها قبل تقرير الدمج.
مثال محلول
بينما لا يزال طلب السحب غير مدمج، ينبغي أن تعرض المعاينة P2 والموقع العام العادي P1. إذا تغير الاثنان، فافحص أي فرع يُنشر إلى الإنتاج.
تمرين تقني إضافي
لماذا ينبغي أن يتضمن سجل مراجعتك نسختي المعاينة والإنتاج؟
عرض حل نموذجي مشروح
يثبت أن المعاينة تتضمن التغيير المقترح بينما يحتفظ الموقع العام بالنسخة المعتمدة. المعاينة التي تعمل وحدها لا تثبت ذلك الفصل.
- تثبت النسخة قيد المراجعة.
- تؤكد عدم تغيير الإنتاج بالخطأ.

الخطوة 1 · كيف تعاين تغييرات موقعك قبل النشر
أنشئ معاينة للمراجعة
دع المساعد يرشدك إلى خطوات المستودع.
شرح ومثال محلول وتدريب
افهم الفكرة
استخدم المستودع التدريبي المخصص وفعّل معاينات طلبات السحب في حساب الاستضافة. اطلب من المساعد إنشاء فرع مراجعة بتعديل P2 المرفق، ورفع الفرع، وفتح طلب سحب دون دمجه. قد تستهلك عمليات البناء المستضافة هذه رصيد الحساب.
افتح المعاينة الناتجة واقرأ علامة P2 الظاهرة. احفظ رابط المعاينة مع معرّف commit المحدد الذي راجعته من المستودع أو الاستضافة. أي commit لاحق على الفرع نفسه نسخة جديدة يجب فحصها.
مثال عملي
قد يحتوي فرع اسمه improve-contact-label على عدة commits مختلفة بمرور الوقت. لا تشمل الموافقة على معاينته الأولى الـcommit التالية تلقائيًا.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
أي معاينة فتحت؟ وما النسخة التي تحتويها؟
عرض حل نموذجي مشروح
يحدد السجل التوضيحي رابط المعاينة الذي أنشأته الاستضافة وعلامة P2 ومعرّف commit المنسوخ من طلب السحب. سأتحقق من وجود “Contact me” هناك. إذا رأيت P1 أو لم أجد بناء معاينة، فلم تجتز تلك المعاينة هذا الفحص بعد.
ما تتضمنه الإجابة السليمة
- يربط رابط المعاينة الفعلي بعلامة P2 ومراجعة المصدر المحددة.
- لا يعتبر اسم الفرع وحده هوية النسخة التي روجعت.
كيف يعمل؟ (اختياري)
افتح مراجعة فرع بتغيير قابل للتكرار
اربط طلب سحب بإصدار محدد من المصدر.
اتبع commands.txt داخل مستودعك القابل للاستغناء عنه فقط. سجّل تغيير P2 بالتزام على فرع وافتح طلب سحب دون دمجه. ينبغي أن تربط Deploy Preview في Netlify رابطًا مبنيًا بطلب السحب ذاك وإصدار المصدر المرتبط به.
اقرأ تفاصيل النشر بدل استنتاج النجاح من المتصفح. سجّل الالتزام وافحص مجلد النشر. إذا لم توجد معاينة، فافحص إعدادات المعاينة للمشروع وسجلات البناء؛ ولا تعوّض ذلك بنشر الفرع إلى الإنتاج.
قبل أوامر الفرع، افتح رابط P1 العام القائم وانقر رابط التواصل وسجّل التزام P1 الذي يعمل في review-record.csv. إذا لم توجد نسخة نشر P1 تعمل، فأكمل خط الأساس أولًا. للواجب، املأ الصفين: الواجهة والرابط والالتزام والنسخة الظاهرة ونتيجة مهمة التواصل وأي أثر جانبي غير متوقع.
إذا تغير فرع الإنتاج أثناء العمل، فافحص حالة تحديث طلب السحب وتعارضاته قبل المتابعة. اجلب حالة الفرع الحالية وحل أي تعارض عن قصد في فرعك؛ واطلب المساعدة عند عدم اليقين بدل الكتابة فوق عمل غير مرتبط. بعد الحل، راجع إصدار المعاينة الجديد مجددًا.
إذا غاب رابط المعاينة، فافحص تمكين Deploy Previews لطلبات سحب المستودع وعدم استبعاد الفرع ونجاح سجل البناء وإشارة netlify.toml إلى المجلد العام المقصود. افتح نشر الإنتاج الحالي في سجل Deploys لدى المزوّد للعثور على التزام مصدره الفعلي.
مثال محلول
ينبغي أن يشير فحص الالتزام الأخضر ومعاينة يمكن فتحها وقراءتها إلى إصدار الشيفرة نفسه. تعديل الفرع بعد ذلك ينشئ إصدارًا جديدًا يحتاج إلى مراجعة مستقلة.
Netlify: معاينات النشر Deploy Previews
تمرين تقني إضافي
راجعت الالتزام A ثم دفعت الالتزام B إلى الفرع نفسه. هل تشمل الموافقة القديمة B؟
عرض حل نموذجي مشروح
لا. بقي اسم الفرع نفسه لكن المحتوى تغير. افحص المعاينة المبنية من B وراجع الفروق.
- تربط المراجعة بإصدار مصدر محدد.
- تعيد اختبار المعاينة المتغيرة قبل ترقيتها.

الخطوة 2 · كيف تعاين تغييرات موقعك قبل النشر
كرّر مهمة الزائر بأمان
اسم مضيف مختلف لا يجعل الخدمات الحقيقية بلا أثر.
شرح ومثال محلول وتدريب
افهم الفكرة
افتح P1 المنشورة ومعاينة P2 دون دخول وبعرض ضيق. فعّل إجراء التواصل في كل منهما وتحقق من بقاء قسم Contact قابلًا للوصول. في هذا المثال الثابت المرفق، توقف عند وجهة التواصل؛ ولا ترسل بريدًا إلى العنوان المؤقت.
إذا طبّقت التقنية لاحقًا على نماذج أو مدفوعات أو بيانات محفوظة، فافحص إعدادات خدمات المعاينة أولًا. قد يستدعي اسم مضيف جديد للمعاينة خدمة حقيقية؛ فاستخدم حسابات وبيانات اختبار منفصلة لهذه الآثار.
مثال عملي
في المثال المرفق، تصل P1 وP2 إلى قسم Contact؛ وتغير P2 تسمية الرابط الظاهرة وعلامة النسخة فقط. ولا تحتاج أي نسخة إلى إرسال بريد أو كتابة سجل في قاعدة بيانات.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ماذا فعلت المهمة نفسها في كل نسخة؟ وأي حدود لخدمات الاختبار تحققت منها؟
عرض حل نموذجي مشروح
مثال مقارنة: يصل كل من “Find contact information” في P1 و“Contact me” في P2 إلى Contact في عرض ضيق ودون دخول. لا يرسل التعديل المرفق بريدًا ولا ينفذ دفعًا أو إجراء قاعدة بيانات؛ ولم أشغّل عنوان البريد المؤقت.
ما تتضمنه الإجابة السليمة
- ينفذ مهمة التواصل نفسها في النسختين ويقارن نتيجتها.
- يفحص الاستخدام في العرض الضيق ودون دخول، ويميز الإجراء الثابت عن آثاره الخارجية الحقيقية.
كيف يعمل؟ (اختياري)
افصل بيانات المعاينة وآثارها الجانبية
رابط مختلف لا يعزل الخلفية تلقائيًا.
ليس لمثال رابط التواصل الثابت آثار خلفية جانبية. في تطبيق حقيقي، راجع متغيرات سياق المعاينة منفصلة: قد لا تزال قاعدة البيانات ومستلم البريد ووضع الدفع وبيانات الاعتماد تشير إلى الإنتاج.
استخدم بيانات اختبار قابلة للاستغناء عنها وبيئات تجريبية لدى المزوّد حيث يلزم. قد تظل معاينة محمية من المشاهدة العابرة تنفّذ دالة خادم بأي بيانات اعتماد أعددتها.
مثلًا، إذا قرأت دالتك SUPABASE_URL، فاحتفظ باسم المتغير نفسه لكن اضبط قيمة سياق Deploy Preview له على مشروع قاعدة البيانات القابل للاستغناء عنه. لا تختلق اسم متغير لا تقرؤه الشيفرة. راجع كل سر ومستلم ووضع دفع في ذلك السياق أيضًا؛ نسخ قيمة الإنتاج يهدم العزل.
افتح إعدادات متغيرات البيئة في لوحة مشروع Netlify، وعدّل قيمة سياق Deploy Preview للمتغير مستقلة عن قيمة Production. احفظ قيمة خدمة اختبار فقط لذلك السياق، وابدأ بناء معاينة جديدًا وتحقق من إصدار المصدر الناتج؛ تغيير قيمة في اللوحة لا يثبت أن دالة منشورة أقدم التقطتها. انظر دليل السياق الرسمي أدناه.
مثال محلول
قد يرسل نموذج تواصل في معاينة متصل بمزوّد بريد الإنتاج رسائل حقيقية. كلمة «preview» في الرابط لا توقف ذلك الاستدعاء.
Netlify: متغيرات البيئة وسياقات النشر · Netlify: متغيرات البيئة الخاصة بسياق النشر
تمرين تقني إضافي
هل يكفي اسم مضيف معاينة فريد لضمان ألا تخصم مشتريات الاختبار أموالًا حقيقية؟
عرض حل نموذجي مشروح
لا. اضبط المعاينة ببيانات اعتماد اختبار وخدمات معزولة ثم تحقق من سلوكها الفعلي. فصل اسم المضيف وحده غير كافٍ.
- تفحص بيانات اعتماد الدفع ووضعه وأهداف البيانات.
- لا تخلط فصل رابط الواجهة الأمامية بعزل الخلفية.

الخطوة 3 · كيف تعاين تغييرات موقعك قبل النشر
اتخذ قرار مراجعة مرتبطًا بالنسخة
تتبع الموافقة النتيجة التي فحصتها فعلًا.
شرح ومثال محلول وتدريب
افهم الفكرة
أكمل review-record.csv بالروابط والنسخة المراجعة والملاحظات والمشكلات المتبقية. اطلب أي إصلاح محدد وافحص المعاينة الناتجة مجددًا.
أبقِ الموقع الحالي دون تغيير حتى اتخاذ قرار إطلاق صريح. إن تغيرت النسخة بعد المراجعة، فحدّد ما يحتاج إلى إعادة اختبار.
مثال عملي
المراجعة المفيدة محددة: «تصل تسمية التواصل المعدلة في P2 إلى القسم نفسه عند 390 بكسل وعلى سطح المكتب؛ ويبقى الأساس المنشور P1». تحدد النسخة المختبرة ولا تدمج طلب السحب.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
قدّم مقارنة المعاينة بالصفحة الحالية، مع موافقتك أو المشكلة المتبقية.
ما المطلوب إنجازه: رابطا المعاينة والنسخة الحالية وسجل مقارنة فعلي للنسخة المراجعة.
عرض حل نموذجي مشروح
مثال قرار: تسمية “Contact me” في P2 أوضح، وتصل إلى قسم P1 نفسه عند 390 بكسل وعلى سطح المكتب. أوافق على نسخة المعاينة المسجلة نفسها لاتخاذ قرار إصدار لاحق؛ ويبقي التمرين طلب السحب غير مدمج وP1 منشورة. أي commit جديد يحتاج إلى مراجعة أخرى.
ما تتضمنه الإجابة السليمة
- يربط المقارنة وقرار المراجعة بنسخة المعاينة المحددة.
- يبقي P1 المنشورة دون تغيير ويسرد أي مشكلة تحتاج إلى معاينة ومراجعة جديدتين.
كيف يعمل؟ (اختياري)
مهمتك: سلّم تغييرًا قابلًا للمراجعة
اجعل المراجعة صغيرة وادعمها بنتائج قابلة للملاحظة.
أنشئ تحسين تسمية أو تخطيط إضافيًا في الفرع. افحص الفتح المباشر وعرض الهاتف ومهمة التواصل في معاينته. قارنه بنسخة الإنتاج.
قدم وصف تغيير قصيرًا مع رابط المعاينة وإصدار المصدر والملاحظات. لا تدمج إلا بعد موافقة المراجع المقصود على النسخة الفعلية؛ لا يتطلب هذا التدريب ترقية إلى الإنتاج.
للفحص الضيق، استخدم أدوات المطوّر في المتصفح عند نافذة عرض 390px ثم عرض حاسوب. سجّل العرض الفعلي ونتيجة مهمة التواصل في review-record.csv؛ تترك هذه المهمة الفرع غير مدمج.
مثال محلول
«غيّرت تسمية التواصل؛ ولا يزال الرابط يصل إلى #contact عند 390px وعرض الحاسوب» أنفع من «يبدو أفضل».
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
تمرين تقني إضافي
أنجز معاينة فرع وسجل مقارنة مكتملًا دون تغيير الإنتاج.
عرض حل نموذجي مشروح
تأكد من عمل P1 بالفعل على رابط التدريب العام وسجّل التزامها. غيّر في فرع المراجعة العلامة الظاهرة إلى P2 وتسمية التواصل إلى «Contact me»، وسجّل الفرع بالتزام وادفعه في حسابك وافتح طلب سحب غير مدمج.
سجّل الصفين في review-record.csv: رابط الإنتاج/الالتزام/P1/التواصل يعمل؛ رابط المعاينة/الالتزام الجديد/P2/التواصل يعمل. افتح الاثنين وأنت مسجّل الخروج وعند عرض ضيق. يجب أن تشير إعدادات خلفية المعاينة إلى خدمات اختبار معزولة إذا كانت لها آثار جانبية. كرر فحوص الواجهتين عند 390px وعرض حاسوب؛ واستخدم صفوف CSV منفصلة وسجّل كل عرض فعلي.
بعد التزام فرع آخر، أعد فحص إصدار المعاينة الجديد. يوضح وصف الطلب المرجعي المعلومات التي يحتاج إليها المراجع؛ أبقِ الفرع غير مدمج ولا ترقِّ الإنتاج ضمن هذه المهمة.
- يبقى الإنتاج على إصداره المعتمد أثناء المراجعة.
- يجتاز إصدار المعاينة المحدد مهمة الزائر المذكورة.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.