Jenkins — 정의, 시스템 아키텍처 및 CI/CD 서버 설정

Jenkins란 무엇이며 모바일 개발에서 왜 필요한가

Jenkins는 소프트웨어의 빌드, 테스트 및 데리버리를 자동화하는 Java로 작성된 오픈 소스 CI/CD 서버입니다. 모바일 개발의 문맥에서 Jenkins는 팀이 iOS 및 Android 애플리케이션을 자동으로 빌드하고, 유닛 및 UI 테스트를 수행하고, 빌드에 서명하며, 수동 작업 없이 App Store나 Google Play에 데리버리할 수 있도록 합니다.

Jenkins이 필요해지는 것은 프로젝트가 로컬 빌드를 넘어서면서 여러 개발자의 정규적인 코드 통합이 필요할 때입니다. 각 커미트를 수동으로 빌드하는 것은 시간이 한착 걸리고 오류가 발생하기 쉽습니다. Jenkins는 리포지토리의 모든 변경 사항에서 자동 파이프라인을 실행하여 이 문제를 해결합니다.

JetBrains Developer Ecosystem 2025 보고서에 따르면, 54%의 모바일 팀이 Jenkins를 주요 CI/CD 플랫폼으로 사용합니다. 이 시스템은 플러그인 아키텍처 덕분에 모든 언어와 플랫폼을 지원합니다. Android에는 Gradle과 SDK Manager가, iOS에는 Xcode Integration과 Keychain Manager가 제공됩니다.

빌드 인프라에 대한 완전한 컨트롤, CI/CD 프로세스 각 단계의 커스터마이징, 그리고 기업 보안 시스템과의 통합이 필요한 프로젝트에서 Jenkins를 사용하세요.

Jenkins 아키텍처: Master, Agent 및 Pipeline 작동

Jenkins 아키텍처는 Master-Agent 모델에 기반합니다. Master 서버는 구성, 작업 스케줄링 및 웹 인터페이스를 관리하는 반면, Agent는 전용 또는 임시 머신에서 실제 빌드를 수행합니다. 이 아키텍처를 통해 단일 Master 서버에서 macOS Agent에서 iOS를, Linux Agent에서 Android을 병렬로 빌드할 수 있습니다.

Jenkins에서 Master 및 Agent

Jenkins Master 노드는 모든 설정, 플러그인 및 빌드 역사를 홈 디렉토리 $JENKINS_HOME에 저장합니다. Agent는 SSH, JNLP 또는 WebSocket을 통해 Master에 연결되고 큐에서 작업을 받습니다. 모바일 개발의 경우 iOS 빌드를 위한 별도의 macOS Agent와 SDK와 도구가 설치된 Android 빌드용 Linux Agent를 할당할 것을 권장합니다.

각 Agent는 영구 서버 또는 동적 Docker 컨테너가 될 수 있습니다. CloudBees 문서에 따르면 5개의 Agent에 빌드를 분산하면 10개의 병렬 작업으로 총 CI/CD 파이프라인 시간이 70% 감소합니다.

코드로서의 Pipeline

Jenkins Pipeline은 전체 CI/CD 프로세스를 프로젝트와 함께 리포지토리에 저장되는 코드로 정의한 것입니다. Pipeline은 Jenkinsfile에 서술되고 두 가지 구문을 지원합니다: Declarative(구조화된, 미리 정의된 블록) 및 Scripted(유연한, 실행 흐름을 완전히 제어할 수 있는 Groovy 기반).

대부분의 모바일 프로젝트에서는 가독성과 예측 가능성을 보장하물로 Declarative 구문이 권장됩니다. Scripted Pipeline은 동적 병렬 단계, 사용자 지정 에러 처리 및 환경 변수에 기반한 조건부 논리가 필요한 복잡한 시나리오에 적합합니다.

Jenkins Pipeline: 선언적 및 스크립트 구문

Jenkins Pipeline은 CI/CD 프로세스의 단계를 설명하는 방법을 정의하는 두 가지 구문을 지원합니다. Declarative 구문은 pipeline, stages, stage 및 steps 키워드를 사용한 블록 구조를 사용하여 새 사용자에게 직관적입니다. Scripted 구문은 Groovy를 기반으로 조건문과 반복문을 통해 실행을 완전히 제어할 수 있습니다.

Declarative Pipeline은 자동으로 샌드박스를 생성합니다. 이것은 Groovy 스크립트를 실행하기 위한 안전한 환경입니다. 이를 통해 Java와 Groovy의 위험한 메소드에 대한 액세스가 제한되며, 파이프라인 보안을 관리자가 제어하는 기업 환경에서 중요합니다.

Declarative Pipeline 구조

Declarative Pipeline은 네 가지 주요 블록으로 구성됩니다: pipeline(루트 블록), agent(Agent 지정), stages(단계 순서), post(완료 후 작업). 각 stage에는 빌드 명령어가 있는 steps가 있고, post 블록은 성공, 실패 또는 불안정 빌드 상태별 작업을 정의합니다.

