تحديث واجهة برمجة تطبيقات GitHub Actions يبسط تتبع سير العمل للمطورين

Peter Zhang ١٩ فبراير ٢٠٢٦ ١١:٢٩ م

تعيد واجهة برمجة تطبيقات إرسال سير العمل في GitHub الآن معرفات التشغيل، مما يلغي الحاجة إلى حلول الاستقصاء المخصصة عند تشغيل سير العمل الآلي برمجيًا.

لقد حل GitHub بهدوء واحدة من نقاط الألم الأكثر إزعاجًا للمطورين الذين يقومون بأتمتة خطوط CI/CD الخاصة بهم. تعيد نقطة نهاية واجهة برمجة تطبيقات إرسال سير العمل الآن معرفات التشغيل مباشرة في استجابتها - وهو تغيير صغير يلغي ساعات من كود الحلول البديلة.

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

يقدم التحديث، الذي تم الإعلان عنه في ١٩ فبراير ٢٠٢٦، معاملًا اختياريًا جديدًا يسمى return_run_details. اضبطه على true، وستحصل على استجابة 200 OK تحتوي على معرف سير العمل وعنوان URL لواجهة برمجة التطبيقات وعنوان URL لسير العمل. تخط المعامل، وسيستمر سلوك 204 القديم - مع الحفاظ على التوافق العكسي.

يحصل مستخدمو GitHub CLI الذين يشغلون الإصدار 2.87.0 أو الأحدث على هذا تلقائيًا. قم بتشغيل gh workflow run وسترى عنوان URL للتشغيل الذي تم إنشاؤه بالإضافة إلى أمر gh run view للتحقق منه. يضبط CLI الآن return_run_details افتراضيًا على true.

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

التوقيت ملحوظ. عرض GitHub مفهوم سير العمل الوكيل قبل يومين فقط في ١٧ فبراير، مما يشير إلى استثمار أعمق في التحكم البرمجي لسير العمل. ولا تزال المنصة تتعافى سمعيًا من انقطاع كبير أثر على المشغلات المستضافة في ٢ فبراير والذي أعاق خطوط CI/CD عبر النظام البيئي.

للسياق، رفع GitHub الحد الأقصى لمدخلات workflow_dispatch من ١٠ إلى ٢٥ في ديسمبر ٢٠٢٥، وهو تحسين آخر لجودة الحياة لسيناريوهات الأتمتة المعقدة.

الميزة متاحة الآن في REST API. الوثائق متاحة في دليل أحداث سير عمل GitHub Actions لأي شخص مستعد للتخلي عن حيل التتبع المخصصة.

• github actions
• واجهة برمجة التطبيقات
• devops
• الأتمتة
• أدوات المطورين