Jenkins — nó là gì, kiến trúc hệ thống và thiết lập máy chủ CI/CD

Jenkins là gì và tại sao cần trong phát triển di động

Jenkins là một máy chủ CI/CD mã nguồn mở được viết bằng Java để tự động hóa việc xây dựng, kiểm thử và phân phối phần mềm. Trong bối cảnh phát triển di động, Jenkins cho phép các nhóm tự động xây dựng ứng dụng iOS và Android, chạy kiểm thử đơn vị và giao diện người dùng, ký các bản dựng và phân phối chúng đến App Store hoặc Google Play mà không cần thao tác thủ công.

Nhu cầu về Jenkins xuất hiện khi một dự án vượt quá các bản dựng cục bộ và yêu cầu tích hợp mã thường xuyên từ nhiều nhà phát triển. Xây dựng thủ công mỗi lần commit tốn thời gian và dễ xảy ra lỗi — Jenkins giải quyết vấn đề này bằng cách khởi chạy các pipeline tự động với mỗi thay đổi trong kho lưu trữ.

Theo báo cáo JetBrains Developer Ecosystem 2025, 54% nhóm di động sử dụng Jenkins làm nền tảng CI/CD chính. Hệ thống hỗ trợ mọi ngôn ngữ và nền tảng nhờ kiến trúc plugin — cho Android có Gradle và SDK Manager, cho iOS có Xcode Integration và Keychain Manager.

Sử dụng Jenkins trong các dự án nơi bạn cần kiểm soát hoàn toàn cơ sở hạ tầng xây dựng, tùy chỉnh từng bước quy trình CI/CD và tích hợp với các hệ thống bảo mật doanh nghiệp.

Kiến trúc Jenkins: Master, Agents và hoạt động Pipeline

Kiến trúc Jenkins được xây dựng trên mô hình Master-Agent. Máy chủ Master quản lý cấu hình, lịch trình tác vụ và giao diện web, trong khi các tác nhân thực hiện các bản dựng thực tế trên các máy chuyên dụng hoặc tạm thời. Kiến trúc này cho phép xây dựng song song ứng dụng iOS trên tác nhân macOS và ứng dụng Android trên tác nhân Linux từ một máy chủ Master duy nhất.

Master và Agent trong Jenkins

Nút Master Jenkins lưu trữ tất cả cài đặt, plugin và lịch sử xây dựng trong thư mục chính $JENKINS_HOME. Các tác nhân kết nối với Master qua SSH, JNLP hoặc WebSocket và nhận tác vụ từ hàng đợi. Đối với phát triển di động, nên phân bổ các tác nhân macOS riêng cho bản dựng iOS và tác nhân Linux cho bản dựng Android với SDK và công cụ đã cài đặt.

Mỗi tác nhân có thể là một máy chủ cố định hoặc một container Docker động. Theo tài liệu CloudBees, phân phối các bản dựng trên 5 tác nhân giảm tổng thời gian pipeline CI/CD xuống 70% với 10 tác vụ song song.

Pipeline dưới dạng mã

Jenkins Pipeline là định nghĩa toàn bộ quy trình CI/CD dưới dạng mã được lưu trữ trong kho lưu trữ cùng với dự án. Pipeline được mô tả trong Jenkinsfile và hỗ trợ hai cú pháp: Declarative (có cấu trúc, với các khối được xác định trước) và Scripted (linh hoạt, dựa trên Groovy với kiểm soát hoàn toàn luồng thực thi).

Cú pháp khai báo được khuyến nghị cho hầu hết các dự án di động vì nó đảm bảo khả năng đọc và khả năng dự đoán. Scripted Pipeline phù hợp cho các kịch bản phức tạp với các giai đoạn song song động, xử lý lỗi tùy chỉnh và logic có điều kiện dựa trên biến môi trường.

Jenkins Pipeline: Cú pháp khai báo và kịch bản

