Build Pipeline در توسعه موبایل — ماهیت، مراحل و راه‌اندازی

Build Pipeline چیست

Build Pipeline (خط لوله ساخت) — دنباله‌ای رسمی از مراحل است که به طور خودکار با هر تغییر کد اجرا می‌شوند. هر مرحله جنبه خاصی از کیفیت را بررسی می‌کند: قابلیت کامپایل، صحت تست‌ها، عدم وجود آسیب‌پذیری‌ها، مطابقت با سبک کد. اگر هر مرحله با خطا به پایان برسد، خط لوله متوقف می‌شود.

مفهوم خط لوله از خط تولید کارخانه گرفته شده است — مانند کارخانه‌ای که هر ایستگاه به محصول ارزش اضافه می‌کند. در توسعه نرم‌افزار، هر مرحله اطمینان می‌افزاید که کد برای انتشار آماده است. خطوط لوله مدرن به عنوان کد تعریف می‌شوند (Pipeline as Code) و همراه با پروژه در مخزن Git ذخیره می‌شوند.

بر اساس Continuous Delivery Foundation, 2025، یک خط لوله ساخت بالغ زمان را از commit تا انتشار از هفته‌ها به دقیقه کاهش می‌دهد. این امر از طریق اتوماسیون کامل و اجرای موازی مراحل مستقل به دست می‌آید.

Pipeline as Code

به جای پیکربندی از طریق رابط وب، خط لوله مدرن در فایل‌های YAML یا Groovy توصیف می‌شود. Jenkinsfile، `.gitlab-ci.yml`، `.github/workflows/build.yml` — نمونه‌هایی از Pipeline as Code هستند. مزایا: نسخه‌بندی، بررسی کد، قابلیت تکرار.

خط لوله اعلانی در مقابل اسکریپتی

در Jenkins دو نحو وجود دارد. اعلانی (Declarative) — ساده‌تر، با ساختار واضح stages/steps. اسکریپتی — انعطاف‌پذیرتر، مبتنی بر Groovy. برای اکثر پروژه‌ها رویکرد اعلانی به عنوان خوانا و قابل پیش‌بینی‌تر توصیه می‌شود.

مراحل خط لوله معمولی

خط لوله ساخت معمولی برای یک اپلیکیشن موبایل شامل چندین مرحله کلیدی است. هر مرحله عملکرد خود را انجام می‌دهد و مشکلات بالقوه را در مراحل اولیه فیلتر می‌کند.

دریافت کد و نصب وابستگی‌ها

خط لوله با کلون کردن مخزن آغاز می‌شود. سپس وابستگی‌ها نصب می‌شوند: بسته‌های Gradle/Maven، CocoaPods، SPM (Swift Package Manager)، بسته‌های npm. استفاده از حافظه پنهان (کش) در این مرحله ساخت‌های بعدی را 50-70% تسریع می‌کند.

لینتینگ و تحلیل ایستا

قبل از کامپایل، ابزارهای کنترل کیفیت کد راه‌اندازی می‌شوند: Detekt یا ktlint برای Kotlin، SwiftLint برای Swift، ESLint برای JavaScript. آنها مطابقت با سبک کد را بررسی کرده و اشکالات بالقوه را در سطح تحلیل کد پیدا می‌کنند.

کامپایل و تست‌های واحد

کد به شکل باینری کامپایل می‌شود و همزمان تست‌های واحد اجرا می‌شوند. برای Android این `./gradlew testDebugUnitTest`، برای iOS — `xcodebuild test -scheme App -destination 'platform=iOS Simulator'`. شکست تست‌ها بلافاصله خط لوله را متوقف می‌کند.

name: Mobile Build Pipeline
on: [push, pull_request]

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

  unit-tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: ./gradlew testDebugUnitTest
      - run: ./gradlew jacocoTestReport

  build-release:
    needs: [lint, unit-tests]
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: ./gradlew assembleRelease
      - uses: actions/upload-artifact@v4
        with:
          name: release-apk
          path: app/build/outputs/apk/release/app-release.apk

