Technical Tutorials

غيّرت GitHub Actions بشكل جذري طريقة تعامل فرق التطوير الحديثة مع التكامل المستمر والنشر المستمر (CI/CD). من خلال الاستفادة من الأتمتة الأصلية مباشرةً داخل مستودعك، يمكنك تبسيط عمليات البناء والاختبار والإصدار مع الحفاظ على تكوين البنية التحتية في الكود. للمطورين من المستوى المتوسط إلى المتقدم، يعد فهم تفاصيل تكوين سير العمل أمرًا أساسيًا لبناء خطوط أنابيب قابلة للتوسع وآمنة وفعالة.

فهم البنية الأساسية

في جوهرها، يُعرَّف سير عمل GitHub Actions في ملف YAML يقع داخل مجلد .github/workflows في مستودعك. تُسمّى هذه الملفات *.yml أو *.yaml. تتبع البنية نمطًا هرميًا: يحتوي سير العمل على عدة مهام (jobs)، وتحتوي كل مهمة على عدة خطوات (steps)، وتنفذ كل خطوة إجراءً أو أمرًا محددًا.

عند إنشاء ملف سير عمل جديد، تبدأ بتحديد اسم سير العمل والأحداث التي تطلق التنفيذ. تشمل المحفزات الشائعة الدفع إلى فرع، أو إنشاء طلب سحب (pull request)، أو الإرسال اليدوي.

name: CI Pipeline

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Run tests
      run: npm test

تحديد المهام والمشغلات (Runners)

يحدد المفتاح runs-on مكان تنفيذ المهمة. يمكنك الاختيار من بين المشغلات القياسية التي تستضيفها GitHub (مثل ubuntu-latest، أو macos-latest، أو windows-latest)، أو تحديد تسمية لمشغل مخصص ذاتيًا (self-hosted runner) لبنيتك التحتية الخاصة. يمكن تنفيذ المهام بشكل تسلسلي أو متوازٍ. افتراضيًا، تُنفذ المهام بشكل متوازٍ. إذا كنت بحاجة إلى ترتيب معين، فاستخدم المفتاح needs لتحديد التبعيات.

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm run lint

  test:
    needs: lint # This job runs only if 'lint' succeeds
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

إدارة السياقات والتعبيرات

توفر GitHub Actions عدة سياقات (contexts) تتيح لك الوصول إلى معلومات حول سير العمل، والمهام، والخطوات، والمستودع. تشمل السياقات الأكثر استخدامًا github، وjob، وsteps، وsecrets، وenv. يمكنك استخدام التعبيرات داخل الأقواس المعقوفة ${{ }} لتعيين القيم ديناميكيًا بناءً على هذه السياقات.

على سبيل المثال، قد ترغب في نشر تطبيق فقط عند إجراء تغييرات على فرع main. يمكنك تنفيذ الخطوات بشكل مشروط باستخدام خاصية if:

- name: Deploy to Production
  if: github.ref == 'refs/heads/main'
  run: ./deploy.sh

معالجة الأسرار ومتغيرات البيئة

الأمان أمر بالغ الأهمية في خطوط CI/CD. يجب ألا تقوم أبدًا بتضمين بيانات الاعتماد (credentials) بشكل ثابت في ملفات سير العمل الخاصة بك. بدلاً من ذلك، استخدم سياق secrets لحقن البيانات الحساسة بشكل آمن. عرّف الأسرار في إعدادات مستودعك تحت الإعدادات > الأسرار والمتغيرات > الإجراءات (Actions). يمكنك بعد ذلك الإشارة إليها في سير عملك على النحو التالي:

- name: Publish to NPM
  env:
    NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
  run: npm publish

بالإضافة إلى ذلك، يمكنك تعريف متغيرات بيئة تكون مرئية لجميع الخطوات في مهمة أو سير عمل باستخدام المفتاح env على المستوى الأعلى.

أفضل الممارسات لسير عمل قابلة للتوسع

مع نمو مشروعك، تزداد تعقيدات سير العمل. للحفاظ على قابلية الصيانة، ضع في اعتبارك أفضل الممارسات التالية:

استخدم الإجراءات المركبة (Composite Actions): قم بتجريد الخطوات المتكررة إلى إجراءات مركبة مخزنة في .github/actions لتقليل التكرار.
استفد من التخزين المؤقت (Caching): استخدم actions/cache لتخزين الاعتماديات (مثل node_modules) مؤقتًا لتسريع عمليات التشغيل اللاحقة.
عمليات البناء المصفوفية (Matrix Builds): استخدم ميزة strategy.matrix لاختبار كودك مقابل عدة إصدارات من أنظمة التشغيل أو إصدارات الاعتماديات في تعريف مهمة واحد.

strategy:
  matrix:
    node-version: [14.x, 16.x, 18.x]
    os: [ubuntu-latest, windows-latest]
  runs-on: ${{ matrix.os }}
  steps:
    - uses: actions/setup-node@v4
      with:
        node-version: ${{ matrix.node-version }}

الخاتمة

تكوين GitHub Actions يتجاوز مجرد كتابة YAML؛ إنه يتعلق بتصميم خط أنابيب تسليم متين وفعّال. من خلال إتقان المحفزات، وتبعيات المهام، واستخدام السياقات، وممارسات الأمان، يمكنك أتمتة دورة حياة التطوير الخاصة بك بفعالية. ابدأ بسير عمل بسيطة وقم تدريجيًا بدمج عمليات البناء المصفوفية، والتخزين المؤقت، والإجراءات المركبة مع تطور احتياجات مشروعك. تكمن قوة GitHub Actions في قابليتها للتوسع، مما يجعلها أداة لا غنى عنها لاستراتيجيات DevOps الحديثة.