ابنِ أول خط أنابيب

ما الذي ستبنيه

في نهاية هذا الدرس يكون لديك:

• قالب خط أنابيب محفوظ يرسل وكيلًا بموجّه
• التشغيل اليدوي مفعّل عليه، فيُبدأ باليد
• تشغيل واحد مكتمل، ومدخل الخطوة ومخرجها ظاهران

المتطلبات: إتمام أرسل وكيلك الأول، ليكون لديك وكيل بمحوّل ونموذج.

خط الأنابيب مخطط DAG من خطوات. القوالب تعرّف المخطط، والتشغيلات هي التنفيذ. للنموذج الذي يقوم عليه، اقرأ خطوط الأنابيب والأتمتة؛ ولمفردات الخطوات كاملة، أنواع خطوات خط الأنابيب.

الخطوة 1: إنشاء قالب

1. انتقل إلى الإعدادات ← مساحة العمل ← قوالب خطوط الأنابيب
2. انقر قالب جديد

يفتح المحرّر على هيكل مبذور باسم خط أنابيب جديد (المعرّف pipeline_N). انقر العنوان في الترويسة وأعد تسميته — في هذا الدرس، code_quality_check اسم مناسب. لا حوار للمعرّف ولا حقل للوصف.

اللوحة ليست فارغة. يأتي القالب الجديد موصولًا مسبقًا على الشكل Trigger → Step → terminal، حيث «Step» عقدة وكيل موجّه، وterminal حارس غير مرئي يعيد المحرّر توصيله إلى كل عقدة بلا مخرج يمكن بلوغها.

تهيّئ عقدة Step الموجودة أصلًا.

الخطوة 2: تهيئة الخطوة

1. انقر عقدة Step على اللوحة
2. في لوحة إعدادات العقدة على اليمين، اضبط:
   • الوكيل: وكيلك من الدرس السابق
   • قالب الموجّه: «راجع الشفرة على الفرع الحالي بحثًا عن مشكلات الجودة. اذكر ما تجده.»
3. اترك المشغّلات من كما هي — العقدة موصولة أصلًا لتنطلق بعد Trigger

الخطوة 3: الحفظ

اضغط حفظ في ترويسة المحرّر.

نقطة التحقق. تختفي عبارة «تغييرات غير محفوظة».

الخطوة 4: السماح بالتشغيل اليدوي

1. انقر البلاطة المتقطعة إضافة مشغّل على اللوحة (أو اسحب تشغيل يدوي من قسم المشغّلات في مكتبة العقد) واختر تشغيل يدوي.
2. حدّد تلك العقدة. في لوحة الإعدادات على اليمين، فعّل ممكّن — «الإظهار في صفحة التشغيل والبدء يدويًا.»

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

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

الخطوة 5: شغّله

1. انقر خطوط الأنابيب في الشريط الجانبي
2. انقر تشغيل خط أنابيب في الترويسة
3. اختر code_quality_check في الشريط الأيسر
4. انقر تشغيل خط الأنابيب في النموذج — قالبك لا يعلن مدخلات، فلا شيء تملأه

نقطة التحقق. يؤكد إشعار منبثق أن التشغيل بدأ، ويفتح Control Center تفاصيل التشغيل.

ينشئ المحرّك سجل التشغيل، ويُكمل المشغّل، ويجدول الخطوة، ويرسل الوكيل، ويُكمل التشغيل حين ينتهي الفرع الوارد إلى terminal.

الخطوة 6: فحص النتيجة

انقر الخطوة في التشغيل لفتح لوحة تفاصيلها:

• طابعا بدأت وانتهت، والمدة
• المدخل: الحالة التي مُرِّرت إلى الخطوة
• المخرج: ما أنتجته — هنا رد الوكيل
• نشاط الوكيل، مع رابط إلى المحادثة التي قادتها الخطوة

نقطة التحقق. تظهر الخطوة مكتمل، ويحمل مخرجها مراجعة الوكيل.

إضافة مزيد من الخطوات

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

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

الخلاصة

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

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

التالي: اربط Slack بمساحة عملك، آخر درس في هذه السلسلة.

• إعداد مشغّلات خط الأنابيب لبدء خطوط الأنابيب من أحداث أو من جدول
• خطوط الأنابيب والأتمتة للنموذج الذي تقوم عليه
• أنواع خطوات خط الأنابيب لكل نوع خطوة