DevOps Bootcamp · درس

الإجراءات المركبة والنشر في Marketplace

أنشئ إجراءات مركبة تجمع عدة خطوات، وأصدرها بطريقة صحيحة، وانشر إجراءك المخصص في GitHub Marketplace لإعادة استخدامه

الإجراءات المركبة والنشر في Marketplace درس مجاني في DevOps Bootcamp على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في DevOps Bootcamp، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة DevOps Bootcamp 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) وفتح باقي دورة DevOps Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة DevOps Bootcamp 4 دروس في المجموع.

ماذا ستتعلم في «الإجراءات المركبة والنشر في Marketplace»؟

أنشئ إجراءات مركبة تجمع عدة خطوات، وأصدرها بطريقة صحيحة، وانشر إجراءك المخصص في GitHub Marketplace لإعادة استخدامه تتمرن على DevOps Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ DevOps Bootcamp؟

لا تُشترط خبرة سابقة. DevOps Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «الإجراءات المركبة والنشر في Marketplace»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس DevOps Bootcamp هذا؟

نعم. كل درس في DevOps Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

تطوير GitHub Actions مخصصة
المنفّذات المستضافة ذاتيًا للبيئات المحلية
التكامل مع أنظمة المؤسسات
الإجراءات المركبة والنشر في Marketplace

← العودة إلى DevOps Bootcamp