به‌روزرسانی API GitHub Actions ردیابی گردش کار را برای توسعه‌دهندگان ساده می‌کند

پیتر ژانگ 1404/11/31 23:29

API ارسال گردش کار GitHub اکنون شناسه‌های اجرا را برمی‌گرداند و نیاز به راه‌حل‌های نظرسنجی سفارشی را هنگام راه‌اندازی برنامه‌ریزی شده گردش‌های کار خودکار از بین می‌برد.

GitHub به آرامی یکی از نقاط دردناک آزاردهنده‌تر را برای توسعه‌دهندگانی که خطوط لوله CI/CD خود را خودکار می‌کنند، حل کرده است. نقطه پایانی API ارسال گردش کار اکنون شناسه‌های اجرا را مستقیماً در پاسخ خود برمی‌گرداند—یک تغییر کوچک که ساعت‌ها کد راه‌حل موقت را از بین می‌برد.

قبلاً، راه‌اندازی یک گردش کار از طریق API چیزی جز وضعیت 204 No Content به شما نمی‌داد. می‌دانستید گردش کار شروع شده است، اما موفق باشید در یافتن اینکه کدام اجرا متعلق به شماست بدون نظرسنجی مکرر از API یا ساخت سیستم‌های ردیابی سفارشی. این مشکل اکنون برطرف شده است.

به‌روزرسانی که در 1404/11/31 اعلام شد، یک پارامتر اختیاری جدید به نام return_run_details را معرفی می‌کند. آن را روی true تنظیم کنید و پاسخ 200 OK حاوی شناسه گردش کار، URL API و URL گردش کار دریافت خواهید کرد. پارامتر را رد کنید و رفتار قدیمی 204 ادامه می‌یابد—سازگاری با نسخه‌های قبلی حفظ شده است.

کاربران GitHub CLI که نسخه 2.87.0 یا جدیدتر را اجرا می‌کنند به طور خودکار این را دریافت می‌کنند. gh workflow run را اجرا کنید و URL اجرای ایجاد شده به علاوه دستور gh run view را برای بررسی آن خواهید دید. CLI اکنون به طور پیش‌فرض return_run_details را روی true تنظیم می‌کند.

این برای هر کسی که در بالای GitHub Actions اتوماسیون می‌سازد اهمیت دارد. به سیستم‌های هماهنگی استقرار، خطوط لوله پردازش دسته‌ای یا هر ابزاری که نیاز به ردیابی آنچه ایجاد کرده دارد فکر کنید. رویکرد قبلی—نظرسنجی از نقطه پایانی اجراها و تلاش برای تطبیق برچسب‌های زمانی یا commit SHAها—شکننده و وابسته به محدودیت نرخ بود.

زمان‌بندی قابل توجه است. GitHub مفهوم Agentic Workflows خود را فقط دو روز قبل‌تر در 1404/11/29 پیش‌نمایش کرد و نشان‌دهنده سرمایه‌گذاری عمیق‌تر در کنترل برنامه‌ریزی شده گردش کار است. و این پلتفرم هنوز از نظر اعتباری از یک قطعی بزرگ که رانرهای میزبانی شده را در 1404/11/14 تحت تأثیر قرار داد و خطوط لوله CI/CD را در سراسر اکوسیستم مختل کرد، در حال بازیابی است.

برای زمینه، GitHub حداکثر ورودی‌های workflow_dispatch را از 10 به 25 در 1404/09 افزایش داد، یک بهبود کیفیت زندگی دیگر برای سناریوهای اتوماسیون پیچیده.

این ویژگی اکنون در REST API فعال است. مستندات در راهنمای رویدادهای گردش کار Actions GitHub برای هر کسی که آماده است ترفندهای ردیابی سفارشی خود را کنار بگذارد، در دسترس است.

• github actions
• api
• devops
• اتوماسیون
• ابزارهای توسعه‌دهنده