تست‌های یکپارچه‌سازی و UI

پس از کامپایل موفق، تست‌هایی که نیاز به راه‌اندازی اپلیکیشن دارند اجرا می‌شوند: Espresso برای Android، XCTest/XCUITest برای iOS، Detox برای React Native. در این مرحله آرتیفکت روی شبیه‌ساز یا دستگاه واقعی از طریق سرویس‌های farm (Firebase Test Lab، BrowserStack، Sauce Labs) مستقر می‌شود.

پیکربندی خط لوله

پیکربندی صحیح خط لوله کارایی کل فرآیند CI/CD را تعیین می‌کند. پیکربندی شامل انتخاب محرک‌ها، تعیین مراحل موازی و متوالی، پارامترسازی و یکپارچه‌سازی با سرویس‌های خارجی است.

محرک‌های خط لوله

محرک‌های اصلی: push به مخزن، pull request (به ویژه برای بررسی کد با بررسی‌های خودکار)، ایجاد تگ Git (برای ساخت انتشار)، زمان‌بندی (nightly build). محرک Pull request — عملی‌ترین برای کار تیمی است، زیرا مشکلات را قبل از ادغام کد شناسایی می‌کند.

مراحل موازی و متوالی

مراحل مستقل (لینتینگ، تست بر روی نسخه‌های مختلف سیستم عامل) باید برای تسریع به صورت موازی اجرا شوند. مراحل وابسته — به صورت متوالی. سیستم‌های CI مدرن به طور خودکار وظایف موازی را مدیریت کرده و آنها را بین عامل‌های موجود توزیع می‌کنند.

• Fail-fast — شکست فوری را هنگام خطا در هر شاخه موازی پیکربندی کنید
• Matrix build — اجرای یک ساخت بر روی چندین پیکربندی (سطح API، نسخه Xcode)
• Conditional stages — برخی مراحل فقط برای شاخه‌های خاص اجرا می‌شوند (مثلاً استقرار فقط از main)

بهینه‌سازی Build Pipeline

خط لوله طولانی چرخه توسعه را کند کرده و انگیزه تیم را کاهش می‌دهد. بهینه‌سازی زمان ساخت — یکی از وظایف اصلی مهندس DevOps هنگام کار با خط لوله ساخت است.

کش کردن وابستگی‌ها

Gradle Build Cache نتایج کامپایل‌های قبلی را ذخیره می‌کند. اگر کد منبع ماژول تغییر نکرده باشد، دوباره کامپایل نمی‌شود. کامپایل افزایشی در Swift و Kotlin نیز به همین صورت عمل می‌کند. اندازه کش می‌تواند به گیگابایت برسد، اما صرفه‌جویی در زمان بین 30% تا 70% است.

اجرای موازی تست‌ها

تست‌های واحد را می‌توان به طور همزمان روی چندین عامل اجرا کرد و کلاس‌های تست را توزیع کرد. Sharding — تکنیک تقسیم تست‌ها به گروه‌ها (shards). GitHub Actions از `strategy.matrix` پشتیبانی می‌کند، Jenkins — Parallel Test Executor، Gradle — `--parallel --max-workers`.

به حداقل رساندن لایه‌های خط لوله

هر مرحله اضافی زمان می‌افزاید. خط لوله را به طور منظم تحلیل کنید: کدام مراحل را می‌توان ترکیب کرد؟ برای مثال، لینتینگ را می‌توان به جای قبل از کامپایل، به صورت موازی با آن اجرا کرد. تست‌های یکپارچه‌سازی — فقط برای pull request، نه برای هر commit.

pipeline {
    agent any
    options {
        timestamps()
        timeout(time: 30, unit: 'MINUTES')
    }
    stages {
        stage('Parallel Checks') {
            parallel {
                stage('Lint') {
                    steps { sh './gradlew detekt' }
                }
                stage('Unit Tests') {
                    steps { sh './gradlew test' }
                }
            }
        }
        stage('Build') {
            steps { sh './gradlew assembleRelease' }
        }
    }
}