Jenkins Pipeline hỗ trợ hai cú pháp xác định cách mô tả các bước quy trình CI/CD. Cú pháp khai báo sử dụng cấu trúc khối với các từ khóa pipeline, stages, stage và steps, giúp trực quan cho người dùng mới. Cú pháp kịch bản dựa trên Groovy và cung cấp kiểm soát hoàn toàn quá trình thực thi thông qua các câu lệnh điều kiện và vòng lặp.

Declarative Pipeline tự động tạo một Sandbox — môi trường an toàn để thực thi các tập lệnh Groovy. Điều này hạn chế quyền truy cập vào các phương thức nguy hiểm của Java và Groovy, điều quan trọng trong môi trường doanh nghiệp nơi bảo mật pipeline được quản trị viên kiểm soát.

Cấu trúc Declarative Pipeline

Declarative Pipeline được xây dựng trên bốn khối chính: pipeline (khối gốc), agent (chỉ định tác nhân), stages (chuỗi các giai đoạn) và post (các hành động sau khi hoàn thành). Mỗi giai đoạn chứa các bước với lệnh xây dựng, và khối post xác định các hành động khi thành công, thất bại hoặc trạng thái không ổn định.

Khối post đặc biệt hữu ích cho các dự án di động — bạn có thể cấu hình thông báo Slack khi xây dựng thất bại hoặc lưu trữ các tệp tin IPA và APK sau khi hoàn thành thành công. Jenkins đảm bảo thực hiện các hành động post ngay cả khi pipeline bị ngắt thủ công.

// Declarative Pipeline cho ứng dụng 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 cung cấp khối node thay vì agent và cho phép sử dụng cấu trúc Groovy để rẽ nhánh động. Cú pháp này thuận tiện cho các pipeline nơi tập hợp các giai đoạn phụ thuộc vào tham số xây dựng hoặc kết quả của các bước trước đó.

// Scripted Pipeline với các giai đoạn song song
node('macos') {
    stage('Parallel Builds') {
        parallel(
            ios: { buildIOS() },
            android: { buildAndroid() }
        )
    }
}
def buildIOS() {
    sh 'fastlane ios build'
}

Jenkinsfile: Thiết lập CI/CD cho dự án iOS

Đối với các dự án iOS, Jenkinsfile yêu cầu một tác nhân macOS có Xcode, CocoaPods hoặc Swift Package Manager và Fastlane được cài đặt. Một pipeline điển hình bao gồm các giai đoạn: cài đặt phụ thuộc, xây dựng, chạy kiểm thử, ký mã và phân phối đến TestFlight hoặc App Store.

Một tính năng chính của bản dựng iOS trong Jenkins là quản lý chứng chỉ và hồ sơ cung cấp. Nên sử dụng Fastlane Match để tự động lấy chứng chỉ từ kho lưu trữ hoặc plugin Jenkins Credentials Binding để lưu trữ khóa an toàn.

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'
            }
        }
    }
}

Đối với Kiểm thử đơn vị iOS, hãy sử dụng xcodebuild test với chỉ định trình mô phỏng. Jenkins hỗ trợ xuất bản báo cáo XCTest thông qua plugin JUnit — chuyển đổi .xcresult sang định dạng XML để nhúng kết quả kiểm thử vào bảng điều khiển xây dựng.

Jenkinsfile: Thiết lập CI/CD cho dự án Android

Các bản dựng Android trong Jenkins được thực hiện trên các tác nhân Linux có Java JDK, Android SDK, Gradle và trình giả lập được cài đặt. Pipeline bao gồm các giai đoạn: kiểm tra lint, kiểm thử đơn vị, xây dựng APK hoặc AAB, kiểm thử có cài đặt trên trình giả lập và xuất bản lên Google Play Console.

Để quản lý Android SDK, hãy sử dụng sdkmanager trong Jenkinsfile để cài đặt các nền tảng và công cụ xây dựng cần thiết. Nên lưu vùng đệm các thư mục .gradle và .android giữa các lần xây dựng để tăng tốc các lần chạy sau.

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'
                }
            }
        }
    }
}

