الإجراءات المركبة والنشر في Marketplace
أنشئ إجراءات مركبة تجمع عدة خطوات، وأصدرها بطريقة صحيحة، وانشر إجراءك المخصص في GitHub Marketplace لإعادة استخدامه
الإجراءات المركبة والنشر في Marketplace درس مجاني في CI/CD with GitHub Actions & DevOps Pipelines على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في CI/CD with GitHub Actions & DevOps Pipelines، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة CI/CD with GitHub Actions & DevOps Pipelines 4 دروس في المجموع.
ثلاثة أنواع من الإجراءات المخصصة
يدعم GitHub ثلاث طرق لإنشاء إجراء مخصص:
- إجراءات JavaScript — تشغّل تعليمات Node البرمجية
- إجراءات Docker — تعمل داخل حاوية
- إجراءات مركبة — تجمع عدة خطوات من مسار العمل
يركز هذا الدرس على الإجراءات المركبة ونشرها.
ما الإجراء المركب
يُجمّع الإجراء المركب عدة خطوات تنفيذ واستدعاءات لإجراءات أخرى في وحدة واحدة قابلة لإعادة الاستخدام، من دون كتابة JavaScript أو إنشاء صورة Docker.
وهو مثالي لتجميع سلسلة متكررة من أوامر shell.
ملف action.yml
يُعرَّف كل إجراء بواسطة ملف action.yml في جذره. وبالنسبة إلى الإجراء المركب، اضبطوا runs.using على composite.
name: Setup Project
description: Install deps and build
runs:
using: composite
steps:
- run: npm ci
shell: bash
- run: npm run build
shell: bashيجب تحديد shell
هناك قاعدة دقيقة: يجب أن تعلن كل خطوة run في الإجراءات المركبة عن shell. ويُعدّ نسيان ذلك الخطأ الأكثر شيوعًا عند إنشاء الإجراءات المركبة.
- run: echo 'hello'
shell: bashتعريف المدخلات
اجعلوا الإجراء قابلًا للتهيئة باستخدام inputs. ويمرّر المستدعون القيم عبر with، ويمكنكم الإشارة إليها بصيغة inputs.<name>.
inputs:
node-version:
description: Node version
required: false
default: '20'
runs:
using: composite
steps:
- run: echo Using ${{ inputs.node-version }}
shell: bashتعريف المخرجات
يمكن للإجراء المركب إرجاع المخرجات. تكتب إحدى الخطوات إلى GITHUB_OUTPUT، ثم يربطها الإجراء بمخرج مُسمّى.
outputs:
build-id:
value: ${{ steps.gen.outputs.id }}
runs:
using: composite
steps:
- id: gen
run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
shell: bashاستخدام إجراء محلي
يمكنكم الإشارة إلى إجراء مخزّن في المستودع نفسه باستخدام مساره، وهذا مفيد أثناء التطوير قبل النشر.
steps:
- uses: actions/checkout@v4
- uses: ./.github/actions/setup-project
with:
node-version: '20'إدارة الإصدارات باستخدام الوسوم
يُشار إلى الإجراءات المنشورة باستخدام مرجع git. من أفضل الممارسات وسم الإصدارات بالصيغة v1.0.0، مع الحفاظ أيضًا على وسم متحرك باسم v1.
يحصل المستدعون الذين يستخدمون @v1 تلقائيًا على التحديثات غير المتعارضة.
git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --forceالاستعداد لـ Marketplace
لنشر الإجراء في GitHub Marketplace، يجب أن يكون موجودًا في مستودع عام يتضمن ملف action.yml يحتوي على name وdescription، ويفضّل أن يتضمن branding (الأيقونة واللون).
branding:
icon: package
color: blueنشر الإصدار
في صفحة Releases بالمستودع، أنشئوا إصدارًا مسودة للوسم الخاص بكم. يعرض GitHub مربع اختيار Publish this Action to the Marketplace.
وافقوا على الاتفاقية، واختاروا الفئات، ثم انشروا الإصدار. سيصبح الإجراء قابلًا للبحث من الجميع.
توثيق الاستخدام
يأتي الإجراء الجيد مرفقًا بملف README واضح يوضّح مثالًا على الاستخدام، والمدخلات، والمخرجات.
تعتمد المؤسسات التي تقيّم إجراءكم اعتمادًا كبيرًا على هذه الوثائق، لذا احرصوا على دقتها واكتمالها.
تحقق سريع
اختبروا فهمكم للإجراءات المركبة.
مراجعة
تعلّمتم إنشاء إجراءات مركبة ونشرها.
- تجمع الإجراءات المركبة الخطوات باستخدام
runs.using: composite - تحتاج كل خطوة تشغيل إلى
shellصريح - اعرضوا المدخلات والمخرجات لإعادة الاستخدام
- ضعوا وسومًا بإصدارات دلالية ووسمًا رئيسيًا متحركًا، ثم انشروا الإجراء في Marketplace
الإجراءات القابلة لإعادة الاستخدام هي الطريقة التي توسّع بها الفرق منطق CI/CD المشترك.
الأسئلة الشائعة
هل درس «الإجراءات المركبة والنشر في Marketplace» مجاني؟
نعم — نص درس «الإجراءات المركبة والنشر في Marketplace» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة CI/CD with GitHub Actions & DevOps Pipelines، انتقل إلى CoddyKit PRO. تتضمن دورة CI/CD with GitHub Actions & DevOps Pipelines 4 دروس في المجموع.
ماذا ستتعلم في «الإجراءات المركبة والنشر في Marketplace»؟
أنشئ إجراءات مركبة تجمع عدة خطوات، وأصدرها بطريقة صحيحة، وانشر إجراءك المخصص في GitHub Marketplace لإعادة استخدامه تتمرن على CI/CD with GitHub Actions & DevOps Pipelines مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ CI/CD with GitHub Actions & DevOps Pipelines؟
لا تُشترط خبرة سابقة. CI/CD with GitHub Actions & DevOps Pipelines على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «الإجراءات المركبة والنشر في Marketplace»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس CI/CD with GitHub Actions & DevOps Pipelines هذا؟
نعم. كل درس في CI/CD with GitHub Actions & DevOps Pipelines يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- تطوير GitHub Actions مخصصة
- المنفّذات المستضافة ذاتيًا للبيئات المحلية
- التكامل مع أنظمة المؤسسات
- الإجراءات المركبة والنشر في Marketplace