Jenkins — چیست، معماری سیستم و پیکربندی سرور CI/CD

Jenkins چیست و چرا در توسعه موبایل به آن نیاز داریم

Jenkins یک سرور CI/CD با کد منبع باز است که به زبان Java برای خودکارسازی ساخت، آزمایش و تحویل نرم‌افزار نوشته شده است. در زمینه توسعه موبایل، Jenkins به تیم‌ها امکان می‌دهد به طور خودکار برنامه‌های iOS و Android را بسازند، تست‌های واحد و UI را اجرا کنند، بیلدها را امضا کنند و بدون عملیات دستی به App Store یا Google Play تحویل دهند.

نیاز به Jenkins زمانی ایجاد می‌شود که پروژه از بیلدهای محلی فراتر رفته و نیاز به یکپارچه‌سازی منظم کد از چندین توسعه‌دهنده دارد. بیلد دستی هر commit زمان‌بر و مستعد خطا است — Jenkins این مشکل را با راه‌اندازی pipelineهای خودکار در هر تغییر مخزن حل می‌کند.

طبق گزارش JetBrains Developer Ecosystem 2025، 54% از تیم‌های موبایل از Jenkins به عنوان پلتفرم اصلی CI/CD استفاده می‌کنند. این سیستم به لطف معماری پلاگین‌ها از هر زبان و پلتفرمی پشتیبانی می‌کند — برای Android، Gradle و SDK Manager و برای iOS، Xcode Integration و Keychain Manager در دسترس هستند.

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

معماری Jenkins: Master، Agentها و عملکرد Pipeline

معماری Jenkins بر اساس مدل Master-Agent ساخته شده است. سرور Master پیکربندی، برنامه‌ریزی وظایف و رابط وب را مدیریت می‌کند و Agentها بیلدهای واقعی را روی ماشین‌های اختصاصی یا موقت اجرا می‌کنند. این معماری امکان ساخت همزمان برنامه iOS روی agent مک‌اواس و برنامه Android روی agent لینوکس را از یک سرور Master فراهم می‌کند.

Master و Agent در Jenkins

گره Master تمام تنظیمات، پلاگین‌ها و تاریخچه بیلدها را در دایرکتوری خانگی $JENKINS_HOME ذخیره می‌کند. Agentها از طریق SSH، JNLP یا WebSocket به Master متصل می‌شوند و وظایف را از صف دریافت می‌کنند. برای توسعه موبایل، توصیه می‌شود agentهای جداگانه macOS برای بیلدهای iOS و agentهای لینوکس برای بیلدهای Android با SDK و ابزارهای نصب‌شده اختصاص داده شوند.

هر agent می‌تواند یک سرور ثابت یا یک کانتینر Docker پویا باشد. طبق مستندات CloudBees، توزیع بیلدها روی 5 agent زمان کلی pipeline CI/CD را با 10 وظیفه موازی تا 70% کاهش می‌دهد.

Pipeline به عنوان کد

Jenkins Pipeline تعریف کل فرآیند CI/CD به صورت کد است که همراه با پروژه در مخزن ذخیره می‌شود. Pipeline در Jenkinsfile توصیف می‌شود و از دو نحو پشتیبانی می‌کند: Declarative (ساختاریافته با بلوک‌های از پیش تعریف‌شده) و Scripted (انعطاف‌پذیر بر پایه Groovy با کنترل کامل جریان اجرا).

نحو Declarative برای اکثر پروژه‌های موبایل توصیه می‌شود زیرا خوانایی و قابلیت پیش‌بینی را تضمین می‌کند. Scripted Pipeline برای سناریوهای پیچیده با مراحل موازی پویا، مدیریت خطای سفارشی و منطق شرطی مبتنی بر متغیرهای محیطی مناسب است.

Jenkins Pipeline: نحو Declarative و Scripted

Jenkins Pipeline از دو نحو پشتیبانی می‌کند که روش توصیف مراحل فرآیند CI/CD را تعیین می‌کنند. نحو Declarative از ساختار بلوکی با کلمات کلیدی pipeline، stages، stage و steps استفاده می‌کند که آن را برای کاربران جدید بصری می‌سازد. نحو Scripted مبتنی بر Groovy است و از طریق دستورات شرطی و حلقه‌ها کنترل کامل بر اجرا را فراهم می‌کند.

Pipeline Declarative به طور خودکار Sandbox — یک محیط امن برای اجرای اسکریپت‌های Groovy — ایجاد می‌کند. این کار دسترسی به روش‌های خطرناک Java و Groovy را محدود می‌کند که برای محیط‌های سازمانی که امنیت pipelineها توسط مدیر کنترل می‌شود حیاتی است.

