JSON إلى GitHub Actions YAML

حوّل تعريف سير عمل بصيغة JSON إلى ملف .github/workflows نظيف وجاهز للإضافة في commit.

خيارات المخرجات

JSONالمدخلات

فارغ

YAMLالمخرجات

تظهر مخرجات YAML هنا

يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.

تحميل من URL

يجلب متصفحك الملف مباشرةً، لذا يجب أن يسمح الخادم بالطلبات عبر المصادر (cross-origin).

اختصارات لوحة المفاتيح

Ctrl / ⌘ + Enter التحويل الآن
Ctrl / ⌘ + S تنزيل المخرجات
Alt + Shift + C نسخ المخرجات
Alt + Shift + F إصلاح مدخلات JSON وتنسيقها
Alt + Shift + S تبديل الاتجاه
Alt + Shift + T التبديل بين عرض الشيفرة والشجرة والخريطة
Ctrl / ⌘ + Z تراجع، بما في ذلك «تنسيق» و«إصلاح» و«مسح»
Esc الخروج من ملء الشاشة
حجم النص في المحرّر

سير عمل من JSON إلى YAML

تخرج المشغّلات وقيم matrix والتعبيرات والسكربتات متعددة الأسطر كلها كما كنت ستكتبها يدويًا.

workflow.json
{
  "name": "CI",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "strategy": {
        "matrix": {
          "node": [
            "20",
            "22"
          ]
        }
      },
      "steps": [
        {
          "uses": "actions/checkout@v4"
        },
        {
          "uses": "actions/setup-node@v4",
          "with": {
            "node-version": "${{ matrix.node }}"
          }
        },
        {
          "run": "npm ci\nnpm test\n"
        }
      ]
    }
  }
}
.github/workflows/ci.yml
name: CI
'on':
  push:
    branches:
      - main
jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node:
          - '20'
          - '22'
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node }}
      - run: |
          npm ci
          npm test

ما يجب الانتباه إليه في ملفات سير العمل

بدّل بين مخرجات المحوّل والأسطر نفسها مكتوبة دون علامات اقتباس، وقارن كيف يقرؤها كل إصدار من YAML.

المفتاح on

الكلمة on المجردة تعني true في YAML 1.1. واقتباسها بالشكل 'on' يرضي كل محلّل وأداة فحص.

سلاسل الإصدارات

تبقى قيم matrix مثل '20' أو '3.10' مقتبسة، فلا يتحوّل Python 3.10 أبدًا إلى 3.1.

كتل run الحرفية

تصبح السلاسل التي تحتوي على فواصل أسطر كتل run: |، فيبقى كل أمر في سطر مستقل.

مزيد من الأدوات

محوّلات ومدقّقات وأدلة خطوة بخطوة لكل موضع يلتقي فيه JSON وYAML.

الأسئلة الشائعة

كيف أحوّل JSON إلى سير عمل GitHub Actions؟

الصق JSON في المحرّر، وانسخ YAML واحفظه في مستودعك داخل .github/workflows/، مثل .github/workflows/ci.yml. يعمل سير العمل عند الحدث المطابق التالي.

لماذا يُكتب المفتاح on بالشكل 'on'؟

في YAML 1.1، الكلمة on المجردة هي القيمة المنطقية true، لذا تقرأ بعض الأدوات مفتاح المشغّل على أنه true بدلًا من on. والاقتباس يزيل هذا الالتباس. يقبل GitHub الصيغتين، لذا فإن 'on': آمن في كل مكان.

هل تُحفظ تعبيرات ${{ }}؟

نعم. التعبيرات مثل ${{ matrix.node }} و${{ secrets.TOKEN }} سلاسل نصية عادية في JSON وYAML، وتُكتب تمامًا كما تظهر في المدخلات.

كيف تُحوَّل سكربتات run متعددة الأسطر؟

تصبح سلسلة JSON التي تحتوي على فواصل الأسطر \n كتلة حرفية في YAML (run: |)، بأمر واحد في كل سطر، وهي الطريقة المعتادة لكتابة سكربتات سير العمل.

كيف أتحقق من سير العمل قبل دفعه (push)؟

يفحص هذا المحوّل صياغة YAML. أما الفحوصات الخاصة بسير العمل، مثل المفاتيح غير المعروفة أو التعبيرات غير الصالحة أو تسميات runner الخاطئة، فشغّل actionlint محليًا أو في CI.