AI CodeOps

الفتح عند الخطأ مقابل الإغلاق عند الخطأ: كيف تتعامل بوابات الجودة مع الأخطاء

آخر تحديث

معنى الفتح عند الخطأ والإغلاق عند الخطأ في بوابات CI والإصدار، ولماذا تتوقف البوابة التي تسمح بالمرور عند الخطأ حين تهم، وكيف تغلق عند الخطأ دون تعطيل.

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

توسع هذه الصفحة خاصية واحدة من ما بوابات الجودة؟.

من أين جاء المصطلحان

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

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

كيف ينتهي الأمر بالبوابات إلى الفتح عند الخطأ

قليل من الفرق تقرر بناء بوابة تسمح بالمرور عند الخطأ. بل يحدث ذلك عبر خيارات صغيرة تبدو معقولة:

  • أخطاء يسمح بمرورها. خطوة CI موسومة بخيار "continue on error" أو "allow failure" لكي تكف أداة متقلبة عن منع عمليات البناء. ثم تفشل الأداة فعلا، ولا يلاحظ شيء ذلك.
  • نصوص واجهة الأوامر التي تخفي رموز الخروج. أمر يليه || true، أو سلسلة أوامر تأتي حالة خروجها من الأمر الأخير لا من الأمر الذي فشل.
  • انتهاء المهلة يعامل محايدا. فحص أمني تنتهي مهلته فيبلغ عنه بالحالة "neutral" أو "skipped"، ولا تشترطه حماية الفروع.
  • المهام المتخطاة تحتسب نجاحا. في بعض أنظمة CI، تبلغ المهمة التي تخطاها شرط ما عن نجاح. فقد ينجح فحص مطلوب دون أن يعمل.
  • المخرجات الفارغة تقرأ نظيفة. أداة مراجعة تعطلت لا تكتب ملف ملاحظات. فتقرأ البوابة «صفر ملاحظات» وتسمح بالمرور.
  • الإجابات غير المقروءة تتجاهل. يعيد مراجع بالذكاء الاصطناعي نصا نثريا بدل النتيجة المنظمة التي تتوقعها البوابة، فتعامل البوابة غياب الملاحظات على أنه موافقة.
  • أخطاء HTTP تتجاهل. تستدعي خطوة CI خدمة البوابة، فتتلقى خطأ 500 أو انتهاء مهلة، ولا تفشل إلا إذا قال الرد صراحة «مرفوض».

كل واحد من هذه يحول «لم نستطع الفحص» إلى «فحصنا والأمر سليم».

غياب الدليل قرار، لا قيمة افتراضية

بعض الأدلة غائبة لسبب مشروع. فمشروع الوثائق وحدها قد لا تكون له اختبارات. والخدمة الجديدة قد لا تكون لها قائمة SBOM بعد. وأمر الاختبار قد لا يطبع التغطية.

والقاعدة ليست أن كل مدخل غائب يجب أن يمنع. بل أن كل حالة تقرر عن قصد، وتكتب، وتكون مرئية:

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

وأيا كان اختيارك، لا يجوز أبدا أن تعرض النتيجة الغائبة بعلامة صح خضراء. ويجب أن يبدو «لم يفحص» و«نجح» مختلفين للشخص الذي يوافق.

كلفة الإغلاق عند الخطأ، وكيف تديرها

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

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

تصميم بوابة تغلق عند الخطأ

  1. ابدأ من الرفض. الإجابة الافتراضية للبوابة هي لا. ولا تعيد نعم إلا حين يكون كل دليل مطلوب موجودا ومقبولا.
  2. عامل الأخطاء على أنها رفض. الاستثناءات وانتهاء المهلة والمدخلات المشوهة كلها تنتج رفضا مع سبب، لا موافقة أبدا ولا «محايد» أبدا.
  3. حلل بصرامة. إذا تعذرت قراءة مخرجات أداة، فالأداة لم تنجح.
  4. اربط الأدلة بالإصدار. نتيجة الاختبار أو الموافقة على إيداع سابق لا تحتسب للإيداع الحالي.
  5. اجعل كل طريق يعبر البوابة. إذا تخطت عمليات الدمج على خدمة استضافة Git بوابة تحترمها عمليات الدمج من لوحة التحكم، فالبوابة تفتح عند الخطأ من طريق آخر.
  6. اجعل الطرف المستدعي يغلق عند الخطأ أيضا. يجب أن تفشل خطوة CI التي تستدعي البوابة حين يفشل الاستدعاء.

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

