راهنمای سریع CI/CD با GitHub Actions؛ اولین Pipeline شما در چند دقیقه


چرا CI/CD خودکار اولین قدم حرفه‌ای شدن است؟ #

هر بار که کد را push می‌کنید و «دستی» تست می‌کنید، وقت و اعصاب می‌سوزانید. GitHub Actions سرویس CI/CD داخلی گیت‌هاب است که با یک فایل YAML کنار کدتان، اجرای خودکار تست، بیلد و استقرار را راه می‌اندازد. در این راهنمای سریع، در چند دقیقه اولین Pipeline کارکردی را می‌سازیم.

چهار مفهوم پایه در یک نگاه #

مفهوم یعنی چه؟
Workflow کل فرآیند تعریف‌شده در یک فایل YAML داخل .github/workflows/
Event (on) محرک اجرا؛ مثل push، pull_request یا زمان‌بندی
Job مجموعه‌ای از stepها که روی یک runner یکسان اجرا می‌شوند
Step یک دستور shell یا یک action آماده (مثل checkout)

Runner، ماشین مجازی‌ای است که job را اجرا می‌کند؛ با runs-on: ubuntu-latest از runnerهای آمادهٔ گیت‌هاب استفاده می‌کنید. دقت کنید هر job مجموعه‌ای از stepها را روی یک runner مشترک اجرا می‌کند و هر step یا یک اسکریپت shell است یا یک action قابل‌استفادهٔ مجدد.

اولین Workflow: تست خودکار یک پروژهٔ پایتون #

در ریشهٔ مخزن، فایل .github/workflows/ci.yml بسازید:

yaml
name: CI

on:
  push:
    branches: [main]
  pull_request:

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

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"
          cache: pip

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Run tests
        run: pytest -v

همین فایل کوتاه سه کار انجام می‌دهد: روی هر push به main و هر pull request اجرا می‌شود، محیط پایتون را با کشِ وابستگی‌ها آماده می‌کند و pytest را صدا می‌زند. تب Actions در مخزن شما لاگ کامل هر اجرا را نشان می‌دهد.

کش، ماتریس و Secrets: سه قابلیت که روز اول لازم می‌شوند #

کش وابستگی‌ها: با cache: pip در actions/setup-python، وابستگی‌ها بین اجراها ذخیره می‌شوند و سرعت Pipeline به‌طور چشمگیر بالا می‌رود.

ماتریس نسخه‌ها: اگر می‌خواهید تست روی چند نسخهٔ پایتون اجرا شود، از strategy.matrix استفاده کنید؛ سقف مجاز ماتریس، ۲۵۶ job در هر اجرای workflow است:

yaml
strategy:
  matrix:
    python-version: ["3.11", "3.12", "3.13"]
steps:
  - uses: actions/setup-python@v5
    with:
      python-version: ${{ matrix.python-version }}

Secrets: کلیدهای API و رمزها را هرگز داخل YAML ننویسید؛ از بخش Settings → Secrets and variables → Actions تعریف کنید و با سینتکس ${{ secrets.NAME }} بخوانید.

⚠️ هشدار: مقادیر secrets در لاگ‌ها به‌صورت خودکار ماسک می‌شوند، اما اگر در اسکریپت خودتان با echo یا لاگ‌گیری آزادشان کنید، منتشر می‌شوند. هرگز کلیدها را در فایل workflow کامیت نکنید.

💡 نکته: stepهای action با سینتکس uses فراخوانی می‌شوند و نسخهٔ action را همیشه با تگ مثل @v4 قفل کنید تا رفتار Pipeline ناگهانی عوض نشود.

الگوهای رایج که بعداً لازم می‌شوند #

  • اجرای Lint و فرمت‌چک به‌عنوان job جداگانه موازی با تست
  • بیلد و انتشار Docker image فقط روی تگ‌های v*
  • زمان‌بندی اجرای شبانه با رویداد schedule و سینتکس cron
  • jobهای وابسته با needs: برای ساخت مرحلهٔ deploy پس از تست موفق

جمع‌بندی #

با یک فایل ۲۰ خطی، تست‌های پروژهٔ شما روی هر push و pull request خودکار اجرا می‌شوند؛ کش و ماتریس آن را سریع و پوشش‌دار می‌کنند و secrets رمزها را امن نگه می‌دارند. قدم بعدی برای مدیریت وابستگی‌های سریع‌تر در همین Pipeline، مطالعهٔ معرفی ابزار uv در وبلاگ تک‌کی است. مستندات کامل سینتکس را در Workflow syntax for GitHub Actions و راهنمای شروع را در Understanding GitHub Actions ببینید.

این پست چطور بود؟

پست‌های مرتبط