راهنمای سریع 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 بسازید:
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 است:
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 ببینید.