مُدقّق وصيغة ملفات YAML لـ GitHub Actions

مُدقّق وصيغة ملفات YAML لـ GitHub Actions

اللصق ملف عمل GitHub Actions وتحديد بسرعة البنية المُكسورة، أو السلوك المُستَبعد، أو الأنماط الخطرة قبل فشل تشغيل CI. يتحقق المُدقق من ملفك وفقًا لخطة مُدمجة للتشغيل، المهام، الخطوات، المُشغلين، الصلاحيات، والاستدعاءات المُعاد استخدامها، ثم يُعيد تنسيق ملف YAML بترتيب مُدرك للعمل بحيث يُظهر كل ملف في مخزنك نفس الشكل.

كيفية استخدام

1. ألصق .github/workflows/*.yml اللصق الملف في مربع الإدخال، أو النقر على أحد روابط الأمثلة لتحميل مثال CI أو إصدار أو سلوك مُستَبعد.
2. تبديل تسلسل المفاتيح لإعادة ترتيب الحقول باستخدام الترتيب القياسي لـ GitHub Actions (الاسم، التفعيل، الصلاحيات، المهام، ثم تشغيل المهام لكل مهمة).
3. الاحتفاظ التحقق من مخطط GitHub Actions مُفعّل لتحديد الحقول المطلوبة المفقودة، أنواع الحدث غير المعروفة، العلامات غير الصالحة للمشغل، والروابط المُكسورة needs المرجعية.
4. الاحتفاظ إظهار نصائح أفضل الممارسات مُفعّل للنصائح المتعلقة بالسلسلة والموثوقية (إبقاء المُعاملات الخارجية على شكل SHA، إضافة timeout-minutes، استبدال الأوامر المُستَبعدة).
5. النسخ المُعاد تشكيله للـ YAML أو تنزيله كملف .yml مُعد للإدخال.

خصائص

• التحقق من المخطط – الحقول الضرورية على مستوى الأعلى (on, jobs)، أسماء الحدث المسموح بها، مفاتيح المهام والخطوات المسموح بها، والمساحات المسموحة للصلاحيات.
• قواعد العمل المُعاد استخدامه – يكتشف عندما يختلط المُهمة بين uses المسائل الشائعة التي يجب مراقبتها runs-on أو steps، والتي سيعترف بها GitHub عند التشغيل.
• مُراجعة رسم المهام – يُظهر التناقضات الذاتية والاعتماد على مهام لا توجد في الملف.
• مُحلل مرجع العمل – يُكتشف القيم المفقودة uses: أو غير موجودة في @ref الشكل. owner/repo مُستبعد السياق
• – يُحذر من البيئات القديمة مع الاستبدال الحديث. ::set-env, ::set-output, ::save-stateو، و node12/node16 نصائح أفضل الممارسات
• – يقترح إبقاء المُعاملات الخارجية على شكل SHA للإبقاء على التثبيت، وإضافة لمنع المهام المُتسلسلة. timeout-minutes مُراجعة الساعات
• – يتحقق من أن مدخلات الساعات تحتوي على خمسة حقول فقط. مُعدّل مُدرك للعمل on.schedule – يُعيد ترتيب المفاتيح على مستوى العمل، مستوى المهمة، ومستوى الخطوة إلى الترتيب القياسي لـ GitHub Actions لضمان التغييرات المتسقة.
• – لا يتم إرسال أي محتوى للعمل إلى خادم. لماذا يُعاني مُخططات GitHub Actions من أخطاء هيكلية؟
• يُشغل بالكامل في المتصفح الخاص بك يُتبع مخطط YAML لـ GitHub Actions خطة صارمة تحتوي على مفاتيح ضرورية على مستوى الأعلى، أسماء حدث محددة، وقواعد المفاتيح على مستوى المهمة التي تختلف حسب ما إذا كانت المهمة عادية أو استدعاء لعمل مُعاد استخدامه. يتم تحليل الملف فقط عند تفعيله على GitHub، لذا فإن خطأ في اسم المفتاح أو حدث غير معروف يبقى في المخزن حتى يفشل التحديث أو الطلب التالي. يُكتشف هذه الأنواع من الأخطاء قبل أن تصل إلى المُشغل من خلال التحقق من المخطط.