الدروسكيف تتراجع عن نشر موقع معطّل

درس مصغّر 28 من 30 · تشغيل موقعك وصيانته

اختر النسخة المعروفة بأنها تعمل

لمن هذا الدرس؟

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

لا يفيد إصدار سابق إلا إن كان ينجز المهمة المقصودة.

هدف هذا الدرس

  • اختر إصدارًا تحققت من عمله.
  • استعده عبر أدوات الاستضافة.
  • افحص مهمة الزائر وامنع تكرار العطل فورًا.
شرح ومثال محلول وتدريب

قبل أن تبدأ

مشروع استضافة جديد مؤقت تملكه والصفحتان المرفقتان السليمة والمعطلة. ستنشر أولًا R1 السليمة، ثم R2 المعطلة عمدًا على ذلك الموقع التدريبي فقط. يستطيع مساعد البرمجة إرشادك في خطوات الاستضافة؛ ولا تستخدم خدمة فعلية موجهة للمستخدمين لهذه المحاكاة.

تحقّق من مهارات البداية

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

  1. كيف تنشر موقعك من GitHub

    اربط مستودعًا تجريبيًا بالاستضافة.

الوقت المتوقع: 19–31 دقيقة

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

افهم الفكرة

اطلب من المساعد نشر working/public بوصفها R1 في موقع تدريبي مؤقت جديد. افتح رابطه العام واقرأ علامة R1 وفعّل Find contact information. احفظ معرّف النشر أو المراجعة التي يصل رابطها إلى قسم Contact.

على الموقع المؤقت نفسه فقط، انشر broken/public بوصفها R2. كرر الإجراء: تشير R2 إلى وجهة مفقودة. احتفظ بمعرّف R2 الفاشلة بجوار معرّف R1 المعروفة بعملها. أصبحت لديك الآن مشكلة تدريبية فعلية ونسخة محددة صالحة للاستعادة.

مثال عملي

يستهدف رابط R1 المرفق #contact، وهو موجود. وتستهدف R2 بدلًا منه #contact-missing. ليست أقدمية الوقت ما يجعل R1 مناسبة؛ بل عمل مهمة Contact فيها.

استخدم مشروع الاستضافة التدريبي المؤقت الجديد الخاص بي فقط. انشر working/public المرفقة بوصفها R1، وساعدني في فحص إجراء التواصل وحفظ معرّف النشر. بعد أن أؤكد الوجهة التدريبية، انشر broken/public بوصفها R2 هناك فقط وأعد إنتاج فشل وجهة التواصل. ثم ساعدني في استعادة نسخة R1 المحددة عبر الاستضافة، وأعد اختبار الإجراء نفسه، وامنع إعادة نشر مصدر R2 المعطل فورًا. لا تمس موقعًا آخر أو بيانات مستخدمين حقيقية أو خدمة إنتاجية.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

بعد نشر R1 وR2 للتدريب، ما الإصدار المحدد الذي ينبغي استعادته، ولماذا هو مناسب؟

عرض حل نموذجي مشروح

سأستعيد نشر R1 الذي سجلت معرّفه في الاستضافة المؤقتة. يصل رابط Contact فيه إلى القسم الموجود، بينما يشير رابط R2 المرفق إلى #contact-missing. تجعل هذه المقارنة R1 مرشحة للاستعادة؛ ولا تكفي أقدميتها وحدها.

ما تتضمنه الإجابة السليمة

  • يحدد نشر R1 أو مراجعته المحفوظة، لا أي إصدار أقدم عشوائي.
  • يستند إلى نجاح مهمة Contact في R1 وإعادة إنتاج فشلها في R2 سببًا للاختيار.
كيف يعمل؟ (اختياري)

تراجع عن نشر معطّل دون تخمين

استعد النسخة التي اجتازت فعلًا مهمة الزائر المتأثرة.

تبدأ الاستعادة بفشل المستخدم، لا برغبة غامضة في العودة إلى تاريخ أقدم. تعطل الورشة رابط مرساة التواصل في R2، بينما يحتوي R1 على الهدف الصحيح.

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

مثال محلول

قد تُحمّل صفحة R2 بالحالة 200 بينما يفشل إجراء التواصل فيها. سيفوّت فحص سلامة يفتح الصفحة الرئيسية فقط هذا العطل.

تمرين تقني إضافي

ما الأدلة التي تجعل R1 مرشحًا مناسبًا للتراجع إليه؟

عرض حل نموذجي مشروح

هو النشر المعروف الذي تعمل فيه مهمة التواصل، مع تحديد ناتجه أو إصدار مصدره. «أقدم» وحدها ليست دليلًا على ملاءمة نسخة.

  • تفحص المهمة الفاشلة المحددة على R1.
  • تحدّد إصدار المصدر المنشور بدقة.

الخطوة 1 · كيف تتراجع عن نشر موقع معطّل

استعد النسخة في استضافة التدريب

استخدم أداة الموقع التجريبي القابل للحذف المقصود.

شرح ومثال محلول وتدريب

افهم الفكرة

