وثائق

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

قراءة أسباب الفشل واختيار إعادة المحاولة أو إعادة العمل أو الإيقاف المؤقت أو الإلغاء.

تفشل المهام. معظم حالات الفشل تعود إلى مشاكل في التكوين أو المواصفات، وليست غامضة، وتنقسم إلى عدد قليل من الأنماط.

أولاً، اقرأ المكان الذي توقفت فيه.

تُظهر عملية التشغيل المرحلة التي فشلت فيها. هذه الحقيقة وحدها تضيّق نطاق السبب أكثر من أي شيء آخر:

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

حالات الفشل قبل كتابة التغيير تعود إلى التكوين. انظر إلى تكوين البناء والاختبار..

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

ليس عالقًا، بل في انتظار التنفيذ.

مهمة في PENDING ليست عالقة. إنها تنتظر توفر مساحة لوكيل حاسوبي. تحقق من القدرة قبل أي شيء آخر — هذا هو الإنذار الكاذب الأكثر شيوعًا.

إنه يطلب منك اتخاذ قرار ما.

NEEDS_HUMAN_REVIEW يعني أن المهمة وصلت إلى قرار لا يمكن اتخاذه إلا من قبلك. ليس ذلك فشلًا. أجب على السؤال وستستمر من حيث توقفت.

أجب بدقة. الإجابة الغامضة تؤدي إلى تخمين آخر وإيقاف مؤقت آخر.

التشغيل يستغرق وقتًا أطول من المتوقع.

سببان شائعان:

مجموعة اختبارات بطيئة أو متعثرة. يقوم Coroid بتشغيل مجموعة الاختبارات؛ إذا تعثرت في بيئة عمل نظيفة، فإن المهمة تنتظر. أعد تشغيلها على نسخة جديدة من المشروع لإعادة تكرار المشكلة.

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

اختيار الإجراء المناسب.

بترتيب تصاعدي من حيث التكلفة:

  • الإجابة — من أجل NEEDS_HUMAN_REVIEW. الأقل تكلفة، ويحافظ على كل السياق.
  • إعادة العمل. — العمل صحيح لكنه غير كامل. تعود المهمة إلى وكيل المطور مع النتائج والسياق الخاص بها دون تغيير.
  • إيقاف مؤقت. — تحتاج إلى التحقق من شيء ما أولًا. يحرر المساحة المخصصة؛ ويمكن استئنافه لاحقًا.
  • إعادة المحاولة. — لحالات الفشل العابرة فقط. إعادة محاولة حل مشكلة تكوينية يؤدي إلى تكرارها.
  • الإلغاء وإعادة تحديد المواصفات. — النهج أو المجال المحدد كان خاطئًا. الأعلى تكلفة، وغالبًا ما يكون القرار الصحيح.
  1. إجابة

    للإجابة على سؤال. يحتفظ بكل السياق.

  2. إعادة معالجة

    صحيحة لكن غير كاملة. تعود مع نتائجك.

  3. توقيف

    تحتاج إلى التحقق من شيء ما. يتم تحرير الفراغ.

  4. إعادة محاولة

    لحالات الفشل العابرة فقط.

  5. إلغاء وإعادة تحديد المواصفات

    كان النهج أو النطاق خاطئاً.

الأقل تكلفةالأعلى تكلفة
اختر الخيار الأقل تكلفة الذي يعالج السبب. إعادة التشغيل دون تغيير تساعد فقط عندما يكون الفشل عابراً.

حالات الفشل المتكررة عبر المهام.

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

تتعطل عملية الإصدار بعد إنهاء المهمة

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