المفتاح on
الكلمة on المجردة تعني true في YAML 1.1. واقتباسها بالشكل 'on' يرضي كل محلّل وأداة فحص.
حوّل تعريف سير عمل بصيغة JSON إلى ملف .github/workflows نظيف وجاهز للإضافة في commit.
كل سطر من الناتج، بالتنسيق الافتراضي، بجانب مسار القيمة التي يحملها. انقر على صف لنسخ المسار.
يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.
تخرج المشغّلات وقيم matrix والتعبيرات والسكربتات متعددة الأسطر كلها كما كنت ستكتبها يدويًا.
{
"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"
}
]
}
}
} 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 المجردة تعني true في YAML 1.1. واقتباسها بالشكل 'on' يرضي كل محلّل وأداة فحص.
تبقى قيم matrix مثل '20' أو '3.10' مقتبسة، فلا يتحوّل Python 3.10 أبدًا إلى 3.1.
تصبح السلاسل التي تحتوي على فواصل أسطر كتل run: |، فيبقى كل أمر في سطر مستقل.
محوّلات ومدقّقات وأدلة خطوة بخطوة لكل موضع يلتقي فيه JSON وYAML.
الصق JSON في المحرّر، وانسخ YAML واحفظه في مستودعك داخل .github/workflows/، مثل .github/workflows/ci.yml. يعمل سير العمل عند الحدث المطابق التالي.
في YAML 1.1، الكلمة on المجردة هي القيمة المنطقية true، لذا تقرأ بعض الأدوات مفتاح المشغّل على أنه true بدلًا من on. والاقتباس يزيل هذا الالتباس. يقبل GitHub الصيغتين، لذا فإن 'on': آمن في كل مكان.
نعم. التعبيرات مثل ${{ matrix.node }} و${{ secrets.TOKEN }} سلاسل نصية عادية في JSON وYAML، وتُكتب تمامًا كما تظهر في المدخلات.
تصبح سلسلة JSON التي تحتوي على فواصل الأسطر \n كتلة حرفية في YAML (run: |)، بأمر واحد في كل سطر، وهي الطريقة المعتادة لكتابة سكربتات سير العمل.
يفحص هذا المحوّل صياغة YAML. أما الفحوصات الخاصة بسير العمل، مثل المفاتيح غير المعروفة أو التعبيرات غير الصالحة أو تسميات runner الخاطئة، فشغّل actionlint محليًا أو في CI.