أكد مع المساعد اسم المشروع المؤقت وعلامة R2 المعطلة. من سجل النشر لتلك الاستضافة، اختر نسخة R1 المحفوظة واستخدم أداة الاستعادة أو إعادة النشر المدعومة. تغير العملية الموقع التدريبي، لا تاريخ المصدر في المستودع.

بعد أن تكمل الاستضافة العملية، افتح الرابط العام الفعلي للتدريب مجددًا. تحقق من علامة R1 وكرر Find contact information؛ فشارة النجاح لدى الاستضافة وحدها لا تخبرك أن المتصفح يختبر الموقع الصحيح.

مثال عملي

إذا أعلنت الاستضافة R1 لكن العنوان العام ما زال يعرض R2، فقارن المشروع والرابط والنسخة المنشورة قبل إعلان اكتمال الاستعادة.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

أي نسخة استعادتها الاستضافة؟ وماذا عرض العنوان العام بعد ذلك؟

عرض حل نموذجي مشروح

مثال نتيجة استعادة: اخترت نشر R1 المحفوظ في المشروع المؤقت؛ ويعرض رابطه العام الآن Version R1، ويصل Find contact information إلى Contact. لو بقي الرابط يعرض R2، لظلت الاستعادة غير محسومة بغض النظر عن شارة الاستضافة.

ما تتضمنه الإجابة السليمة

  • يسمي نسخة R1 المختارة ويؤكد أن الهدف هو المشروع المؤقت.
  • يفحص علامة R1 العامة وإجراء التواصل الذي كان يفشل بعد الاستعادة.
كيف يعمل؟ (اختياري)

تدرّب على التراجع في مشروع قابل للاستغناء عنه

استخدم سجل النشر لإعادة نشر الناتج المعروف بأنه يعمل.

اتبع START-HERE.txt على مضيف التدريب فقط. سجّل R1، وانشر عطل R2 المقصود، وأعد إنتاج فشل مهمة التواصل. ثم اعثر على R1 في سجل النشر واستخدم إجراء النشر أو التراجع لدى المضيف.

افحص الرابط العام الناتج وعلامة النسخة بعد اكتمال الإجراء. تختلف واجهات الاستضافة والأذونات؛ راجع دليل المضيف الحالي بدل الاعتماد على موضع زر قديم.

مثال محلول

يجب أن تعرض الصفحة العامة R1 الآن، وأن يصل رابط التواصل إلى قسم التواصل الفعلي. إجراء لوحة التحكم وحده ليس فحص استعادة مكتملًا.

Netlify: إدارة النشر والتراجع

تمرين تقني إضافي

تقول لوحة التحكم إن النشر السابق أُعيد نشره. ما الذي ينبغي فحصه بعد ذلك؟

عرض حل نموذجي مشروح

أكد ناتج النشر العام ونسخته، وكرر إجراء التواصل. سجّل النتيجة بدل افتراض أن نجاح إجراء التحكم يثبت استعادة تجربة المستخدم.

  • تفتح الرابط العام الفعلي وتفحص النسخة.
  • تكرر المهمة التي فشلت سابقًا.

الخطوة 2 · كيف تتراجع عن نشر موقع معطّل

امنع عودة الفشل نفسه

الاستعادة وإصلاح النشر التالي مهمتان منفصلتان.

شرح ومثال محلول وتدريب

افهم الفكرة

كرر مهمة Contact في R1 المستعادة. ثم اطلب من المساعد فحص نسخة المستودع: قد يبقى رابط R2 المعطل هناك، رغم تقديم الاستضافة النسخة القديمة العاملة.

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

مثال عملي

يجعل التصحيح الدائم هدف الرابط يطابق قسم Contact الموجود مجددًا. هذا تعديل مصدر مستقل عن إعادة نشر نسخة R1 المبنية مسبقًا.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ما الذي أعاد مهمة الزائر للعمل؟ وما الذي يمنع عودة النسخة المعطلة؟

عرض حل نموذجي مشروح

أعادت إعادة نشر نسخة R1 عمل مهمة Contact. لمنع التكرار، سأطلب من المساعد تغيير هدف المستودع #contact-missing إلى #contact، وفحص هذا الفرق الصغير ومراجعة معاينته التالية قبل السماح بنشر آخر. الرجوع في الاستضافة وحده لا يصلح المصدر.

ما تتضمنه الإجابة السليمة

  • يفصل الاستعادة الفورية لدى الاستضافة عن إصلاح المصدر المعطل في المستودع.
  • يوضح كيف سيتجنب النشر التالي إعادة فشل رابط التواصل في R2.
كيف يعمل؟ (اختياري)

أصلح المصدر وقيّم الآثار المتبقية

امنع البناء التلقائي التالي من إعادة الخطأ نفسه.

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

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