Kiểm thử có cài đặt trên Android yêu cầu một trình giả lập đang chạy. Jenkins hỗ trợ plugin Android Emulator, tự động tạo và khởi động trình giả lập trước khi kiểm thử. Đối với thiết bị vật lý, hãy sử dụng Firebase Test Lab — tích hợp có sẵn thông qua plugin Google Cloud SDK.

Plugin Jenkins tự động hóa xây dựng

Hệ thống plugin Jenkins là một lợi thế chính của nền tảng. Hơn 1800 plugin bao phủ tất cả các giai đoạn CI/CD: từ tích hợp với hệ thống kiểm soát phiên bản đến triển khai lên các dịch vụ đám mây. Mỗi plugin thêm các bước mới vào pipeline và mở rộng giao diện web với các trang cấu hình bổ sung.

Đối với phát triển di động, một bộ plugin quản lý thông tin đăng nhập là cần thiết: Credentials Binding để lưu trữ token App Store Connect và tài khoản dịch vụ Google Play. Plugin Xcode Integration thêm các bước xây dựng ứng dụng iOS từ giao diện Jenkins.

Plugin Docker Pipeline cho phép chạy từng giai đoạn xây dựng trong một container riêng biệt, đảm bảo khả năng tái tạo môi trường và loại bỏ vấn đề khác biệt môi trường. Đối với các bản dựng Android, hãy sử dụng hình ảnh có Android SDK được cài đặt sẵn từ cộng đồng Gradle.

Jenkins vs Travis CI: So sánh cho nhóm di động

Lựa chọn giữa Jenkins và Travis CI phụ thuộc vào quy mô nhóm, ngân sách và yêu cầu cơ sở hạ tầng. Jenkins là giải pháp tự lưu trữ với kiểm soát hoàn toàn, yêu cầu một máy chủ chuyên dụng và người quản trị. Travis CI là dịch vụ đám mây trả tiền theo sử dụng, không yêu cầu quản lý máy chủ.

Đối với startup và nhóm nhỏ, Travis CI được ưa tiên hơn — chi phí cơ sở hạ tầng bằng không, tích hợp đơn giản với GitHub và các bản dựng có sẵn cho iOS và Android. Đối với các dự án doanh nghiệp, Jenkins mang lại lợi ích: trình chạy macOS riêng, tuân thủ chính sách bảo mật doanh nghiệp và cấu hình pipeline chi tiết qua Jenkinsfile.

Theo Khảo sát Stack Overflow 2025, Jenkins được 42% nhà phát triển chuyên nghiệp sử dụng so với 12% của Travis CI. Tuy nhiên, Travis CI vẫn phổ biến trong cộng đồng mã nguồn mở nhờ gói miễn phí cho kho lưu trữ công khai và rào cản gia nhập tối thiểu.

Lợi ích của Jenkins trong quy trình CI/CD

Jenkins cung cấp một tập hợp các lợi ích khiến nó trở thành tiêu chuẩn CI/CD cho phát triển di động. Giấy phép MIT miễn phí cho phép sử dụng máy chủ mà không hạn chế trong các dự án thương mại và mã nguồn mở đảm bảo tính độc lập với nhà cung cấp và khả năng kiểm toán bảo mật.

Kiến trúc Master-Agent cho phép mở rộng theo chiều ngang — việc thêm một tác nhân mới làm tăng thông lượng pipeline một cách tuyến tính. Jenkins hỗ trợ các tác nhân động trong Kubernetes thông qua Jenkins X, cho phép tự động tạo và hủy các trình xây dựng khi cần.

Hệ sinh thái plugin bao phủ tất cả các công cụ hiện đại: Docker, Kubernetes, Fastlane, SonarQube, GitLab, Bitbucket. Nếu không có plugin có sẵn, bạn có thể tự viết phần mở rộng bằng Java hoặc sử dụng Pipeline Shared Libraries để tái sử dụng mã giữa các dự án.