Jenkins / الأدلة والمشاركة والسلطة / الدرس 11

شروط when والقرارات البشرية المحدودة

استخدم الاختيار والموافقة لغرضين مع حفظ هوية المرشح.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

شرح ترتيب الشرط والوكيل وطلب القرار.
ربط القرار بالمرشح والهدف والأدلة.

يختار الشرط العمل ولا يمنح سلطة

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

يؤثر ترتيب التخصيص والقرار في الموارد

تقع الشروط والخيارات وinput وتخصيص الوكيل في نقاط موثقة، وتغير beforeAgent وbeforeInput وbeforeOptions بعض الترتيب بأسبقية محددة. يهم ذلك عند احتجاز منفذ بانتظار قرار أو تخصيص عقدة لعمل سيُتخطى. اقرأ المرجع لا ترتيب الأقواس بصرياً فقط. قد تختلف شمولية المهلة للتخصيص بين مستوى السير والمرحلة أيضاً. يوضح التصميم الجيد متى تبدأ الساعة ومتى يحتجز المورد، بحيث لا يُفسر انتهاء مهلة انتظار عامل كفشل تطبيق أو يتراكم انتظار بشر على سعة بناء نادرة.

اختر قبل التخصيص عند الملاءمة

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

groovy توضيح ترتيب الشرط

stage("Review request") {
    when {
        beforeAgent true
        expression { params.REQUEST_REVIEW == true }
    }
    agent { label "parcel-lab" }
    steps { echo "A separate authorized decision is still required" }
}

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

يحتاج السؤال البشري نطاقاً

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

ارفض قراراً لبايتات مختلفة

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

python نمذجة ربط القرار بالطلب

request = {"candidate": "parcel-lab-r5", "target": "staging"}
approval = {"candidate": "parcel-lab-r4", "target": "staging", "accepted": True}
matched = all(approval.get(k) == v for k, v in request.items())
print(matched and approval["accepted"])
approval["candidate"] = "parcel-lab-r5"
print(all(approval.get(k) == v for k, v in request.items()) and approval["accepted"])

الناتج المتوقع

False
True

تقارن قواميس معلنة فقط. accepted بيانات تعليمية لا تفويض فعلي أو موافقة منشأة.

الأخطاء الشائعة وإصلاحها

يُعد شرط الفرع موافقة إصدار موثقة.

لماذا يحدث؟: اختلط السياق الاختياري بالسلطة.
كيف تصلحه؟: اشترط قرار المرشح والهدف الموثوق مستقلاً.
كيف تتجنب تكراره؟: وثق الاختيار والموافقة كضابطين.

يحجز input طويل منفذ بناء بلا حاجة.

لماذا يحدث؟: لم يراجع النطاق والترتيب.
كيف تصلحه؟: اختر بنية مرحلة وترتيباً مناسبين مع المالك.
كيف تتجنب تكراره؟: راجع الانتظار والوكيل والمهلة معاً.

تخوّل موافقة سابقة مرشحاً متغيراً.

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

اختبر فهمك

1. لماذا قد يفيد beforeAgent مرحلة اختيارية؟

اعرض الحل المشروح

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

2. وافق المراجع على r4 ثم حل latest إلى r5. هل القرار نفسه؟