تخيل أن R2 يزيل عمود قاعدة بيانات لا يزال R1 يقرأه. لن تعيد إعادة نشر شيفرة R1 القديمة إنشاء العمود، لذا قد يظل التراجع عن الشيفرة يفشل. افحص توافق الحالة والمخطط أولًا. في هذا التدريب الثابت، الإصلاح أصغر: أعد href='#contact-missing' إلى href='#contact'، وراجع الفروق، وتحقق من الفرع المصحح قبل نشر تلقائي لاحق.

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

مثال محلول

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

تمرين تقني إضافي

يعيد التراجع الصفحة، لكن الالتزام المعطّل يبقى على فرع الإنتاج. ما الخطر المتبقي؟

عرض حل نموذجي مشروح

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

  • تتوقع إعادة نشر المصدر السيئ تلقائيًا.
  • تخطط لإصلاح المصدر والتحقق منه.

الخطوة 3 · كيف تتراجع عن نشر موقع معطّل

اكتب سجل تسليم الاستعادة

اجعل الحادث التالي أسهل فهمًا.

شرح ومثال محلول وتدريب

افهم الفكرة

أكمل recovery-record.txt بمهمة R2 الفاشلة ومعرّف نشر R1 المحفوظ والاستعادة في الاستضافة وإعادة اختبار Contact العام. أضف تصحيح المستودع أو الخطوة الدقيقة التي ما زالت مطلوبة.

تستعيد هذه المحاكاة كود موقع ثابت. لا تتراجع عن تغييرات قاعدة البيانات أو البريد المرسل أو الرسوم أو المفاتيح المكشوفة؛ فهذه تحتاج إلى إجراءات استعادة مستقلة في حادث فعلي.

مثال عملي

قصة استعادة مختصرة: كانت وجهة R2 مفقودة؛ فأُعيد نشر R1 المعروفة بعملها؛ وعملت Contact في R1 العامة؛ ثم أُصلح المصدر وروجع قبل الإصدار التالي.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

قدّم سجل الاستعادة واختبار المهمة المستعادة الفعلي.

ما المطلوب إنجازه: سجل استعادة يتضمن النسخة المستعادة ونتيجة المهمة الفعلية وخطوة الوقاية.

عرض حل نموذجي مشروح

مثال سجل: ظهرت R2 بصورة طبيعية لكن هدف Contact فيها كان مفقودًا. استعدت نسخة R1 المسجلة على الاستضافة المؤقتة، وعادت مهمة Contact العامة للعمل. وما زالت وجهة المستودع تحتاج إلى تصحيح ومراجعة معاينة قبل نشر آخر. لم تشمل هذه التجربة الثابتة استعادة قاعدة بيانات أو بريد أو مدفوعات.

ما تتضمنه الإجابة السليمة

  • يربط نسخة R2 الفاشلة بنسخة R1 المستعادة وإعادة اختبار المهمة العامة فعلًا.
  • يتضمن منع التكرار ويميز الرجوع في الكود عن البيانات والآثار الخارجية.
كيف يعمل؟ (اختياري)

مهمتك: اكتب دليل استعادة قصيرًا وأثبت عمله

اجعل الاستعادة التالية قابلة للتنفيذ من شخص لم يكتب التغيير.

أكمل سجل الاستعادة بمعرّفات دقيقة للنشر والمصدر والمهمة الفاشلة وإجراء التراجع والفحص الظاهر للمستخدم. ضمّن إصلاح المصدر وأي حالة خارج نطاق التراجع.

اطلب من شخص آخر اتباع الخطوات المكتوبة على الموقع القابل للاستغناء عنه، أو اتبعها من متصفح جديد. أزل افتراضات مثل «انقر القديم» لا تفهمها إلا أنت.

مثال محلول

يحدد دليل الإجراءات المفيد النسخة التي تختارها وكيف تعرف أن الاستعادة عملت. قائمة نقرات في لوحة التحكم دون فحص المهمة هشة.

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

تمرين تقني إضافي

أنجز سجل استعادة يعيد عمل مهمة الاختبار ويمنع التكرار الفوري.

عرض حل نموذجي مشروح

أعد إنتاج فشل التواصل في R2 على الموقع القابل للاستغناء عنه، وسجّل معرّف نشره والتزامه. اعثر في سجل النشر على سجل R1 المعروف بأنه يعمل، وافحص ناتجه وإصدار مصدره، واختر تحكم النشر أو التراجع لدى المزوّد لذلك السجل.

افتح الرابط العام الفعلي، واقرأ R1، وكرر إجراء التواصل. ثم أصلح المصدر المعطّل بإعادة href='#contact'؛ وراجع ذلك التغيير وسجّله بالتزام قبل السماح بنشر تلقائي لاحق.

أبقِ استعادة الشيفرة منفصلة عن استعادة البيانات. إذا أزالت نسخة أحدث عمودًا تتطلبه الشيفرة القديمة، فلن تعيد إعادة نشر HTML/JS القديم إنشاءه. يسمي سجل الحادث المرجعي المهمة المستعادة وإصلاح المصدر والحالة خارج نطاق التراجع.

  • تجتاز النسخة المستعادة المهمة الفاشلة نفسها.
  • يُعالَج إصلاح المصدر والآثار خارج الشيفرة صراحة.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.