Git & GitHub Professional Workflow · درس

مقدمة إلى GitHub Actions

افهم المفاهيم الأساسية في GitHub Actions، بما في ذلك مسارات العمل والأحداث والمهام والخطوات

مقدمة إلى GitHub Actions درس مجاني في Git & GitHub Professional Workflow على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Git & GitHub Professional Workflow، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.

مقدمة إلى GitHub Actions

مرحبًا بكم في GitHub Actions! تتيح لكم هذه الميزة القوية في GitHub أتمتة المهام مباشرةً داخل مستودعكم.

فكّروا فيها كمساعد روبوتي شخصي للتعليمات البرمجية. إذ يمكنها إنشاء مشاريعكم، وتشغيل الاختبارات، بل وحتى نشر موقعكم تلقائيًا كلما أجرَيتم تغييرات.

في هذا الدرس، سنستكشف المفاهيم الأساسية: سير العمل، والأحداث، والمهام، والخطوات.

سير العمل: مخطط الأتمتة الخاص بكم

يُعد سير العمل جوهر GitHub Actions. وسير العمل هو إجراء مؤتمت يشغّل مهمة واحدة أو أكثر.

يُحدَّد سير العمل في ملفات YAML.
توجد هذه الملفات في الدليل .github/workflows ضمن مستودعكم.
يمثّل كل ملف لسير العمل عملية أتمتة منفصلة.

عند وقوع أحداث معيّنة، مثل دفع التعليمات البرمجية، يبدأ سير العمل بتنفيذ مهامه!

بنية ملف سير العمل

تُكتب مسارات عمل GitHub Actions بلغة YAML، وهي معيار تسلسل بيانات سهل القراءة للبشر. إليكم بنية أساسية:

name: My First Workflow

on: [push]

jobs:
  my_first_job:
    runs-on: ubuntu-latest
    steps:
      - name: Greet Me
        run: echo "Hello CoddyKit!"

الأحداث: مشغّلات الأتمتة

الأحداث هي أنشطة محددة تؤدي إلى تشغيل سير العمل. وهي تخبر GitHub Actions بموعد بدء عملية الأتمتة.

تشمل الأحداث الشائعة ما يلي:

push: عند دفع التعليمات البرمجية إلى المستودع.
pull_request: عند فتح طلب سحب أو تحديثه أو إغلاقه.
schedule: للتشغيل في أوقات محددة، مثل مهمة cron.

يمكنكم تحديد حدث واحد أو أكثر في ملف سير العمل باستخدام الكلمة المفتاحية on:.

name: On Push Example

on: [push, pull_request] # This workflow runs on push or pull request events

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3
      - name: Run a simple command
        run: echo "Code was pushed or PR updated!"

المهام: مهام منظّمة

تتكوّن المهمة من مجموعة خطوات تُنفَّذ على المشغّل نفسه. ويتكوّن سير العمل من مهمة واحدة أو أكثر، ويمكن تشغيلها بالتوازي أو بالتتابع.

تُنفَّذ كل مهمة في مثيل جديد من البيئة الافتراضية المحددة بواسطة runs-on.
تشمل قيم runs-on الشائعة ubuntu-latest وwindows-latest وmacos-latest.

تحدّد المهام ما يجب إنجازه، مثل إنشاء تطبيق أو تشغيل الاختبارات.

الخطوات: تعليمات منفردة

داخل المهمة، تكون الخطوات مهام منفردة يجري تنفيذها. ويمكن أن تكون الخطوة:

برنامجًا نصيًا لسطر الأوامر، باستخدام run.
إجراءً، باستخدام uses، وهو جزء من التعليمات البرمجية قابل لإعادة الاستخدام.

تُنفَّذ الخطوات بالترتيب الذي حُدّدت به. وإذا فشلت إحدى الخطوات، تفشل المهمة افتراضيًا ويتم تخطي الخطوات اللاحقة.

name: Steps Demo

on: [push]