response=$(curl -sf --max-time 30 -X POST "https://<your-console>/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\"}") || { echo "Release check unavailable: failing closed"; exit 1; }
[ "$(echo "$response" | jq -r '.allowed')" = "true" ] || { echo "$response" | jq -r '.reasons[]?'; exit 1; }

كيف يفعل AI CodeOps ذلك

بوابات AI CodeOps مبنية لتغلق عند الخطأ، مع استثناءات قليلة موثقة.

  • إذا فشلت مراجعة الملاحظات بالذكاء الاصطناعي، أو انتهت مهلتها، أو نفدت ميزانيتها، أو أعادت شيئا تتعذر قراءته، يحتجز التغيير، وتذكر صفحة الجلسة أي هذه حدث: فملاحظاتها مجهولة، ولذلك لا تحتسب مراجعة سليمة.
  • إذا تعذر تشغيل فحص البوابة حين يوشك طلب سحب أن يفتح أو يدمج من لوحة التحكم، لا يفتح طلب السحب ولا يحدث الدمج، وتظهر الرسالة "The release check couldn't run just now."
  • يعيد فحص الإصدار من CI القيمة allowed: false مع الملخص "Evaluation failed" إذا أخطأ التقييم، ويرفض التغيير الذي لا جلسات مطابقة له.
  • الجلسة التي غيرت الكود تحتاج إلى نتيجة اختبار فيها أعداد. فإذا لم يعمل أي اختبار، أو عمل أمر الاختبار لكنه لم يبلغ عن أعداد، يمنع التغيير بالرسالة "The test command ran but reported no test counts, so nothing shows a test passed. Check the project's test command".
  • حين يضبط disallowedLicenses، يرفض المشروع الذي لا قائمة SBOM له، لأنه لا يمكن فحص تراخيصه.
  • حين يضبط minCoveragePct، يرفض التغيير الذي لم تبلغ تشغيلات اختباره عن أي تغطية، لأنه لا يمكن التحقق من الحد الأدنى، وتكون الرسالة "Coverage wasn't reported, so the 80% floor can't be checked".
  • إذا فشل فحص الميزانية عند بدء الجلسة، تمنع الجلسة بدل أن تعمل دون قياس.

والاستثناءات مقصودة، وتظهر لا تخفى. فالمشروع الذي لا مجموعة اختبارات له يستطيع تفعيل Don't run tests for this project في إعداداته. وعندها لا تطلب بوابة الإصدار من ذلك المشروع أي نتيجة اختبار، وتبين صفحة التشغيل أن التغيير لم يتحقق منه. وإذا فشل فحص الميزانية أثناء جلسة تعمل، تواصل الجلسة العمل.

تعيد نقطة النهاية رمز HTTP 200 في حالتي السماح والرفض، فاقرأ allowed، وهي تجيب بالرمز 429 فوق 60 فحصا في الدقيقة لمساحة العمل الواحدة، وينبغي أن تعيد خطوة CI التي تغلق عند الخطأ المحاولة ثم تفشل. راجع بوابات الجودة لما تفحصه البوابة، ومرجع API لكل حقل، وبوابات جودة كود الذكاء الاصطناعي لنظرة عامة.

الأسئلة الشائعة

ماذا يعني الإغلاق عند الخطأ لبوابة الجودة؟

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

ألا يمنع الإغلاق عند الخطأ الإصدارات أثناء الانقطاعات؟

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

هل الفحص المتخطى نجاح؟

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

كيف أتجاوز بوابة تغلق عند الخطأ في حالة طوارئ؟

عبر قرار صريح ومسجل من شخص مخول، مع سبب، لا بتعطيل الفحص. وينبغي أن ينطبق التجاوز على تغيير واحد، وأن تبقى البوابة قائمة للتغيير التالي.