درس مصغّر · العربية

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

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

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

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

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

قبل أن تبدأ

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

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

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

ما الذي ستتعلمه؟

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

ملفات ورشة العمل

الخطوة 1

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

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

اطلب من المساعد نشر 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 المعطل فورًا. لا تمس موقعًا آخر أو بيانات مستخدمين حقيقية أو خدمة إنتاجية.

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

مثال محلول

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

Extra implementation exercise

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

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

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

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

الخطوة 2

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

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

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

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

مثال عملي

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

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

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

مثال محلول

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

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

Extra implementation exercise

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

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

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

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

الخطوة 3

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

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

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

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

مثال عملي

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

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

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

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

مثال محلول

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

Extra implementation exercise

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

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

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

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

الخطوة 4

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

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

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

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

مثال عملي

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

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

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

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

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

مثال محلول

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

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

Extra implementation exercise

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

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

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

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

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

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

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

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

واصل التعلّم

استكشف الدروس الأخرى