מדריך מעשי ל-GitHub Actions — CI/CD אוטומטי לכל פרויקט

מה זה GitHub Actions — ולמה זה חיוני היום?

GitHub Actions הוא מערכת אוטומציה מקוונת המובנית בתוך GitHub, המאפשרת להפעיל פעולות אוטומטיות על בסיס אירועים כמו push, pull_request, schedule או אפילו קריאות HTTP (via repository_dispatch). unlike legacy CI tools, GitHub Actions doesn’t require external servers — כל הפעולה מתבצעת על גבי מכונות ענן של GitHub (macOS, Windows, Ubuntu) או על שרתים פרטיים שלך (self-hosted runners).

בניגוד למערכות כמו Jenkins או GitLab CI, GitHub Actions נבנה סביב קופסאות מודולריות שנקראות Actions — אפשר להשתמש ב-Actions מוכנות (כמו actions/checkout@v4, actions/setup-node@v4) או לכתוב את שלך. זה יוצר גמישות יוצאת דופן: מבדיקה פשוטה של קוד עד לפריסה מלאה ל-Docker, AWS, Firebase או Vercel — הכל בתוך אותו קובץ.

המושגים המרכזיים של GitHub Actions

לפני שנפתח את הקובץ הראשון, חשוב להבין את מבנה הזרימה:

זרימה ראשונה: בדיקת קוד אוטומטית עבור פרויקט JavaScript

ניצור זרימה שתרוץ בכל פעם שמישהו עושה push ל-main — ותבדוק אם הקוד עובר את הבדיקות והקלות (linting) של הפרויקט.

# .github/workflows/test-and-lint.yml
name: Test and Lint
on:
  push:
    branches: [main]

jobs:
  test-and-lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Run lint
        run: npm run lint

      - name: Run tests
        run: npm test

הערה חשובה: GitHub Actions לא יפעל אם לא תוסיף את הקובץ לתיקייה הנכונה: .github/workflows/test-and-lint.yml — ודאג שיכיל את הפקודות המתאימות לקובץ package.json שלך (למשל: "scripts": {"lint": "eslint .", "test": "jest"}).

זרימה מתקדמת: בניית React + פריסה ל-Vercel

הנה זרימה מלאה שמביאה פרויקט React מה-main ל-production — תוך בדיקה, בנייה, ופרסום אוטומטי.

# .github/workflows/deploy-react.yml
name: Deploy React App to Vercel

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

env:
  NODE_VERSION: 20
  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ env.NODE_VERSION }}

      - name: Install and build
        run: |
          npm ci
          npm run build

      - name: Deploy to Vercel
        uses: amondnet/vercel-action@v30
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ env.VERCEL_ORG_ID }}
          vercel-project-id: ${{ env.VERCEL_PROJECT_ID }}
          working-directory: ./dist

GitHub Actions לעומת מערכות CI/CD אחרות

למה לבחור ב-GitHub Actions במקום Jenkins, GitLab CI או CircleCI? הנה השוואה טכנית ומעשית:

7 נקודות קריטיות לביצוע מוצלח של GitHub Actions

הדברים שהכי הרבה מפתחים עושים לא נכון — ומדאיגים את היציבות, הבטיחות והמהירות של הזרימות:

1. אל תשתמש ב-latest בגרסה של Action — תמיד ציין גרסה ספציפית: actions/checkout@v4 ולא @v* או @main. כך אתה מבטיח תאימות, ומנicz את הסיכון לעדכונים שיביאו שגיאות.
2. השתמש ב-npm ci ולא ב-npm install בבנייה — זה מבטיח שחוזר על אותה מצב התלות בדיוק כפי שנקבע ב-package-lock.json, גם אם יש שינויים ב-package.json.
3. הגדר timeout-minutes לכל Job — למשל: timeout-minutes: 15. זה מונע תליות בלתי מוגדרות של זרימות שאינן מסתיימות (למשל בגלל טסט שמתעכב).
4. השתמש ב-if כדי להגביל ריצות — למשל: if: github.event_name == 'push' && startsWith(github.head_ref, 'feature/') כדי לרוץ רק על ענפים מסוימים.
5. אל תכניס סודות לקוד — אפילו ב-tasks. השתמש תמיד ב-${{ secrets.MY_SECRET }}, ולא ב-MY_SECRET: abc123 ב-YAML.
6. השתמש ב-cache כדי להאיץ את ה-Build — לדוגמה: actions/cache@v4 עם מפתח כמו node-modules-${{ hashFiles('**/package-lock.json') }}.
7. הוסף concurrency כדי למנוע ריצות מרובות בו זמנית — במיוחד בעת פריסה: concurrency: ${{ github.workflow }}-${{ github.ref }} מונע התנגשויות.