Post 블록은 모바일 프로젝트에 특히 유용합니다. 빌드 실패 시 Slack 알림을 설정하거나 성공적인 완료 후 IPA 및 APK 아티팩트를 보관할 수 있습니다. 파이프라인이 수동으로 중단되더라도 Jenkins는 post 작업을 보장합니다.

// iOS 애플리케이션용 Declarative Pipeline
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 구조를 사용할 수 있습니다. 이 구문은 단계 집합이 빌드 매개변수나 이전 단계의 결과에 의존하는 파이프라인에 적합합니다.

// 병렬 단계가 있는 Scripted Pipeline
node('macos') {
    stage('Parallel Builds') {
        parallel(
            ios: { buildIOS() },
            android: { buildAndroid() }
        )
    }
}
def buildIOS() {
    sh 'fastlane ios build'
}

Jenkinsfile: iOS 프로젝트의 CI/CD 설정

iOS 프로젝트의 경우 Jenkinsfile에는 Xcode, CocoaPods 또는 Swift Package Manager 및 Fastlane이 설치된 macOS Agent가 필요합니다. 일반적인 파이프라인에는 의존성 설치, 빌드, 테스트 실행, 코드 서명 및 TestFlight나 App Store에 데리버리가 포함됩니다.

Jenkins에서 iOS 빌드의 주요 특징은 인증서 및 프로비전닝 프로파일 관리입니다. 리포지토리에서 인증서를 자동으로 가져오려면 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는 JUnit 플러그인을 통해 XCTest 보고서 게재를 지원합니다. .xcresult를 XML 형식으로 변환하여 빌드 대시보드에 테스트 결과를 임베드하세요.

Jenkinsfile: Android 프로젝트의 CI/CD 설정

Jenkins에서 Android 빌드는 Java JDK, Android SDK, Gradle 및 에미레이터가 설치된 Linux Agent에서 실행됩니다. 파이프라인에는 린터 확인, 유닛 테스트, APK 또는 AAB 빌드, 에미레이터에서의 계찰 테스트 및 Google Play Console에 게재가 포함됩니다.

Android SDK를 관리하려면 Jenkinsfile에서 sdkmanager를 사용하여 필요한 플랫폼과 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의 모든 단계를 다룩니다. 각 플러그인은 파이프라인에 새로운 단계를 추가하고 웹 인터페이스를 추가 구성 페이지로 확장합니다.

모바일 개발에서는 크레덴셜 관리 플러그인 세트가 필수입니다. Credentials Binding은 App Store Connect 토큰과 Google Play 서비스 계정을 저장합니다. Xcode Integration 플러그인은 Jenkins UI에서 iOS 애플리케이션 빌드 단계를 추가합니다.

Docker Pipeline 플러그인은 각 빌드 단계를 별도 컨테너에서 실행하여 환경 재현성을 보장하고 환경 차이 문제를 해소합니다. Android 빌드에는 Gradle 커뮤니티의 사전 설치된 Android SDK 이미지를 사용하세요.

Jenkins vs Travis CI: 모바일 팀을 위한 비교

Jenkins와 Travis CI 사이의 선택은 팀 규모, 예산 및 인프라 요건에 따라 달라집니다. Jenkins는 완전한 컨트롤을 제공하는 세포 호스팅 방식으로 전용 서버와 관리자가 필요합니다. Travis CI는 사용량에 따라 과금되는 클라우드 서비스로 서버 관리가 필요 없습니다.

스타트업과 작은 팀에게는 Travis CI가 더 좋습니다. 인프라 비용이 들지 않고, GitHub와의 간단한 통합, iOS와 Android용 준비된 빌드를 제공합니다. 기업 프로젝트의 경우 Jenkins는 자체 macOS 러너, 기업 보안 정책 준수 및 Jenkinsfile을 통한 세밀한 파이프라인 구성을 제공합니다.

Stack Overflow Survey 2025에 따르면 Jenkins를 전문 개발자의 42%가 사용하는 반면, Travis CI는 12%가 사용합니다. 하지만 Travis CI는 공개 리포지토리용 무료 요금제와 최소한의 입문 장벽 때문에 오픈 소스 커뮤니티에서 여전히 인기가 있습니다.

CI/CD 프로세스에서 Jenkins의 장점

Jenkins는 모바일 개발의 CI/CD 표준으로 만드는 일련의 장점을 제공합니다. 무료 MIT 라이선스를 통해 상업 프로젝트에서 제한 없이 서버를 사용할 수 있으며, 오픈 소스 코드는 벤더 독립성과 보안 감사 가능성을 보장합니다.

Master-Agent 아키텍처는 수평 확장을 가능하게 합니다. 새 Agent를 추가하면 파이프라인 스루푸트가 선형적으로 증가합니다. Jenkins는 Jenkins X를 통해 Kubernetes에서 동적 Agent를 지원하여 필요에 따라 빌더를 자동으로 생성하고 삭제할 수 있습니다.

플러그인 생태계는 Docker, Kubernetes, Fastlane, SonarQube, GitLab, Bitbucket 등 모든 현대 도구를 다룩니다. 준비된 플러그인이 없는 경우 Java로 직접 확장을 작성하거나 Pipeline Shared Libraries를 사용하여 프로젝트 간에 코드를 재사용할 수 있습니다.