ساختار Pipeline Declarative

Pipeline Declarative بر چهار بلوک کلیدی ساخته شده است: pipeline (بلوک ریشه)، agent(تعیین عامل)، stages (توالی مراحل) و post (اقدامات پس از اتمام). هر stage شامل steps با دستورات بیلد است و بلوک post اقدامات را در صورت موفقیت، شکست یا وضعیت ناپایدار بیلد تعیین می‌کند.

بلوک post به ویژه برای پروژه‌های موبایل مفید است — می‌توان در آن ارسال اعلان به Slack هنگام شکست بیلد یا بایگانی مصنوعات IPA و APK پس از اتمام موفق را پیکربندی کرد. Jenkins اقدامات post را به طور تضمینی اجرا می‌کند، حتی اگر pipeline به صورت دستی متوقف شده باشد.

// Pipeline اعلامی برای برنامه iOS
pipeline {
    agent { label 'macos' }
    stages {
        stage('Build') {
            steps {
                sh 'xcodebuild -workspace App.xcworkspace -scheme App clean build'
            }
        }
        stage('Test') {
            steps {
                sh 'xcodebuild -workspace App.xcworkspace -scheme App test'
            }
        }
    }
}

Scripted Pipeline به جای agent از بلوک node استفاده می‌کند و امکان استفاده از ساختارهای Groovy برای انشعاب پویا را فراهم می‌کند. این نحو برای pipelineهایی مناسب است که مجموعه مراحل آنها به پارامترهای بیلد یا نتایج مراحل قبلی بستگی دارد.

// Pipeline اسکریپت‌شده با مراحل موازی
node('macos') {
    stage('Parallel Builds') {
        parallel(
            ios: { buildIOS() },
            android: { buildAndroid() }
        )
    }
}
def buildIOS() {
    sh 'fastlane ios build'
}

Jenkinsfile: پیکربندی CI/CD برای پروژه‌های iOS

برای پروژه‌های iOS، Jenkinsfile به یک agent مک‌اواس با Xcode، CocoaPods یا Swift Package Manager و Fastlane نصب‌شده نیاز دارد. pipeline معمولی شامل مراحل: نصب وابستگی‌ها، ساخت، اجرای تست‌ها، امضای کد و تحویل به TestFlight یا App Store است.

ویژگی کلیدی بیلدهای iOS در Jenkins مدیریت گواهی‌ها و پروفایل‌های provisioning است. توصیه می‌شود از Fastlane Match برای دریافت خودکار گواهی‌ها از مخزن یا پلاگین Jenkins Credentials Binding برای ذخیره امن کلیدها استفاده کنید.

pipeline {
    agent { label 'macos' }
    environment {
        MATCH_PASSWORD = credentials('match-password')
    }
    stages {
        stage('Install Dependencies') {
            steps {
                sh 'pod install --repo-update'
            }
        }
        stage('Build and Test') {
            steps {
                sh 'fastlane scan'
                sh 'fastlane gym'
            }
        }
        stage('Deploy to TestFlight') {
            when { branch 'main' }
            steps {
                sh 'fastlane upload_testflight'
            }
        }
    }
}

برای تست‌های واحد iOS از xcodebuild test با تعیین شبیه‌ساز استفاده کنید. Jenkins از انتشار گزارش‌های XCTest از طریق پلاگین JUnit پشتیبانی می‌کند — .xcresult را به فرمت XML تبدیل کنید تا نتایج تست‌ها در داشبورد بیلد نمایش داده شوند.

Jenkinsfile: پیکربندی CI/CD برای پروژه‌های Android

بیلدهای Android در Jenkins روی agentهای لینوکس با Java JDK، Android SDK، Gradle و شبیه‌سازهای نصب‌شده اجرا می‌شوند. pipeline شامل مراحل: بررسی linter، تست‌های واحد، ساخت APK یا AAB، تست‌های ابزاری روی شبیه‌ساز و انتشار در Google Play Console است.

برای مدیریت Android SDK از sdkmanager در Jenkinsfile برای نصب پلتفرم‌ها و build-tools لازم استفاده کنید. توصیه می‌شود دایرکتوری‌های .gradle و .android را بین بیلدها کش کنید تا اجراهای بعدی سریع‌تر شوند.