امنیت Build Pipeline

خط لوله ساخت یک عنصر حیاتی از زنجیره تأمین نرم‌افزار است و امنیت آن را نمی‌توان نادیده گرفت. به خطر افتادن خط لوله می‌تواند منجر به تزریق کد مخرب به آرتیفکت انتشار شود که همه کاربران اپلیکیشن را تحت تأثیر قرار می‌دهد.

حملات زنجیره تأمین به خطوط لوله

حملات شناخته شده: SolarWinds (2020)، Codecov (2021)، 3CX (2023) — همه آنها از آسیب‌پذیری‌های موجود در خطوط لوله CI/CD بهره‌برداری کردند. بردار مشترک — مهاجم به اعتبارنامه‌های سرور ساخت دسترسی پیدا کرده و کد را در مرحله ساخت تغییر می‌دهد. نتیجه — انتشار مخرب امضا شده با گواهی معتبر.

حفاظت از اعتبارنامه‌ها

هرگز ذخیره نکنید کلیدهای امضا، توکن‌های API و رمزهای عبور را در مخزن یا متغیرهای محیطی سیستم CI به صورت آشکار. از اسرار سیستم CI (GitHub Secrets، GitLab CI Variables)، HashiCorp Vault، AWS Secrets Manager استفاده کنید. دسترسی به اسرار را به حداقل برسانید — هر خط لوله باید فقط کلیدهایی را دریافت کند که برای مراحل خاص آن لازم است.

تأیید آرتیفکت‌های خط لوله

هر آرتیفکت خروجی از خط لوله باید به صورت رمزنگاری امضا شود و حاوی گواهی (attestation) — گواهی منشأ (provenance) باشد. ابزارها: SLSA framework، in-toto attestation، cosign برای امضای کانتینرها. تأیید امضا باید قبل از استقرار در هر محیطی انجام شود.

name: Secure Build Pipeline
on: [push]

jobs:
  security-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Scan dependencies
        run: ./gradlew dependencyCheckAnalyze
      - name: SAST scan
        run: ./gradlew detekt

  sign-attest:
    needs: security-scan
    runs-on: ubuntu-latest
    steps:
      - run: ./gradlew assembleRelease
      - name: Sign APK
        run: jarsigner -keystore ${{ secrets.KEYSTORE }} \
          app-release.apk ${{ secrets.KEY_ALIAS }}
      - name: Generate provenance
        uses: actions/attest-build-provenance@v1

مانیتورینگ و اشکال‌زدایی خط لوله

خط لوله ساخت — سیستم پیچیده‌ای است که نیاز به مانیتورینگ مداوم دارد. بدون متریک نمی‌توان تعیین کرد که آیا خط لوله کند شده و کدام مرحله به نقطه تنگنا تبدیل شده است.

متریک‌های خط لوله

ردیابی کنید: زمان عبور (total pipeline duration)، زمان هر مرحله، دفعات شکست (build failure rate)، زمان انتظار در صف (queue time). برای تیم بزرگ (>20 توسعه‌دهنده) توصیه می‌شود داشبوردی در Grafana یا Datadog با آمار تجمیعی هفتگی/ماهانه راه‌اندازی کنید.

هشدار هنگام خرابی

هر خرابی خط لوله نیاز به واکنش دارد. اعلان‌ها را در پیام‌رسان‌ها (Slack، Telegram، Discord) با لینک به لاگ خطا و ذکر نویسنده commit پیکربندی کنید. برای خرابی‌های بحرانی — PagerDuty یا Opsgenie با escalation.

اشکال‌زدایی محلی خط لوله

ابزارهایی مانند Act (برای GitHub Actions) یا Jenkins Pipeline Unit Test امکان اجرای محلی خط لوله را بدون commit فراهم می‌کنند. این کار توسعه و اشکال‌زدایی خطوط لوله را به ویژه هنگام افزودن مراحل جدید یا تغییر پیکربندی تسریع می‌کند.