jobs:
  my_job:
    runs-on: ubuntu-latest
    steps:
      - name: Step 1: Say Hello
        run: echo "Hello from Step 1!"
      - name: Step 2: List files
        run: ls -la
      - name: Step 3: Echo another message
        run: echo "Step 3 completed."

الإجراءات: كتل تعليمات برمجية قابلة لإعادة الاستخدام

تُعد الإجراءات أصغر وحدة في الأتمتة. وهي أجزاء من التعليمات البرمجية قابلة لإعادة الاستخدام، وتنفّذ مهمة محددة.

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

استخدموا الكلمة المفتاحية uses: للإشارة إلى إجراء.
يمكن أن تكون الإجراءات مقدَّمة من GitHub، مثل actions/checkout، أو من صورة Docker، أو من ملف JavaScript.

يوفّر ذلك الوقت ويعزّز الاتساق!

name: Using Actions

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository code
        uses: actions/checkout@v4 # This action checks out your repo
      - name: Setup Node.js environment
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install dependencies
        run: npm install

إنشاء سير عمل متكامل

لنجمع كل ما تعلمناه في مثال واحد لسير عمل قابل للتنفيذ. سيتحقق سير العمل هذا ببساطة من التعليمات البرمجية ويطبع تحية.

يُحفَظ ملف YAML هذا باسم .github/workflows/greeting.yml في مستودعكم.

name: Simple Greeting Workflow

on: [push] # Triggers on any push to the repository

jobs:
  greet_job:
    runs-on: ubuntu-latest # Runs on a fresh Ubuntu virtual machine
    steps:
      - name: Checkout the repository
        uses: actions/checkout@v4 # Action to get your code
      - name: Say hello
        run: echo "Hello, GitHub Actions User!" # A simple command-line step
      - name: Show current directory
        run: pwd # Another command to show where we are

كيفية تنفيذ سير العمل

عند وقوع حدث، مثل push، ينفّذ GitHub Actions ما يلي:

يقرأ ملف سير العمل المناسب بصيغة YAML من .github/workflows/.
يهيّئ آلة افتراضية، تُسمى مشغّلًا، لكل مهمة.
ينفّذ كل خطوة ضمن المهمة بالتتابع.
يبلغ عن حالة كل خطوة، سواء بالنجاح أو الفشل، وحالة المهمة ككل.

يمكنكم مراقبة هذه العملية في علامة التبويب "Actions" ضمن مستودعكم على GitHub.

اختبار سريع: مكوّنات سير العمل

أيّ من العناصر التالية يُعد مكوّنًا أساسيًا موجودًا في ملف سير عمل GitHub Actions؟

مراجعة: مقدمة إلى GitHub Actions

أحسنتم! لقد تعلمتم المفاهيم الأساسية في GitHub Actions:

سير العمل: مخططات الأتمتة الخاصة بكم في ملفات YAML.
الأحداث: المشغّلات التي تبدأ سير العمل.
المهام: مجموعات من الخطوات التي تُنفَّذ على مشغّل.
الخطوات: أوامر منفردة أو إجراءات قابلة لإعادة الاستخدام.
الإجراءات: وحدات عمل قابلة لإعادة الاستخدام للمهام الشائعة.

سننتقل بعد ذلك إلى إنشاء مسارات عمل CI/CD أكثر عملية!

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

هل درس «مقدمة إلى GitHub Actions» مجاني؟

نعم — نص درس «مقدمة إلى GitHub Actions» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Git & GitHub Professional Workflow، انتقل إلى CoddyKit PRO. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.

ماذا ستتعلم في «مقدمة إلى GitHub Actions»؟

افهم المفاهيم الأساسية في GitHub Actions، بما في ذلك مسارات العمل والأحداث والمهام والخطوات تتمرن على Git & GitHub Professional Workflow مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Git & GitHub Professional Workflow؟

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

كم من الوقت يستغرق درس «مقدمة إلى GitHub Actions»؟

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

هل يمكنني كتابة وتشغيل أكواد في درس Git & GitHub Professional Workflow هذا؟

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

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

← العودة إلى Git & GitHub Professional Workflow