Jenkins / أسس التنفيذ والمصدر / الدرس 1

المتحكم والوكيل والمنفذ وهوية التشغيل

حدد الجدولة والتنسيق وتنفيذ العمليات والأدلة قبل قراءة Pipeline.

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

في هذه الصفحة

أهداف الدرس

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

افصل التنسيق عن عمليات البناء

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

لم يختبر المنتظر التطبيق بعد

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

text خريطة حدود تنفيذ Jenkins

job request -> scheduling queue -> eligible executor
eligible executor -> workspace and steps -> retained run evidence

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

ليست الأسماء المقروءة دليلاً ثابتاً

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

نمذج الأهلية قبل تغيير الموارد

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

python حساب أهلية افتراضي ثابت

nodes = [{"labels": {"linux", "lab"}, "online": True, "free": 1}, {"labels": {"windows"}, "online": True, "free": 2}, {"labels": {"linux"}, "online": False, "free": 3}]
free = sum(n["free"] for n in nodes if n["online"] and "linux" in n["labels"])
print(free)
print("eligible" if free else "waiting")

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

1
eligible

يقرأ البرنامج قواميس معلنة فقط. الواحد نتيجة نموذج لا سعة Jenkins فعلية ولا ضمان بدء منتظر.

تحمل سعة التنفيذ سلطة أيضاً

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

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

يُشخّص التشغيل الموجود في طابور الجدولة بأنه فشل اختبار وحدة.

لماذا يحدث؟: لم يبدأ تنفيذ التطبيق بعد، وأُهملت أدلة الجدولة التي تفسر الانتظار.
كيف تصلحه؟: حدد سبب الطابور والسعة المؤهلة القائمة قبل تعديل الاختبار أو شيفرة التطبيق.
كيف تتجنب تكراره؟: راقب مدة انتظار المنفذ مستقلة عن زمن تنفيذ الخطوات.

يُستخدم اسم مهمة Jenkins بوصفه هوية حزمة الإصدار.

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

تُعد زيادة عدد المنفذات تحسين سرعة لا يحتاج مراجعة.

لماذا يحدث؟: لم يُقيّم تنافس الموارد أو السلطة التي يحملها تنفيذ العمل على العقدة.
كيف تصلحه؟: راجع العبء والعزل والسعة مع مالك منصة Jenkins قبل اختيار تغيير تشغيلي.
كيف تتجنب تكراره؟: عامل خانات التنفيذ كحد موارد وثقة معاً، ولا تستنتج التحسن من العدد وحده.

اختبر فهمك

1. يشترك تشغيلان في اسم مهمة واحد. هل يجب أن يستخدما المصدر والأدوات نفسها؟

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

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

2. تحمل عقدة الوسم المطلوب لكنها غير متصلة. هل يساعد عدد منفذاتها المضبوط المهمة المنتظرة؟