pipeline {
    agent { label 'linux' }
    stages {
        stage('Lint Check') {
            steps {
                sh './gradlew lint'
            }
        }
        stage('Unit Tests') {
            steps {
                sh './gradlew testDebugUnitTest'
            }
        }
        stage('Build APK') {
            steps {
                sh './gradlew assembleDebug'
            }
            post {
                success {
                    archiveArtifacts artifacts: '**/build/outputs/apk/**/*.apk'
                }
            }
        }
    }
}

تست‌های ابزاری روی Android به شبیه‌سازی در حال اجرا نیاز دارند. Jenkins از پلاگین Android Emulator پشتیبانی می‌کند که به طور خودکار قبل از تست‌ها شبیه‌ساز را ایجاد و راه‌اندازی می‌کند. برای دستگاه‌های فیزیکی از Firebase Test Lab استفاده کنید — یکپارچه‌سازی از طریق پلاگین Google Cloud SDK در دسترس است.

پلاگین‌های Jenkins برای خودکارسازی بیلدها

سیستم پلاگین‌های Jenkins مزیت کلیدی پلتفرم است. بیش از 1800 پلاگین تمام مراحل CI/CD را پوشش می‌دهند: از یکپارچه‌سازی با سیستم‌های کنترل نسخه تا استقرار در سرویس‌های ابری. هر پلاگین مراحل جدیدی به pipeline اضافه می‌کند و رابط وب را با صفحات پیکربندی اضافی گسترش می‌دهد.

برای توسعه موبایل، مجموعه پلاگین‌های مدیریت اعتبارنامه الزامی است: Credentials Binding برای ذخیره توکن‌های App Store Connect و حساب‌های سرویس Google Play. پلاگین Xcode Integration مراحل بیلد برنامه‌های iOS را از رابط کاربری Jenkins اضافه می‌کند.

پلاگین Docker Pipeline امکان اجرای هر مرحله بیلد را در یک کانتینر جداگانه فراهم می‌کند که تکرارپذیری محیط را تضمین کرده و مشکل تفاوت‌های محیطی را برطرف می‌کند. برای بیلدهای Android از تصاویر با Android SDK از پیش نصب‌شده توسط انجمن Gradle استفاده کنید.

Jenkins در مقابل Travis CI: مقایسه برای تیم‌های موبایل

انتخاب بین Jenkins و Travis CI به اندازه تیم، بودجه و الزامات زیرساختی بستگی دارد. Jenkins یک راه‌حل self-hosted با کنترل کامل است که به سرور اختصاصی و مدیر نیاز دارد. Travis CI یک سرویس ابری با پرداخت بر اساس مصرف است که نیازی به مدیریت سرور ندارد.

برای استارتاپ‌ها و تیم‌های کوچک، Travis CI ارجح است — هزینه زیرساخت صفر، یکپارچه‌سازی ساده با GitHub و بیلدهای آماده برای iOS و Android. برای پروژه‌های سازمانی، Jenkins مزایایی دارد: runnerهای اختصاصی روی macOS، انطباق با سیاست‌های امنیتی سازمانی و پیکربندی دقیق pipeline از طریق Jenkinsfile.

طبق داده‌های Stack Overflow Survey 2025، Jenkins توسط 42% از توسعه‌دهندگان حرفه‌ای در مقابل 12% برای Travis CI استفاده می‌شود. با این حال، Travis CI به لطف برنامه رایگان برای مخازن عمومی و حداقل آستانه ورود در جامعه متن‌باز محبوب باقی مانده است.

مزایای Jenkins در فرآیندهای CI/CD

Jenkins مجموعه‌ای از مزایا را ارائه می‌دهد که آن را به استاندارد CI/CD برای توسعه موبایل تبدیل می‌کند. مجوز رایگان MIT امکان استفاده از سرور را بدون محدودیت در پروژه‌های تجاری فراهم می‌کند و کد منبع باز استقلال از فروشنده و امکان ممیزی امنیتی را تضمین می‌کند.

معماری Master-Agent مقیاس‌پذیری افقی را فراهم می‌کند — افزودن یک agent جدید ظرفیت pipelineها را به صورت خطی افزایش می‌دهد. Jenkins از agentهای پویا در Kubernetes از طریق Jenkins X پشتیبانی می‌کند که امکان ایجاد و حذف خودکار بیلدرها را در صورت نیاز فراهم می‌کند.

اکوسیستم پلاگین‌ها تمام ابزارهای مدرن را پوشش می‌دهد: Docker، Kubernetes، Fastlane، SonarQube، GitLab، Bitbucket. در صورت نبود پلاگین آماده، می‌توانید افزونه خود را به زبان Java بنویسید یا از Pipeline Shared Libraries برای استفاده مجدد از کد بین پروژه‌ها استفاده کنید.